12.2. Premiers pas avec les jeux de machines pour les plans de contrôle

1. Les clusters AWS mis à niveau vers la version 4.12 à partir d'une version antérieure nécessitent une activation CR.

Procédure

1. Affichez la configuration du CR en exécutant la commande suivante :

   $ oc --namespace openshift-machine-api edit controlplanemachineset.machine.openshift.io cluster

2. Modifiez les valeurs des champs qui ne correspondent pas à la configuration de votre cluster.

3. Lorsque la configuration est correcte, activez la CR en définissant le champ .spec.state sur Active et en enregistrant vos modifications.

   Important

   Pour activer la RC, vous devez remplacer le champ .spec.state par Active dans la même session oc edit que celle que vous utilisez pour mettre à jour la configuration de la RC. Si la RC est sauvegardée avec l'état Inactive, le générateur de jeux de machines du plan de contrôle réinitialise la RC à ses paramètres d'origine.

Procédure

1. Créez un fichier YAML en utilisant le modèle suivant :

   Modèle de fichier YAML du jeu de machines du plan de contrôle CR

   apiVersion: machine.openshift.io/v1
   kind: ControlPlaneMachineSet
   metadata:
     name: cluster
     namespace: openshift-machine-api
   spec:
     replicas: 3
     selector:
       matchLabels:
         machine.openshift.io/cluster-api-cluster: <cluster_id> 1
         machine.openshift.io/cluster-api-machine-role: master
         machine.openshift.io/cluster-api-machine-type: master
     state: Active 2
     strategy:
       type: RollingUpdate 3
     template:
       machineType: machines_v1beta1_machine_openshift_io
       machines_v1beta1_machine_openshift_io:
         failureDomains:
           platform: <platform> 4
           <platform_failure_domains> 5
         metadata:
           labels:
             machine.openshift.io/cluster-api-cluster: <cluster_id> 6
             machine.openshift.io/cluster-api-machine-role: master
             machine.openshift.io/cluster-api-machine-type: master
         spec:
           providerSpec:
             value:
               <platform_provider_spec> 7

   1

   Spécifiez l'ID d'infrastructure basé sur l'ID de cluster que vous avez défini lors du provisionnement du cluster. Vous devez spécifier cette valeur lorsque vous créez un CR ControlPlaneMachineSet. Si l'OpenShift CLI (oc) est installé, vous pouvez obtenir l'ID d'infrastructure en exécutant la commande suivante :

   $ oc get -o jsonpath='{.status.infrastructureName}{"\n"}' infrastructure cluster

   2

   Indiquer l'état de l'opérateur. Lorsque l'état est Inactive, l'opérateur n'est pas opérationnel. Vous pouvez activer l'opérateur en définissant la valeur Active.

   Important

   Avant d'activer le CR, vous devez vous assurer que sa configuration est adaptée aux besoins de votre cluster.

   3

   Spécifie la stratégie de mise à jour pour le cluster. Les valeurs autorisées sont OnDelete et RollingUpdate. La valeur par défaut est RollingUpdate.

   4

   Indiquez le nom de la plate-forme de votre fournisseur de cloud. Les valeurs autorisées sont AWS, Azure, et VSphere.

   5

   Ajoutez la configuration <platform_failure_domains> pour le cluster. Le format et les valeurs de cette section sont spécifiques au fournisseur. Pour plus d'informations, consultez l'exemple de configuration du domaine de défaillance de votre fournisseur de cloud.

   Note

   VMware vSphere ne prend pas en charge les domaines de défaillance. Pour les clusters vSphere, remplacez <platform_failure_domains> par un paramètre failureDomains: vide.

   6

   Spécifiez l'ID de l'infrastructure.

   7

   Ajoutez la configuration <platform_provider_spec> pour le cluster. Le format et les valeurs de cette section sont spécifiques au fournisseur. Pour plus d'informations, consultez l'exemple de spécification de votre fournisseur de cloud.

2. Reportez-vous à l'exemple de YAML pour un jeu de machines du plan de contrôle CR et complétez votre fichier avec des valeurs adaptées à la configuration de votre cluster.
3. Reportez-vous à l'exemple de configuration du domaine de défaillance et à l'exemple de spécification du fournisseur pour votre fournisseur de cloud et mettez à jour ces sections de votre fichier avec les valeurs appropriées.
4. Lorsque la configuration est correcte, activez la CR en définissant le champ .spec.state sur Active et en enregistrant vos modifications.

5. Créez le CR à partir de votre fichier YAML en exécutant la commande suivante :

   oc create -f <control_plane_machine_set>.yaml

   où <control_plane_machine_set> est le nom du fichier YAML qui contient la configuration du CR.