21.10. Mise à jour des clusters gérés avec le Topology Aware Lifecycle Manager

Procédure

1. Créer un CR PolicyGenTemplate pour la mise à jour de la plateforme :

   1. Enregistrez le contenu suivant du CR PolicyGenTemplate dans le fichier du-upgrade.yaml.

      Exemple de PolicyGenTemplate pour la mise à jour de la plate-forme

      apiVersion: ran.openshift.io/v1
      kind: PolicyGenTemplate
      metadata:
        name: "du-upgrade"
        namespace: "ztp-group-du-sno"
      spec:
        bindingRules:
          group-du-sno: ""
        mcp: "master"
        remediationAction: inform
        sourceFiles:
          - fileName: ImageSignature.yaml 1
            policyName: "platform-upgrade-prep"
            binaryData:
              ${DIGEST_ALGO}-${DIGEST_ENCODED}: ${SIGNATURE_BASE64} 2
          - fileName: DisconnectedICSP.yaml
            policyName: "platform-upgrade-prep"
            metadata:
              name: disconnected-internal-icsp-for-ocp
            spec:
              repositoryDigestMirrors: 3
                - mirrors:
                  - quay-intern.example.com/ocp4/openshift-release-dev
                  source: quay.io/openshift-release-dev/ocp-release
                - mirrors:
                  - quay-intern.example.com/ocp4/openshift-release-dev
                  source: quay.io/openshift-release-dev/ocp-v4.0-art-dev
          - fileName: ClusterVersion.yaml 4
            policyName: "platform-upgrade-prep"
            metadata:
              name: version
              annotations:
                ran.openshift.io/ztp-deploy-wave: "1"
            spec:
              channel: "stable-4.12"
              upstream: http://upgrade.example.com/images/upgrade-graph_stable-4.12
          - fileName: ClusterVersion.yaml 5
            policyName: "platform-upgrade"
            metadata:
              name: version
            spec:
              channel: "stable-4.12"
              upstream: http://upgrade.example.com/images/upgrade-graph_stable-4.12
              desiredUpdate:
                version: 4.12.4
            status:
              history:
                - version: 4.12.4
                  state: "Completed"

      1

      Le CR ConfigMap contient la signature de l'image de la version souhaitée à mettre à jour.

      2

      Affiche la signature de l'image de la version d'OpenShift Container Platform souhaitée. Obtenez la signature à partir du fichier checksum-${OCP_RELASE_NUMBER}.yaml que vous avez enregistré en suivant les procédures de la section " Configuration de l'environnement ".

      3

      Affiche le dépôt miroir qui contient l'image OpenShift Container Platform souhaitée. Obtenez les miroirs à partir du fichier imageContentSources.yaml que vous avez enregistré en suivant les procédures de la section " Configuration de l'environnement ".

      4

      Indique le CR ClusterVersion à mettre à jour en amont.

      5

      Indique le CR ClusterVersion pour déclencher la mise à jour. Les champs channel, upstream, et desiredVersion sont tous nécessaires pour la mise en cache des images.

      La CR PolicyGenTemplate génère deux politiques :

      • La politique du-upgrade-platform-upgrade-prep prépare la mise à jour de la plate-forme. Elle crée le CR ConfigMap pour la signature d'image de version souhaitée, crée la source de contenu d'image du référentiel d'images de version en miroir et met à jour la version du cluster avec le canal de mise à jour souhaité et le graphique de mise à jour accessible par le cluster géré dans l'environnement déconnecté.
      • La politique du-upgrade-platform-upgrade est utilisée pour effectuer la mise à niveau de la plate-forme.

   2. Ajoutez le contenu du fichier du-upgrade.yaml au fichier kustomization.yaml situé dans le dépôt ZTP Git pour les CR PolicyGenTemplate et transférez les modifications dans le dépôt Git.

      ArgoCD extrait les modifications du référentiel Git et génère les politiques sur le cluster hub.

   3. Vérifiez les politiques créées en exécutant la commande suivante :

      $ oc get policies -A | grep platform-upgrade

2. Appliquer les ressources de mise à jour requises avant de lancer la mise à jour de la plateforme avec le TALM.

   1. Enregistrez le contenu du fichier platform-upgrade-prep ClusterUpgradeGroup CR avec la stratégie du-upgrade-platform-upgrade-prep et les clusters gérés cibles dans le fichier cgu-platform-upgrade-prep.yml, comme indiqué dans l'exemple suivant :

      apiVersion: ran.openshift.io/v1alpha1
      kind: ClusterGroupUpgrade
      metadata:
        name: cgu-platform-upgrade-prep
        namespace: default
      spec:
        managedPolicies:
        - du-upgrade-platform-upgrade-prep
        clusters:
        - spoke1
        remediationStrategy:
          maxConcurrency: 1
        enable: true

   2. Appliquez la politique au cluster hub en exécutant la commande suivante :

      $ oc apply -f cgu-platform-upgrade-prep.yml

   3. Surveillez le processus de mise à jour. Une fois la mise à jour terminée, assurez-vous que la politique est conforme en exécutant la commande suivante :

      $ oc get policies --all-namespaces

3. Créez le CR ClusterGroupUpdate pour la mise à jour de la plate-forme avec le champ spec.enable défini sur false.

   1. Enregistrez le contenu de la mise à jour de la plate-forme ClusterGroupUpdate CR avec la stratégie du-upgrade-platform-upgrade et les clusters cibles dans le fichier cgu-platform-upgrade.yml, comme indiqué dans l'exemple suivant :

      apiVersion: ran.openshift.io/v1alpha1
      kind: ClusterGroupUpgrade
      metadata:
        name: cgu-platform-upgrade
        namespace: default
      spec:
        managedPolicies:
        - du-upgrade-platform-upgrade
        preCaching: false
        clusters:
        - spoke1
        remediationStrategy:
          maxConcurrency: 1
        enable: false

   2. Appliquez le CR ClusterGroupUpdate au cluster du concentrateur en exécutant la commande suivante :

      $ oc apply -f cgu-platform-upgrade.yml

4. Facultatif : Prémettre en cache les images pour la mise à jour de la plateforme.

   1. Activez la mise en cache préalable dans le CR ClusterGroupUpdate en exécutant la commande suivante :

      $ oc --namespace=default patch clustergroupupgrade.ran.openshift.io/cgu-platform-upgrade \
      --patch '{"spec":{"preCaching": true}}' --type=merge

   2. Surveillez le processus de mise à jour et attendez la fin de la mise en cache. Vérifiez l'état de la mise en cache préalable en exécutant la commande suivante sur le cluster du concentrateur :

      $ oc get cgu cgu-platform-upgrade -o jsonpath='{.status.precaching.status}'

5. Lancer la mise à jour de la plate-forme :

   1. Activez la stratégie cgu-platform-upgrade et désactivez la mise en cache préalable en exécutant la commande suivante :

      $ oc --namespace=default patch clustergroupupgrade.ran.openshift.io/cgu-platform-upgrade \
      --patch '{"spec":{"enable":true, "preCaching": false}}' --type=merge

   2. Surveillez le processus. Une fois le processus terminé, assurez-vous que la politique est conforme en exécutant la commande suivante :

      $ oc get policies --all-namespaces

Procédure

1. Mettre à jour le CR PolicyGenTemplate pour la mise à jour de l'opérateur.

   1. Mettez à jour le CR du-upgrade PolicyGenTemplate avec le contenu supplémentaire suivant dans le fichier du-upgrade.yaml:

      apiVersion: ran.openshift.io/v1
      kind: PolicyGenTemplate
      metadata:
        name: "du-upgrade"
        namespace: "ztp-group-du-sno"
      spec:
        bindingRules:
          group-du-sno: ""
        mcp: "master"
        remediationAction: inform
        sourceFiles:
          - fileName: DefaultCatsrc.yaml
            remediationAction: inform
            policyName: "operator-catsrc-policy"
            metadata:
              name: redhat-operators
            spec:
              displayName: Red Hat Operators Catalog
              image: registry.example.com:5000/olm/redhat-operators:v4.12 1
              updateStrategy: 2
                registryPoll:
                  interval: 1h

      1

      L'URL de l'image d'index contient les images de l'opérateur souhaitées. Si les images d'index sont toujours poussées vers le même nom d'image et la même balise, cette modification n'est pas nécessaire.

      2

      Le champ registryPoll.interval permet de définir la fréquence à laquelle le gestionnaire du cycle de vie de l'opérateur (OLM) interroge l'image d'index pour les nouvelles versions de l'opérateur. Cette modification n'est pas nécessaire si une nouvelle balise d'image d'index est toujours insérée pour les mises à jour des opérateurs des flux y et z. Le champ registryPoll.interval peut être défini sur un intervalle plus court pour accélérer la mise à jour, mais les intervalles plus courts augmentent la charge de calcul. Pour y remédier, vous pouvez rétablir la valeur par défaut du champ registryPoll.interval une fois la mise à jour terminée.

   2. Cette mise à jour génère une politique, du-upgrade-operator-catsrc-policy, pour mettre à jour la source du catalogue redhat-operators avec les nouvelles images d'index qui contiennent les images d'opérateurs souhaitées.

      Note

      Si vous souhaitez utiliser la mise en cache préalable des images pour les opérateurs et qu'il existe des opérateurs provenant d'une source de catalogue autre que redhat-operators, vous devez effectuer les tâches suivantes :

      • Préparez une stratégie de source de catalogue distincte avec la nouvelle image d'index ou la mise à jour de l'intervalle d'interrogation du registre pour la source de catalogue différente.
      • Préparer une politique d'abonnement distincte pour les opérateurs souhaités qui proviennent d'une source de catalogue différente.

      Par exemple, l'opérateur SRIOV-FEC souhaité est disponible dans la source de catalogue certified-operators. Pour mettre à jour la source du catalogue et l'abonnement à l'opérateur, ajoutez le contenu suivant pour générer deux politiques, du-upgrade-fec-catsrc-policy et du-upgrade-subscriptions-fec-policy:

      apiVersion: ran.openshift.io/v1
      kind: PolicyGenTemplate
      metadata:
        name: "du-upgrade"
        namespace: "ztp-group-du-sno"
      spec:
        bindingRules:
          group-du-sno: ""
        mcp: "master"
        remediationAction: inform
        sourceFiles:
             …
          - fileName: DefaultCatsrc.yaml
            remediationAction: inform
            policyName: "fec-catsrc-policy"
            metadata:
              name: certified-operators
            spec:
              displayName: Intel SRIOV-FEC Operator
              image: registry.example.com:5000/olm/far-edge-sriov-fec:v4.10
              updateStrategy:
                registryPoll:
                  interval: 10m
          - fileName: AcceleratorsSubscription.yaml
            policyName: "subscriptions-fec-policy"
            spec:
              channel: "stable"
              source: certified-operators

   3. Supprime les canaux d'abonnement spécifiés dans le CR commun PolicyGenTemplate, s'ils existent. Les canaux d'abonnement par défaut de l'image ZTP sont utilisés pour la mise à jour.

      Note

      Le canal par défaut pour les opérateurs appliqués par l'intermédiaire de ZTP 4.12 est stable, à l'exception de performance-addon-operator. À partir de OpenShift Container Platform 4.11, la fonctionnalité performance-addon-operator a été déplacée vers node-tuning-operator. Pour la version 4.10, le canal par défaut pour PAO est v4.10. Vous pouvez également spécifier les canaux par défaut dans le CR commun PolicyGenTemplate.

   4. Pousser les mises à jour de PolicyGenTemplate CRs vers le dépôt ZTP Git.

      ArgoCD extrait les modifications du référentiel Git et génère les politiques sur le cluster hub.

   5. Vérifiez les politiques créées en exécutant la commande suivante :

      $ oc get policies -A | grep -E "catsrc-policy|subscription"

2. Appliquez les mises à jour nécessaires du catalogue avant de lancer la mise à jour de l'opérateur.

   1. Enregistrez le contenu du CR ClusterGroupUpgrade nommé operator-upgrade-prep avec les stratégies source du catalogue et les clusters gérés cibles dans le fichier cgu-operator-upgrade-prep.yml:

      apiVersion: ran.openshift.io/v1alpha1
      kind: ClusterGroupUpgrade
      metadata:
        name: cgu-operator-upgrade-prep
        namespace: default
      spec:
        clusters:
        - spoke1
        enable: true
        managedPolicies:
        - du-upgrade-operator-catsrc-policy
        remediationStrategy:
          maxConcurrency: 1

   2. Appliquez la politique au cluster hub en exécutant la commande suivante :

      $ oc apply -f cgu-operator-upgrade-prep.yml

   3. Surveillez le processus de mise à jour. Une fois la mise à jour terminée, assurez-vous que la politique est conforme en exécutant la commande suivante :

      $ oc get policies -A | grep -E "catsrc-policy"

3. Créez le CR ClusterGroupUpgrade pour la mise à jour de l'opérateur avec le champ spec.enable défini sur false.

   1. Enregistrez le contenu de la mise à jour de l'opérateur ClusterGroupUpgrade CR avec la stratégie du-upgrade-operator-catsrc-policy et les stratégies d'abonnement créées à partir des clusters communs PolicyGenTemplate et cibles dans le fichier cgu-operator-upgrade.yml, comme indiqué dans l'exemple suivant :

      apiVersion: ran.openshift.io/v1alpha1
      kind: ClusterGroupUpgrade
      metadata:
        name: cgu-operator-upgrade
        namespace: default
      spec:
        managedPolicies:
        - du-upgrade-operator-catsrc-policy 1
        - common-subscriptions-policy 2
        preCaching: false
        clusters:
        - spoke1
        remediationStrategy:
          maxConcurrency: 1
        enable: false

      1

      La politique est nécessaire à la fonction de mise en cache préalable des images pour récupérer les images de l'opérateur à partir de la source du catalogue.

      2

      La politique contient des abonnements d'opérateurs. Si vous avez suivi la structure et le contenu de la référence PolicyGenTemplates, tous les abonnements des opérateurs sont regroupés dans la politique common-subscriptions-policy.

      Note

      Un CR ClusterGroupUpgrade ne peut pré-cacher que les images des opérateurs souhaités définis dans la politique d'abonnement à partir d'une source de catalogue incluse dans le CR ClusterGroupUpgrade. Si les opérateurs souhaités proviennent de différentes sources de catalogue, comme dans l'exemple de l'opérateur SRIOV-FEC, un autre CR ClusterGroupUpgrade doit être créé avec les politiques du-upgrade-fec-catsrc-policy et du-upgrade-subscriptions-fec-policy pour la mise en cache et la mise à jour des images de l'opérateur SRIOV-FEC.

   2. Appliquez le CR ClusterGroupUpgrade au cluster du concentrateur en exécutant la commande suivante :

      $ oc apply -f cgu-operator-upgrade.yml

4. Facultatif : Prémettre en cache les images pour la mise à jour de l'opérateur.

   1. Avant de commencer la mise en cache des images, vérifiez que la politique d'abonnement est bien NonCompliant à ce stade en exécutant la commande suivante :

      $ oc get policy common-subscriptions-policy -n <policy_namespace>

      Exemple de sortie

      NAME                          REMEDIATION ACTION   COMPLIANCE STATE     AGE
      common-subscriptions-policy   inform               NonCompliant         27d

   2. Activez la mise en cache préalable dans le CR ClusterGroupUpgrade en exécutant la commande suivante :

      $ oc --namespace=default patch clustergroupupgrade.ran.openshift.io/cgu-operator-upgrade \
      --patch '{"spec":{"preCaching": true}}' --type=merge

   3. Surveillez le processus et attendez la fin de la mise en cache. Vérifiez l'état de la mise en cache préalable en exécutant la commande suivante sur le cluster géré :

      $ oc get cgu cgu-operator-upgrade -o jsonpath='{.status.precaching.status}'

   4. Vérifiez que la mise en cache est terminée avant de lancer la mise à jour en exécutant la commande suivante :

      $ oc get cgu -n default cgu-operator-upgrade -ojsonpath='{.status.conditions}' | jq

      Exemple de sortie

      [
          {
            "lastTransitionTime": "2022-03-08T20:49:08.000Z",
            "message": "The ClusterGroupUpgrade CR is not enabled",
            "reason": "UpgradeNotStarted",
            "status": "False",
            "type": "Ready"
          },
          {
            "lastTransitionTime": "2022-03-08T20:55:30.000Z",
            "message": "Precaching is completed",
            "reason": "PrecachingCompleted",
            "status": "True",
            "type": "PrecachingDone"
          }
      ]

5. Lancer la mise à jour de l'opérateur.

   1. Activez le cgu-operator-upgrade ClusterGroupUpgrade CR et désactivez la mise en cache préalable pour lancer la mise à jour de l'opérateur en exécutant la commande suivante :

      $ oc --namespace=default patch clustergroupupgrade.ran.openshift.io/cgu-operator-upgrade \
      --patch '{"spec":{"enable":true, "preCaching": false}}' --type=merge

   2. Surveillez le processus. Une fois le processus terminé, assurez-vous que la politique est conforme en exécutant la commande suivante :

      $ oc get policies --all-namespaces

Procédure

1. Créez le CR PolicyGenTemplate pour les mises à jour en suivant les étapes décrites dans les sections "Effectuer une mise à jour de la plate-forme" et "Effectuer une mise à jour de l'opérateur".

2. Appliquer les travaux préparatoires pour la plateforme et la mise à jour de l'opérateur.

   1. Enregistrez le contenu du fichier ClusterGroupUpgrade CR avec les politiques de préparation des mises à jour de la plate-forme, les mises à jour de la source du catalogue et les clusters cibles dans le fichier cgu-platform-operator-upgrade-prep.yml, par exemple :

      apiVersion: ran.openshift.io/v1alpha1
      kind: ClusterGroupUpgrade
      metadata:
        name: cgu-platform-operator-upgrade-prep
        namespace: default
      spec:
        managedPolicies:
        - du-upgrade-platform-upgrade-prep
        - du-upgrade-operator-catsrc-policy
        clusterSelector:
        - group-du-sno
        remediationStrategy:
          maxConcurrency: 10
        enable: true

   2. Appliquez le fichier cgu-platform-operator-upgrade-prep.yml au cluster hub en exécutant la commande suivante :

      $ oc apply -f cgu-platform-operator-upgrade-prep.yml

   3. Surveillez le processus. Une fois le processus terminé, assurez-vous que la politique est conforme en exécutant la commande suivante :

      $ oc get policies --all-namespaces

3. Créez le CR ClusterGroupUpdate pour la plate-forme et la mise à jour de l'opérateur avec le champ spec.enable réglé sur false.

   1. Enregistrez le contenu de la plateforme et de la mise à jour de l'opérateur ClusterGroupUpdate CR avec les politiques et les clusters cibles dans le fichier cgu-platform-operator-upgrade.yml, comme indiqué dans l'exemple suivant :

      apiVersion: ran.openshift.io/v1alpha1
      kind: ClusterGroupUpgrade
      metadata:
        name: cgu-du-upgrade
        namespace: default
      spec:
        managedPolicies:
        - du-upgrade-platform-upgrade 1
        - du-upgrade-operator-catsrc-policy 2
        - common-subscriptions-policy 3
        preCaching: true
        clusterSelector:
        - group-du-sno
        remediationStrategy:
          maxConcurrency: 1
        enable: false

      1

      Il s'agit de la politique de mise à jour de la plateforme.

      2

      Il s'agit de la stratégie contenant les informations de source du catalogue pour les opérateurs à mettre à jour. Elle est nécessaire pour que la fonction de mise en cache préalable détermine les images d'opérateurs à télécharger sur le cluster géré.

      3

      Il s'agit de la politique de mise à jour des opérateurs.

   2. Appliquez le fichier cgu-platform-operator-upgrade.yml au cluster hub en exécutant la commande suivante :

      $ oc apply -f cgu-platform-operator-upgrade.yml

4. Facultatif : Pré-cachez les images pour la plateforme et la mise à jour de l'opérateur.

   1. Activez la mise en cache préalable dans le CR ClusterGroupUpgrade en exécutant la commande suivante :

      $ oc --namespace=default patch clustergroupupgrade.ran.openshift.io/cgu-du-upgrade \
      --patch '{"spec":{"preCaching": true}}' --type=merge

   2. Surveillez le processus de mise à jour et attendez la fin de la mise en cache. Vérifiez l'état de la mise en cache préalable en exécutant la commande suivante sur le cluster géré :

      $ oc get jobs,pods -n openshift-talm-pre-cache

   3. Vérifiez que la mise en cache est terminée avant de lancer la mise à jour en exécutant la commande suivante :

      $ oc get cgu cgu-du-upgrade -ojsonpath='{.status.conditions}'

5. Démarrer la plateforme et la mise à jour de l'opérateur.

   1. Activez le cgu-du-upgrade ClusterGroupUpgrade CR pour démarrer la plateforme et la mise à jour de l'opérateur en exécutant la commande suivante :

      $ oc --namespace=default patch clustergroupupgrade.ran.openshift.io/cgu-du-upgrade \
      --patch '{"spec":{"enable":true, "preCaching": false}}' --type=merge

   2. Surveillez le processus. Une fois le processus terminé, assurez-vous que la politique est conforme en exécutant la commande suivante :

      $ oc get policies --all-namespaces

      Note

      Les CR pour les mises à jour de la plate-forme et de l'opérateur peuvent être créés dès le début en configurant le paramètre spec.enable: true. Dans ce cas, la mise à jour démarre immédiatement après la fin de la mise en cache préalable et il n'est pas nécessaire d'activer manuellement le CR.

      La mise en cache préalable et la mise à jour créent des ressources supplémentaires, telles que des stratégies, des liaisons de placement, des règles de placement, des actions de cluster géré et des vues de cluster géré, afin de faciliter l'exécution des procédures. La définition du champ afterCompletion.deleteObjects sur true supprime toutes ces ressources une fois les mises à jour terminées.

Procédure

1. Remplacez complianceType par mustnothave pour l'espace de noms Performance Addon Operator, le groupe Operator et l'abonnement dans le fichier common-ranGen.yaml.

    -  fileName: PaoSubscriptionNS.yaml
       policyName: "subscriptions-policy"
       complianceType: mustnothave
    -  fileName: PaoSubscriptionOperGroup.yaml
       policyName: "subscriptions-policy"
       complianceType: mustnothave
    -  fileName: PaoSubscription.yaml
       policyName: "subscriptions-policy"
       complianceType: mustnothave

2. Fusionnez les modifications avec votre référentiel de site personnalisé et attendez que l'application ArgoCD synchronise les modifications avec le cluster du concentrateur. Le statut de la politique common-subscriptions-policy devient Non-Compliant.
3. Appliquez la modification à vos clusters cibles à l'aide du gestionnaire de cycle de vie Topology Aware. Pour plus d'informations sur le déploiement des modifications de configuration, voir la section "Ressources supplémentaires".

4. Surveillez le processus. Lorsque le statut de la politique common-subscriptions-policy pour un cluster cible est Compliant, l'opérateur Performance Addon a été supprimé du cluster. Obtenez le statut de common-subscriptions-policy en exécutant la commande suivante :

   $ oc get policy -n ztp-common common-subscriptions-policy

5. Supprimer l'espace de noms de l'opérateur Performance Addon, le groupe d'opérateurs et les CR d'abonnement de .spec.sourceFiles dans le fichier common-ranGen.yaml.
6. Fusionnez les modifications avec votre référentiel de site personnalisé et attendez que l'application ArgoCD synchronise les modifications avec le cluster du concentrateur. La politique reste conforme.