21.2. Préparation de la grappe du concentrateur pour ZTP

Procédure

1. Connectez-vous à l'hôte miroir.

2. Obtenez les images RHCOS ISO et RootFS à partir de mirror.openshift.com, par exemple :

   1. Exporter les noms des images requises et la version d'OpenShift Container Platform en tant que variables d'environnement :

      $ export ISO_IMAGE_NAME=<iso_image_name> 1

      $ export ROOTFS_IMAGE_NAME=<rootfs_image_name> 1

      $ export OCP_VERSION=<ocp_version> 1

      1

      Nom de l'image ISO, par exemple, rhcos-4.12.1-x86_64-live.x86_64.iso

      1

      Nom de l'image RootFS, par exemple, rhcos-4.12.1-x86_64-live-rootfs.x86_64.img

      1

      Version d'OpenShift Container Platform, par exemple, 4.12.1

   2. Téléchargez les images nécessaires :

      $ sudo wget https://mirror.openshift.com/pub/openshift-v4/dependencies/rhcos/4.12/${OCP_VERSION}/${ISO_IMAGE_NAME} -O /var/www/html/${ISO_IMAGE_NAME}

      $ sudo wget https://mirror.openshift.com/pub/openshift-v4/dependencies/rhcos/4.12/${OCP_VERSION}/${ROOTFS_IMAGE_NAME} -O /var/www/html/${ROOTFS_IMAGE_NAME}

Procédure

1. Mettez à jour le CR AgentServiceConfig en exécutant la commande suivante :

   $ oc edit AgentServiceConfig

2. Ajouter l'entrée suivante au champ items.spec.osImages du CR :

   - cpuArchitecture: x86_64
       openshiftVersion: "4.12"
       rootFSUrl: https://<host>/<path>/rhcos-live-rootfs.x86_64.img
       url: https://<mirror-registry>/<path>/rhcos-live.x86_64.iso

   où :

   <host>

   Nom de domaine complet (FQDN) du serveur HTTP du registre miroir cible.

   <sentier>

   Chemin d'accès à l'image sur le registre du miroir cible.

   Enregistrez et quittez l'éditeur pour appliquer les modifications.

Procédure

1. Créer un ConfigMap contenant la configuration du registre miroir :

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: assisted-installer-mirror-config
     namespace: assisted-installer
     labels:
       app: assisted-service
   data:
     ca-bundle.crt: <certificate> 1
     registries.conf: |  2
       unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
   
       [[registry]]
         location = <mirror_registry_url>  3
         insecure = false
         mirror-by-digest-only = true

   1

   Certificat du registre miroir utilisé lors de la création du registre miroir.

   2

   Le fichier de configuration du registre des miroirs. La configuration du registre miroir ajoute des informations de miroir à /etc/containers/registries.conf dans l'image de découverte. Ces informations sont stockées dans la section imageContentSources du fichier install-config.yaml lorsqu'elles sont transmises au programme d'installation. Le pod de service assisté fonctionnant sur le cluster HUB récupère les images des conteneurs à partir du registre miroir configuré.

   3

   L'URL du registre miroir.

   Cette opération met à jour mirrorRegistryRef dans la ressource personnalisée AgentServiceConfig, comme indiqué ci-dessous :

   Exemple de sortie

   apiVersion: agent-install.openshift.io/v1beta1
   kind: AgentServiceConfig
   metadata:
     name: agent
     namespace: assisted-installer
   spec:
     databaseStorage:
       volumeName: <db_pv_name>
       accessModes:
       - ReadWriteOnce
       resources:
         requests:
           storage: <db_storage_size>
     filesystemStorage:
       volumeName: <fs_pv_name>
       accessModes:
       - ReadWriteOnce
       resources:
         requests:
           storage: <fs_storage_size>
     mirrorRegistryRef:
       name: 'assisted-installer-mirror-config'
     osImages:
       - openshiftVersion: <ocp_version>
         rootfs: <rootfs_url> 1
         url: <iso_url> 2

   1 2

   Doit correspondre aux URL du serveur HTTPD.

Procédure

1. Mettez à jour la ressource personnalisée (CR) AgentServiceConfig en exécutant la commande suivante :

   $ oc edit AgentServiceConfig agent

2. Ajouter le champ unauthenticatedRegistries dans le CR :

   apiVersion: agent-install.openshift.io/v1beta1
   kind: AgentServiceConfig
   metadata:
     name: agent
   spec:
     unauthenticatedRegistries:
     - example.registry.com
     - example.registry2.com
     ...

   Les registres non authentifiés sont répertoriés sous spec.unauthenticatedRegistries dans la ressource AgentServiceConfig. Tout registre figurant sur cette liste n'est pas tenu d'avoir une entrée dans le secret d'extraction utilisé pour l'installation du cluster de rayons. assisted-service valide le secret d'extraction en s'assurant qu'il contient les informations d'authentification pour chaque registre d'image utilisé pour l'installation.

1. Ouvrez un shell de débogage vers le cluster du concentrateur :

   oc debug node/<node_name>

2. Testez l'accès au registre non authentifié en exécutant la commande suivante :

   sh-4.4# podman login -u kubeadmin -p $(oc whoami -t) <unauthenticated_registry>

   où :

   <registre_non-authentifié>

   Le nouveau registre est-il, par exemple, unauthenticated-image-registry.openshift-image-registry.svc:5000.

   Exemple de sortie

   Login Succeeded!

Procédure

1. Préparer la configuration du pipeline ArgoCD :

   1. Créez un dépôt Git avec une structure de répertoire similaire au répertoire d'exemple. Pour plus d'informations, voir "Preparing the GitOps ZTP site configuration repository".

   2. Configurez l'accès au référentiel en utilisant l'interface utilisateur d'ArgoCD. Sous Settings, configurez les éléments suivants :

      • Repositories - Ajoutez les informations de connexion. L'URL doit se terminer par .git, par exemple, https://repo.example.com/repo.git et les informations d'identification.
      • Certificates - Ajoutez le certificat public pour le référentiel, si nécessaire.

   3. Modifiez les deux applications ArgoCD, out/argocd/deployment/clusters-app.yaml et out/argocd/deployment/policies-app.yaml, en fonction de votre dépôt Git :

      • Mettez à jour l'URL pour qu'elle pointe vers le dépôt Git. L'URL se termine par .git, par exemple, https://repo.example.com/repo.git.
      • Le site targetRevision indique la branche du dépôt Git à surveiller.
      • path spécifie le chemin vers les CR SiteConfig et PolicyGenTemplate, respectivement.

2. Pour installer le plugin ZTP GitOps, vous devez patcher l'instance ArgoCD dans le cluster hub en utilisant le fichier patch précédemment extrait dans le répertoire out/argocd/deployment/. Exécutez la commande suivante :

   $ oc patch argocd openshift-gitops \
   -n openshift-gitops --type=merge \
   --patch-file out/argocd/deployment/argocd-openshift-gitops-patch.json

3. Appliquez la configuration du pipeline à votre cluster hub en utilisant la commande suivante :

   $ oc apply -k out/argocd/deployment

Procédure

1. Créez une structure de répertoire avec des chemins distincts pour les CR SiteConfig et PolicyGenTemplate.

2. Exportez le répertoire argocd à partir de l'image du conteneur ztp-site-generate à l'aide des commandes suivantes :

   $ podman pull registry.redhat.io/openshift4/ztp-site-generate-rhel8:v4.12

   $ mkdir -p ./out

   $ podman run --log-driver=none --rm registry.redhat.io/openshift4/ztp-site-generate-rhel8:v4.12 extract /home/ztp --tar | tar x -C ./out

3. Vérifiez que le répertoire out contient les sous-répertoires suivants :

   • out/extra-manifest contient les fichiers CR source que SiteConfig utilise pour générer le manifeste supplémentaire configMap.
   • out/source-crs contient les fichiers CR source que PolicyGenTemplate utilise pour générer les stratégies de Red Hat Advanced Cluster Management (RHACM).
   • out/argocd/deployment contient des correctifs et des fichiers YAML à appliquer sur le cluster hub pour l'étape suivante de cette procédure.
   • out/argocd/example contient les exemples de fichiers SiteConfig et PolicyGenTemplate qui représentent la configuration recommandée.