Avant de commencer

Avant d'installer le module complémentaire ACM, vérifiez les étapes et les informations préalables suivantes.

1. Assurez-vous que vos clusters répondent aux exigences suivantes.
   • Votre cluster hub doit être un cluster VPC avec au moins 3 nœuds de travail qui exécutent RHCOS et un minimum de 6 VCPU et 64GB RAM. Pour la haute disponibilité, assurez-vous que votre cluster dispose d'au moins un nœud de travail par zone sur 3 zones.
   • Chaque cluster géré doit avoir au moins 3 nœuds de travail qui exécutent RHCOS et un minimum de 6 VCPU et 64GB RAM.
2. Passez en revue les opérateurs qui sont automatiquement installés par le module complémentaire ACM et les opérateurs optionnels que vous pouvez installer en tant qu'extensions.
3. Vous devez avoir le rôle d'accès à la plate-forme Administrateur et le rôle d'accès au service Gestionnaire pour le cluster dans IBM Cloud Kubernetes Service.
4. Vous devez disposer d'un cluster VPC comportant au moins 3 nœuds de travail. Chaque nœud de travail doit disposer d'au moins 4 processeurs et d' 16GB s de RAM. Pour la haute disponibilité, assurez-vous que votre cluster dispose d'au moins un nœud de travail par zone sur 3 zones.
5. Créez un profil de confiance sur votre cluster à utiliser pour ACM.
6. Facultatif: si vous souhaitez importer des clusters gérés lors du processus d'installation du module complémentaire ACM, si vous prévoyez d'importer des clusters gérés à l'aide de l'interface de ligne de commande (CLI) après l'installation, ou si vous prévoyez de mettre à jour ultérieurement les informations d'identification de connexion d'un cluster géré, vous devez créer un secret sur le cluster hub pour chaque cluster géré. Voir Préparation des secrets pour ACM. Cette étape n’est pas nécessaire si vous prévoyez uniquement d’importer des clusters gérés après l’installation à l’aide de la console Web OpenShift.
7. Installer ou mettre à jour le CLI.

Créer un profil de confiance pour ACM

Suivez les étapes pour créer un profil de confiance à utiliser avec ACM et l'attribuer au cluster hub.

Une fois que vous avez ajouté un profil de confiance à un cluster, celui-ci ne peut plus être supprimé et vous ne pouvez plus utiliser une clé API pour vos ressources. Veillez à suivre attentivement ces étapes afin de vous assurer que votre profil de confiance est correctement configuré.

Préparation des secrets pour l'ACM

La création de secrets pour ACM est facultative. Vous ne devez remplir cette section que si vous souhaitez importer des clusters gérés lors du processus d'installation du module complémentaire ACM, si vous prévoyez d' importer des clusters gérés après l'installation à l'aide de l'interface de ligne de commande(CLI), ou si vous prévoyez de mettre à jour ultérieurement les identifiants de connexion d'un cluster géré.

Si vous prévoyez d'importer des clusters gérés après l'installation à l'aide de la console Web OpenShift et que vous n'avez pas besoin de mettre à jour les identifiants de connexion ultérieurement, vous n'avez pas besoin de créer de secrets.

Pour chaque cluster que vous souhaitez gérer, suivez les étapes suivantes sur le cluster central.

1. Sur le cluster que vous souhaitez gérer avec ACM, exécutez la commande pour trouver le serveur URL. Dans le résultat, recherchez et notez la valeur du maître URL. Il s'agit du serveur URL à référencer dans le secret. Vous utiliserez également cette URL dans les étapes suivantes.

   ibmcloud oc cluster get -c CLUSTER_NAME_OR_ID
   

   Exemple de sortie.

   NAME:                           mycluster
   ID:                             1234567
   State:                          normal
   Created:                        2025-01-22T19:22:16+0000
   Location:                       dal10
   Master URL:                     https://c100-e.<region>.containers.cloud.ibm.com:<port>
   ...
   

2. Récupérer l' URL s de base du serveur OAuth de Red Hat OpenShift. Remplacez par MASTER_URL l' URL ion obtenue à l'étape précédente. La commande extrait l' URL de base sans le suffixe « /oauth/token ».

   curl -sS MASTER_URL/.well-known/oauth-authorization-server | jq -r .token_endpoint | sed 's#/oauth/token##'
   

   Exemple de sortie.

   https://c111-e.us-east.containers.cloud.ibm.com:31282
   

3. Récupérez un jeton d'accès à l'aide du point de terminaison obtenu à l'étape précédente.

   Exécutez la commande suivante : <CODE_INLINE> cURL </CODE_INLINE>, en remplaçant par URL la sortie de l'étape précédente et par API_KEY votre clé API <CODE_INLINE> IBM Cloud </CODE_INLINE >.

   Dans la réponse, recherchez le contenu ACCESS_TOKEN dans la réponse Location. Il s'agit du jeton d'accès à inclure dans le secret.

   Exemple de requête curl :

   curl -u 'apikey:API_KEY' -H "X-CSRF-Token: a" 'URL/oauth/authorize?client_id=openshift-challenging-client&response_type=token' -vvv
   

   Exemple de sortie. L'ACCESS_TOKEN est inclus dans la chaîne de réponse Location.

   < HTTP/1.1 302 Found
   < Cache-Control: no-cache, no-store, max-age=0, must-revalidate
   < Cache-Control: no-cache, no-store, max-age=0, must-revalidate
   < Expires: 0
   < Expires: Fri, 01 Jan 2030 00:00:00 GMT
   < Location: TOKEN_ENDPOINT/oauth/token/implicit#access_token=ACCESS_TOKEN&expires_in=86400&scope=user%3Afull&token_type=Bearer
   ...
   

4. Sur le cluster hub, créez un secret qui contient le jeton d'accès au cluster et le serveur URL. Pour plus d'informations sur la création de secrets, voir Working with secrets dans la documentation Kubernetes.

   Exemple de secret.

   apiVersion: v1
   kind: Secret
   metadata:
     name: SECRET_NAME
     namespace: SECRET_NAMESPACE  # The namespace that the secret is to be created in
   type: Opaque
   stringData:
     token: ACCESS_TOKEN
     server: SERVER_URL
   

Opérateurs de l'ACM

Passez en revue les opérateurs qui sont automatiquement installés par le module complémentaire ACM et les opérateurs optionnels que vous pouvez installer en tant qu'extensions.

Importation de clusters gérés après l'installation d'ACM

Une fois ACM installé, vous pouvez importer des clusters gérés à l'aide de la console Web d' OpenShift ou de l'interface de ligne de commande (CLI). Les méthodes basées sur la console ne nécessitent pas de secret. La méthode CLI nécessite un secret.

Tous les clusters gérés par ACM doivent appartenir à un ensemble de clusters. Vous pouvez créer un nouvel ensemble de clusters ou ajouter des clusters à l'ensemble de clusters Default. Si aucun ensemble de clusters n'est spécifié, les clusters gérés sont ajoutés à l'option Default.

Mise à jour ou suppression d'un cluster géré

Pour supprimer un cluster géré d’une instance ACM, ou pour mettre à jour les informations d’ URL de connexion d’ACM pour un cluster géré (par exemple, après une rotation de jeton ou un changement d’ de serveur), vous devez modifier la section managedClusters de la ressource personnalisée ACM sur le cluster hub. Cette action Update actualise les identifiants basés sur des secrets qu’ACM utilise pour communiquer avec un cluster géré. Cela ne correspond pas à la mise à niveau de la version OpenShift d'un cluster.

La mise à jour des identifiants de connexion d'un cluster géré nécessite le secret associé à ce cluster.

1. Exécutez la commande pour modifier la ressource ACM.

   oc edit acmhub RESOURCE_NAME
   

2. Dans la section managedClusters de la ressource, ajoutez l'ID du cluster, le nom du secret du cluster créé pour ACM, l'espace de noms pour le secret et l'action que vous voulez mettre en œuvre pour le cluster. Voir l'exemple ci-dessous pour la mise en forme. Pour l'action, indiquez ou Delete Update. Notez que pour supprimer un cluster, vous n'avez pas besoin du secret ou de l'espace de noms secret.

   L'exemple suivant supprime CLUSTER_ID_1 et met à jour CLUSTER_ID_2.

   managedclusters:
     - clusterid: "CLUSTER_ID_1"
       action: "Delete"
     - clusterid: "CLUSTER_ID_2"
       secretname: "SECRET_NAME"
       secretnamespace: "SECRET_NAMESPACE" # The namespace that the secret was created in
       action: "Update"
   

3. Sauvegardez et appliquez les modifications.

Mise à jour de la version de l'ACM

Exécutez la commande pour mettre à jour le module complémentaire vers une nouvelle version.

ibmcloud oc cluster addon update acm --cluster CLUSTER_ID --version ADD-ON_VERSION

Pour vérifier que le module complémentaire a été mis à jour, dressez la liste des modules complémentaires de votre cluster. Dans le résultat, recherchez les détails de l'extension ACM.

ibmcloud oc cluster addon ls --cluster CLUSTER_ID

Suppression du module complémentaire ACM

Suivez les étapes pour supprimer le module complémentaire ACM.

1. Supprimez la ressource ACM du cluster du concentrateur.

   oc delete acmhub RESOURCE_NAME
   

2. Une fois la ressource supprimée, supprimez le module complémentaire ACM. Indiquez le même ID de cluster.

   ibmcloud oc cluster addon disable acm -f --cluster CLUSTER_ID