21.11. Mise à jour de GitOps ZTP

1. Étiqueter tous les groupes existants avec l'étiquette ztp-done.
2. Arrêter les applications ArgoCD.
3. Installer les nouveaux outils ZTP de GitOps.
4. Mettre à jour le contenu requis et les changements optionnels dans le dépôt Git.
5. Mettre à jour et redémarrer la configuration de l'application.

Procédure

1. Obtenir la dernière version du conteneur GitOps ZTP qui contient les ressources personnalisées (CR) utilisées pour configurer Red Hat OpenShift GitOps pour une utilisation avec GitOps ZTP.

2. Extrayez le répertoire argocd/deployment à l'aide des commandes suivantes :

   $ mkdir -p ./update

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

   Le répertoire /update contient les sous-répertoires suivants :

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

3. Mettez à jour les fichiers clusters-app.yaml et policies-app.yaml pour refléter le nom de vos applications et l'URL, la branche et le chemin de votre dépôt Git.

   Si la mise à niveau inclut des changements qui entraînent des politiques obsolètes, ces dernières doivent être supprimées avant d'effectuer la mise à niveau.

4. Diffuser les changements entre les CR de configuration et de déploiement dans le dossier /update et le repo Git où vous gérez les CR de votre flotte de sites. Appliquez et poussez les changements requis dans le référentiel de votre site.

   Important

   Lorsque vous mettez à jour GitOps ZTP vers la dernière version, vous devez appliquer les changements du répertoire update/argocd/deployment au dépôt de votre site. N'utilisez pas d'anciennes versions des fichiers argocd/deployment/.

Procédure

1. Trouvez un sélecteur d'étiquettes qui répertorie les clusters gérés qui ont été déployés avec le zero touch provisioning (ZTP), comme local-cluster!=true:

   $ oc get managedcluster -l 'local-cluster!=true'

2. Assurez-vous que la liste obtenue contient tous les clusters gérés qui ont été déployés avec ZTP, puis utilisez ce sélecteur pour ajouter l'étiquette ztp-done:

   $ oc label managedcluster -l 'local-cluster!=true' ztp-done=

Procédure

1. Effectuer une suppression non cascadée sur l'application clusters pour laisser toutes les ressources générées en place :

   $ oc delete -f update/argocd/deployment/clusters-app.yaml

2. Effectuez une suppression en cascade sur l'application policies pour supprimer toutes les politiques précédentes :

   $ oc patch -f policies-app.yaml -p '{"metadata": {"finalizers": ["resources-finalizer.argocd.argoproj.io"]}}' --type merge

   $ oc delete -f update/argocd/deployment/policies-app.yaml

Procédure

1. Pour patcher l'instance ArgoCD dans le cluster hub en utilisant le fichier patch que vous avez précédemment extrait dans le répertoire update/argocd/deployment/, entrez la commande suivante :

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

2. Pour appliquer le contenu du répertoire argocd/deployment, entrez la commande suivante :

   $ oc apply -k update/argocd/deployment