21.3. Installation de clusters gérés avec RHACM et les ressources SiteConfig

1. Un fichier ISO d'image de découverte est généré et démarré sur l'hôte cible.
2. Lorsque le fichier ISO démarre avec succès sur l'hôte cible, il communique au RHACM les informations relatives au matériel de l'hôte.
3. Une fois tous les hôtes découverts, OpenShift Container Platform est installé.
4. Lorsque l'installation d'OpenShift Container Platform est terminée, le hub installe le service klusterlet sur le cluster cible.
5. Les services complémentaires demandés sont installés sur le cluster cible.

Procédure

1. Créer un fichier secret YAML contenant les informations d'identification pour le contrôleur de gestion de carte de base (BMC) de l'hôte et un secret d'extraction requis pour l'installation d'OpenShift et de tous les opérateurs de cluster supplémentaires :

   1. Enregistrer le YAML suivant dans le fichier example-sno-secret.yaml:

      apiVersion: v1
      kind: Secret
      metadata:
        name: example-sno-bmc-secret
        namespace: example-sno 

      1

      
      data: 

      2

      
        password: <base64_password>
        username: <base64_username>
      type: Opaque
      ---
      apiVersion: v1
      kind: Secret
      metadata:
        name: pull-secret
        namespace: example-sno  

      3

      
      data:
        .dockerconfigjson: <pull_secret> 

      4

      
      type: kubernetes.io/dockerconfigjson

      Copy to Clipboard Toggle word wrap

      1

      Doit correspondre à l'espace de noms configuré dans la CR SiteConfig correspondante

      2

      Valeurs encodées en base64 pour password et username

      3

      Doit correspondre à l'espace de noms configuré dans la CR SiteConfig correspondante

      4

      Secret d'extraction codé en base64

2. Ajoutez le chemin relatif vers example-sno-secret.yaml au fichier kustomization.yaml que vous utilisez pour installer le cluster.

Procédure

1. Créez le CR InfraEnv et modifiez la spécification spec.kernelArguments pour configurer les arguments du noyau.

   1. Enregistrez le YAML suivant dans un fichier InfraEnv-example.yaml:

      Note

      Dans cet exemple, la CR InfraEnv utilise une syntaxe de modèle telle que {{ .Cluster.ClusterName }} qui est remplie en fonction des valeurs de la CR SiteConfig. La CR SiteConfig remplit automatiquement les valeurs de ces modèles pendant le déploiement. Ne modifiez pas les modèles manuellement.

      apiVersion: agent-install.openshift.io/v1beta1
      kind: InfraEnv
      metadata:
        annotations:
          argocd.argoproj.io/sync-wave: "1"
        name: "{{ .Cluster.ClusterName }}"
        namespace: "{{ .Cluster.ClusterName }}"
      spec:
        clusterRef:
          name: "{{ .Cluster.ClusterName }}"
          namespace: "{{ .Cluster.ClusterName }}"
        kernelArguments:
          - operation: append 

      1

      
            value: audit=0 

      2

      
          - operation: append
            value: trace=1
        sshAuthorizedKey: "{{ .Site.SshPublicKey }}"
        proxy: "{{ .Cluster.ProxySettings }}"
        pullSecretRef:
          name: "{{ .Site.PullSecretRef.Name }}"
        ignitionConfigOverride: "{{ .Cluster.IgnitionConfigOverride }}"
        nmStateConfigLabelSelector:
          matchLabels:
            nmstate-label: "{{ .Cluster.ClusterName }}"
        additionalNTPSources: "{{ .Cluster.AdditionalNTPSources }}"

      Copy to Clipboard Toggle word wrap

      1

      Spécifier l'opération d'ajout d'un argument du noyau.

      2

      Spécifiez l'argument du noyau que vous souhaitez configurer. Cet exemple configure l'argument de noyau audit et l'argument de noyau trace.

2. Livrez le CR InfraEnv-example.yaml au même endroit dans votre dépôt Git que le CR SiteConfig et repoussez vos modifications. L'exemple suivant montre un exemple de structure de dépôt Git :

   ~/example-ztp/install
             └── site-install
                  ├── siteconfig-example.yaml
                  ├── InfraEnv-example.yaml
                  ...

   Copy to Clipboard Toggle word wrap

3. Modifiez la spécification spec.clusters.crTemplates dans le CR SiteConfig pour faire référence au CR InfraEnv-example.yaml dans votre référentiel Git :

   clusters:
     crTemplates:
       InfraEnv: "InfraEnv-example.yaml"

   Copy to Clipboard Toggle word wrap

   Lorsque vous êtes prêt à déployer votre cluster en validant et en poussant le CR SiteConfig, le pipeline de construction utilise le CR personnalisé InfraEnv-example dans votre dépôt Git pour configurer l'environnement d'infrastructure, y compris les arguments personnalisés du noyau.

1. Ouvrez une session SSH avec l'hôte cible :

   $ ssh -i /path/to/privatekey core@<nom_de_l'hôte>

   Copy to Clipboard Toggle word wrap

2. Affichez les arguments du noyau du système à l'aide de la commande suivante :

   $ cat /proc/cmdline

   Copy to Clipboard Toggle word wrap

1. L'opérateur de service assisté installe OpenShift Container Platform sur le cluster. Vous pouvez surveiller la progression de l'installation du cluster à partir du tableau de bord RHACM ou de la ligne de commande en exécutant les commandes suivantes :

   1. Exporter le nom du cluster :

      $ export CLUSTER=<clusterName>

      Copy to Clipboard Toggle word wrap

   2. Interrogez le CR AgentClusterInstall pour le cluster géré :

      $ oc get agentclusterinstall -n $CLUSTER $CLUSTER -o jsonpath='{.status.conditions[?(@.type=="Completed")]}' | jq

      Copy to Clipboard Toggle word wrap

   3. Obtenir les événements d'installation pour le cluster :

      $ curl -sk $(oc get agentclusterinstall -n $CLUSTER $CLUSTER -o jsonpath='{.status.debugInfo.eventsURL}')  | jq '.[-2,-1]'

      Copy to Clipboard Toggle word wrap

Procédure

1. Vérifiez que les CR d'installation ont été créés en utilisant la commande suivante :

   oc get AgentClusterInstall -n <cluster_name>

   Copy to Clipboard Toggle word wrap

   Si aucun objet n'est renvoyé, utilisez les étapes suivantes pour résoudre le problème du flux du pipeline ArgoCD depuis les fichiers SiteConfig jusqu'aux CR d'installation.

2. Vérifiez que la CR ManagedCluster a été générée à l'aide de la CR SiteConfig sur le cluster hub :

   $ oc get managedcluster

   Copy to Clipboard Toggle word wrap

3. Si le site ManagedCluster est manquant, vérifiez si l'application clusters n'a pas échoué à synchroniser les fichiers du référentiel Git vers le hub cluster :

   $ oc describe -n openshift-gitops application clusters

   Copy to Clipboard Toggle word wrap

   1. Vérifiez le champ Status.Conditions pour afficher les journaux d'erreurs du cluster géré. Par exemple, la définition d'une valeur non valide pour extraManifestPath: dans le CR SiteConfig entraîne l'erreur suivante :

      Status:
        Conditions:
          Last Transition Time:  2021-11-26T17:21:39Z
          Message:               rpc error: code = Unknown desc = `kustomize build /tmp/https___git.com/ran-sites/siteconfigs/ --enable-alpha-plugins` failed exit status 1: 2021/11/26 17:21:40 Error could not create extra-manifest ranSite1.extra-manifest3 stat extra-manifest3: no such file or directory 2021/11/26 17:21:40 Error: could not build the entire SiteConfig defined by /tmp/kust-plugin-config-913473579: stat extra-manifest3: no such file or directory Error: failure in plugin configured via /tmp/kust-plugin-config-913473579; exit status 1: exit status 1
          Type:  ComparisonError

      Copy to Clipboard Toggle word wrap

   2. Vérifiez le champ Status.Sync. S'il y a des erreurs dans le journal, le champ Status.Sync pourrait indiquer une erreur Unknown:

      Status:
        Sync:
          Compared To:
            Destination:
              Namespace:  clusters-sub
              Server:     https://kubernetes.default.svc
            Source:
              Path:             sites-config
              Repo URL:         https://git.com/ran-sites/siteconfigs/.git
              Target Revision:  master
          Status:               Unknown

      Copy to Clipboard Toggle word wrap

Précédent

1. Supprimez un site et les CR associés en supprimant les fichiers SiteConfig et PolicyGenTemplate du fichier kustomization.yaml.

   Lorsque vous exécutez à nouveau le pipeline ZTP, les CR générés sont supprimés.

2. Facultatif : Si vous souhaitez supprimer définitivement un site, vous devez également supprimer du dépôt Git les fichiers SiteConfig et PolicyGenTemplate spécifiques au site.
3. Facultatif : Si vous souhaitez supprimer temporairement un site, par exemple lors du redéploiement d'un site, vous pouvez laisser les CR SiteConfig et PolicyGenTemplate spécifiques au site dans le référentiel Git.

Procédure

1. Supprimer les fichiers PolicyGenTemplate concernés du dépôt Git, valider et pousser vers le dépôt distant.
2. Attendez que les modifications soient synchronisées par l'application et que les stratégies concernées soient supprimées du cluster du concentrateur.

3. Ajouter les fichiers PolicyGenTemplate mis à jour au dépôt Git, puis valider et pousser vers le dépôt distant.

   Note

   La suppression des politiques de zero touch provisioning (ZTP) du référentiel Git, et par conséquent leur suppression du hub cluster, n'affecte pas la configuration du cluster géré. La politique et les CR gérés par cette politique restent en place sur le cluster géré.

4. Facultatif : Après avoir apporté des modifications aux CR PolicyGenTemplate qui entraînent des stratégies obsolètes, vous pouvez supprimer manuellement ces stratégies du cluster du concentrateur. Vous pouvez supprimer les politiques à partir de la console RHACM en utilisant l'onglet Governance ou en exécutant la commande suivante :

   oc delete policy -n <namespace> <policy_name>

   Copy to Clipboard Toggle word wrap

Procédure

1. Détachez tous les clusters de Red Hat Advanced Cluster Management (RHACM) sur le cluster concentrateur.

2. Supprimez le fichier kustomization.yaml dans le répertoire deployment à l'aide de la commande suivante :

   $ oc delete -k out/argocd/deployment

   Copy to Clipboard Toggle word wrap
3. Validez et transférez vos modifications dans le référentiel du site.