12.3. Mise à jour d'un cluster dans un environnement déconnecté à l'aide du service de mise à jour d'OpenShift

Procédure

1. Dans la console web, cliquez sur Operators OperatorHub.

   Note

   Entrez Update Service dans le champ Filter by keyword…​ pour trouver l'opérateur plus rapidement.

2. Choisissez OpenShift Update Service dans la liste des opérateurs disponibles et cliquez sur Install.

   1. Le canal v1 est sélectionné comme Update Channel car c'est le seul canal disponible dans cette version.
   2. Sélectionnez A specific namespace on the cluster sous Installation Mode.
   3. Sélectionnez un espace de noms pour Installed Namespace ou acceptez l'espace de noms recommandé openshift-update-service.

   4. Sélectionnez un site Approval Strategy:

      • La stratégie Automatic permet à Operator Lifecycle Manager (OLM) de mettre automatiquement à jour l'opérateur lorsqu'une nouvelle version est disponible.
      • La stratégie Manual exige qu'un administrateur de cluster approuve la mise à jour de l'opérateur.
   5. Cliquez sur Install.
3. Vérifiez que l'opérateur OpenShift Update Service est installé en passant à la page Operators Installed Operators.
4. Assurez-vous que OpenShift Update Service est répertorié dans l'espace de noms sélectionné avec un Status de Succeeded.

Procédure

1. Créer un espace de noms pour l'opérateur de service de mise à jour OpenShift :

   1. Créez un fichier YAML de l'objet Namespace, par exemple, update-service-namespace.yaml, pour l'opérateur du service de mise à jour OpenShift :

      apiVersion: v1
      kind: Namespace
      metadata:
        name: openshift-update-service
        annotations:
          openshift.io/node-selector: ""
        labels:
          openshift.io/cluster-monitoring: "true" 

      1

      Copy to Clipboard Toggle word wrap

      1

      Définissez l'étiquette openshift.io/cluster-monitoring pour activer la surveillance des clusters recommandée par l'opérateur sur cet espace de noms.

   2. Créer l'espace de noms :

      $ oc create -f <filename>.yaml

      Copy to Clipboard Toggle word wrap

      Par exemple :

      $ oc create -f update-service-namespace.yaml

      Copy to Clipboard Toggle word wrap

2. Installez l'opérateur OpenShift Update Service en créant les objets suivants :

   1. Créez un fichier YAML de l'objet OperatorGroup, par exemple update-service-operator-group.yaml:

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: update-service-operator-group
      spec:
        targetNamespaces:
        - openshift-update-service

      Copy to Clipboard Toggle word wrap

   2. Créer un objet OperatorGroup:

      oc -n openshift-update-service create -f <filename>.yaml

      Copy to Clipboard Toggle word wrap

      Par exemple :

      $ oc -n openshift-update-service create -f update-service-operator-group.yaml

      Copy to Clipboard Toggle word wrap

   3. Créez un fichier YAML de l'objet Subscription, par exemple update-service-subscription.yaml:

      Exemple d'abonnement

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: update-service-subscription
      spec:
        channel: v1
        installPlanApproval: "Automatic"
        source: "redhat-operators" 

      1

      
        sourceNamespace: "openshift-marketplace"
        name: "cincinnati-operator"

      Copy to Clipboard Toggle word wrap

      1

      Indiquez le nom de la source de catalogue qui fournit l'opérateur. Pour les clusters qui n'utilisent pas un Operator Lifecycle Manager (OLM) personnalisé, indiquez redhat-operators. Si votre cluster OpenShift Container Platform est installé dans un environnement déconnecté, indiquez le nom de l'objet CatalogSource créé lorsque vous avez configuré Operator Lifecycle Manager (OLM).

   4. Créer l'objet Subscription:

      $ oc create -f <filename>.yaml

      Copy to Clipboard Toggle word wrap

      Par exemple :

      $ oc -n openshift-update-service create -f update-service-subscription.yaml

      Copy to Clipboard Toggle word wrap

      L'opérateur OpenShift Update Service est installé dans l'espace de noms openshift-update-service et cible l'espace de noms openshift-update-service.

3. Vérifier l'installation de l'opérateur :

   $ oc -n openshift-update-service get clusterserviceversions

   Copy to Clipboard Toggle word wrap

   Exemple de sortie

   NAME                             DISPLAY                    VERSION   REPLACES   PHASE
   update-service-operator.v4.6.0   OpenShift Update Service   4.6.0                Succeeded
   ...

   Copy to Clipboard Toggle word wrap

   Si l'opérateur OpenShift Update Service est listé, l'installation a réussi. Le numéro de version peut être différent de celui indiqué.

Procédure

1. Dans la console web, cliquez sur Operators Installed Operators.
2. Choisissez OpenShift Update Service dans la liste des opérateurs installés.
3. Cliquez sur l'onglet Update Service.
4. Cliquez sur Create UpdateService.
5. Entrez un nom dans le champ Name, par exemple service.
6. Saisissez le pullspec local dans le champ Graph Data Image vers l'image du conteneur de données graphiques créée dans \N "Création de l'image du conteneur de données graphiques d'OpenShift Update Service\N", par exemple, registry.example.com/openshift/graph-data:latest.
7. Dans le champ Releases, saisissez le registre local et le référentiel créés pour contenir les images de version dans le document "Mirroring the OpenShift Container Platform image repository", par exemple, registry.example.com/ocp4/openshift4-release-images.
8. Saisissez 2 dans le champ Replicas.
9. Cliquez sur Create pour créer l'application OpenShift Update Service.

10. Vérifiez l'application OpenShift Update Service :

    • Dans la liste UpdateServices de l'onglet Update Service, cliquez sur l'application Update Service que vous venez de créer.
    • Cliquez sur l'onglet Resources.
    • Vérifiez que chaque ressource d'application a un statut de Created.

Procédure

1. Configurez l'espace de noms cible d'OpenShift Update Service, par exemple, openshift-update-service:

   $ NAMESPACE=openshift-update-service

   Copy to Clipboard Toggle word wrap

   L'espace de noms doit correspondre à la valeur targetNamespaces du groupe d'opérateurs.

2. Configurez le nom de l'application OpenShift Update Service, par exemple, service:

   $ NAME=service

   Copy to Clipboard Toggle word wrap

3. Configurez le registre local et le référentiel pour les images de version comme configuré dans "Mirroring the OpenShift Container Platform image repository", par exemple, registry.example.com/ocp4/openshift4-release-images:

   $ RELEASE_IMAGES=registry.example.com/ocp4/openshift4-release-images

   Copy to Clipboard Toggle word wrap

4. Définir le pullspec local pour l'image de données graphiques à l'image de conteneur de données graphiques créée dans " Création de l'image de conteneur de données graphiques d'OpenShift Update Service ", par exemple, registry.example.com/openshift/graph-data:latest:

   $ GRAPH_DATA_IMAGE=registry.example.com/openshift/graph-data:latest

   Copy to Clipboard Toggle word wrap

5. Créer un objet d'application OpenShift Update Service :

   $ oc -n "${NAMESPACE}" create -f - <<EOF
   apiVersion: updateservice.operator.openshift.io/v1
   kind: UpdateService
   metadata:
     name: ${NAME}
   spec:
     replicas: 2
     releases: ${RELEASE_IMAGES}
     graphDataImage: ${GRAPH_DATA_IMAGE}
   EOF

   Copy to Clipboard Toggle word wrap

6. Vérifiez l'application OpenShift Update Service :

   1. Utilisez la commande suivante pour obtenir un itinéraire de moteur de stratégie :

      $ while sleep 1; do POLICY_ENGINE_GRAPH_URI="$(oc -n "${NAMESPACE}" get -o jsonpath='{.status.policyEngineURI}/api/upgrades_info/v1/graph{"\n"}' updateservice "${NAME}")"; SCHEME="${POLICY_ENGINE_GRAPH_URI%%:*}"; if test "${SCHEME}" = http -o "${SCHEME}" = https; then break; fi; done

      Copy to Clipboard Toggle word wrap

      Il se peut que vous deviez interroger le système jusqu'à ce que la commande aboutisse.

   2. Récupérer un graphe du moteur de politiques. Veillez à spécifier une version valide pour channel. Par exemple, si vous utilisez OpenShift Container Platform 4.12, utilisez stable-4.12:

      $ while sleep 10; do HTTP_CODE="$(curl --header Accept:application/json --output /dev/stderr --write-out "%{http_code}" "${POLICY_ENGINE_GRAPH_URI}?channel=stable-4.6")"; if test "${HTTP_CODE}" -eq 200; then break; fi; echo "${HTTP_CODE}"; done

      Copy to Clipboard Toggle word wrap

      Cette opération s'effectue jusqu'à ce que la demande de graphique aboutisse ; toutefois, le graphique résultant peut être vide en fonction des images de version que vous avez mises en miroir.