2.4. Création d’un cluster de la Fédération d’identité de la charge de travail à l’aide de l’OCM CLI
Avec Workload Identity Federation (WIF), vous pouvez créer un cluster OpenShift Dedicated on Google Cloud Platform (GCP) à l’aide de l’OpenShift Cluster Manager CLI (ocm) en mode interactif ou non interactif.
Cliquez ici pour télécharger la dernière version de OpenShift Cluster Manager CLI (ocm) pour votre système d’exploitation à partir de la page Téléchargements sur OpenShift Cluster Manager.
L’interface de ligne de commande de l’API OpenShift Cluster Manager (ocm) est uniquement une fonctionnalité d’aperçu technologique. En savoir plus sur la portée du support des fonctionnalités de Red Hat Technology Preview, voir la portée du support des fonctionnalités d’aperçu de la technologie.
Avant de créer le cluster, vous devez d’abord créer une configuration WIF.
La migration d’un cluster non-WIF existant vers une configuration WIF n’est pas prise en charge. Cette fonctionnalité ne peut être activée que lors de la création de nouveaux clusters.
2.4.1. Création d’une configuration WIF Copier lienLien copié sur presse-papiers!
Procédure
Il est possible de créer une configuration WIF en utilisant le mode automatique ou le mode manuel.
Le mode automatique vous permet de créer automatiquement les comptes de service pour les composants OpenShift dédiés ainsi que d’autres ressources IAM.
Alternativement, vous pouvez utiliser le mode manuel. En mode manuel, vous disposez de commandes dans un fichier script.sh que vous utilisez pour créer manuellement les comptes de service pour les composants OpenShift dédiés ainsi que d’autres ressources IAM.
En fonction de votre préférence de mode, exécutez l’une des commandes suivantes pour créer une configuration WIF:
Créez une configuration WIF en mode automatique en exécutant la commande suivante:
ocm gcp create wif-config --name <wif_name> \ --project <gcp_project_id> \ --version <osd_version>
$ ocm gcp create wif-config --name <wif_name> \
1 --project <gcp_project_id> \
2 --version <osd_version>
3 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- <wif_name> par le nom de votre configuration WIF.
- 2
- Le remplacement par <gcp_project_id> l’ID du projet Google Cloud Platform (GCP) où la configuration WIF sera implémentée.
- 3
- Facultatif: Remplacer <osd_version> par la version OpenShift Dedicated souhaitée, le wif-config devra prendre en charge. Dans le cas où vous ne spécifiez pas une version, le wif-config prendra en charge la dernière version OpenShift Dedicated y-stream ainsi que les trois dernières versions OpenShift Dedicated y-stream prises en charge (en commençant par la version 4.17).
Exemple de sortie
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Créez une configuration WIF en mode manuel en exécutant la commande suivante:
ocm gcp create wif-config --name <wif_name> \ --project <gcp_project_id> \ --mode=manual
$ ocm gcp create wif-config --name <wif_name> \
1 --project <gcp_project_id> \
2 --mode=manual
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Lorsque le WIF est configuré, les comptes de service, les rôles et les groupes suivants sont créés.
Expand Tableau 2.1. Comptes de service de configuration WIF, groupe et rôles Compte/Groupe de service GCP rôles prédéfinis et rôles personnalisés Red Hat déploiement d’OSD
accueil > osd_deployer_v4.18
avion de contrôle OSD
- calcul.instanceAdmin
- calcul.networkAdmin
- calcul.securityAdmin
- calcul.storageAdmin
le travailleur de l’OSD
- calcul.storageAdmin
- calcul.viewer
cloud-credential-operator-gcp-ro-creds
cloud_credential_operator_gcp_ro_creds_v4
accueil > OpenShift-cloud-network-config-controller-gcp
accueil > Openshift_cloud_network_config_controller_gcp_v4
à propos de OpenShift-gcp-ccm
accueil Openshift_gcp_ccm_v4
exploitant OpenShift-gcp-pd-csi-driver
- calcul.storageAdmin
- IAM.serviceAccountUser
- gestionnaire de ressources.tagUser
- accueil > Openshift_gcp_pd_csi_driver_operator_v4
informations sur OpenShift-image-registry-gcp
accueil Openshift_image_registry_gcs_v4
caractéristiques OpenShift-ingress-gcp
accueil > Openshift_ingress_gcp_v4
caractéristiques OpenShift-machine-api-gcp
accueil > Openshift_machine_api_gcp_v4
Accès via SRE group:sd-sre-platform-gcp-access
accueil > Sre_managed_support
De plus amples détails sur les rôles de configuration WIF et leurs autorisations attribuées, voir Manag-cluster-config.
2.4.2. Création d’un cluster WIF Copier lienLien copié sur presse-papiers!
Procédure
Il est possible de créer un cluster WIF en utilisant le mode interactif ou le mode non interactif.
En mode interactif, les attributs de cluster s’affichent automatiquement sous forme d’invites lors de la création du cluster. Entrez les valeurs de ces instructions en fonction des exigences spécifiées dans les champs fournis.
En mode non interactif, vous spécifiez les valeurs de paramètres spécifiques dans la commande.
En fonction de votre préférence de mode, exécutez l’une des commandes suivantes pour créer un cluster OpenShift Dedicated on (GCP) avec configuration WIF:
Créez un cluster en mode interactif en exécutant la commande suivante:
ocm create cluster --interactive
$ ocm create cluster --interactive
1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- le mode interactif vous permet de spécifier les options de configuration dans les instructions interactives.
Créez un cluster en mode non interactif en exécutant la commande suivante:
NoteL’exemple suivant est constitué de paramètres facultatifs et requis et peut différer de votre commande en mode non interactif. Des paramètres non identifiés comme optionnels sont requis. Afin d’obtenir des détails supplémentaires sur ces paramètres et d’autres, exécutez la commande Ocm create cluster --help flag dans votre fenêtre terminale.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- <cluster_name> par un nom pour votre cluster.
- 2
- Définissez la valeur à gcp.
- 3
- Définissez la valeur à true.
- 4
- <wif_name> par le nom de votre configuration WIF.
- 5
- Le remplacement <gcp_region> par la région Google Cloud Platform (GCP) où le nouveau cluster sera déployé.
- 6
- Facultatif: Le modèle de facturation d’abonnement pour le cluster.
- 7
- Facultatif : Si vous avez fourni une valeur de market-gcp pour le paramètre de type abonnement, market-gcp-terms doit être égal à true.
- 8
- Facultatif: La version souhaitée OpenShift Dedicated.
- 9
- Facultatif: Déployez vers plusieurs centres de données.
- 10
- Facultatif: Activer l’autoscaling des nœuds de calcul.
- 11
- Facultatif: Nombre minimum de nœuds de calcul.
- 12
- Facultatif: Nombre maximal de nœuds de calcul.
- 13
- Facultatif : Le démarrage sécurisé permet l’utilisation de machines virtuelles protégées dans la plate-forme Google Cloud.
Lorsqu’une version dédiée à OpenShift est spécifiée, la version doit également être prise en charge par la configuration WIF assignée. Lorsqu’une version est spécifiée qui n’est pas prise en charge par la configuration WIF assignée, la création de cluster échouera. Dans ce cas, mettez à jour la configuration WIF assignée vers la version souhaitée ou créez une nouvelle configuration WIF avec la version souhaitée dans le champ --version <osd_version>.
2.4.3. Liste des clusters WIF Copier lienLien copié sur presse-papiers!
Afin de répertorier tous vos clusters dédiés OpenShift qui ont été déployés à l’aide du type d’authentification WIF, exécutez la commande suivante:
ocm list clusters --parameter search="gcp.authentication.wif_config_id != ''"
$ ocm list clusters --parameter search="gcp.authentication.wif_config_id != ''"
Afin de répertorier tous vos clusters dédiés OpenShift qui ont été déployés à l’aide d’une configuration wif-config spécifique, exécutez la commande suivante:
ocm list clusters --parameter search="gcp.authentication.wif_config_id = '<wif_config_id>'"
$ ocm list clusters --parameter search="gcp.authentication.wif_config_id = '<wif_config_id>'"
- 1
- <wif_config_id> par l’ID de la configuration WIF.
2.4.4. La mise à jour d’une configuration WIF Copier lienLien copié sur presse-papiers!
La mise à jour d’une configuration WIF n’est applicable qu’aux mises à jour du flux y. Afin d’obtenir un aperçu du processus de mise à jour, y compris des détails concernant la sémantique des versions, consultez The Ultimate Guide to OpenShift Release and Upgrade Process for Cluster Administrators.
Avant de mettre à niveau un cluster OpenShift dédié à WIF vers une version plus récente, vous devez également mettre à jour la configuration wif vers cette version. Lorsque vous ne mettez pas à jour la version wif-config avant de tenter de mettre à niveau la version du cluster, la mise à niveau de la version cluster échouera.
En exécutant la commande suivante, vous pouvez mettre à jour un wif-config vers une version spécifique d’OpenShift Dedicated:
ocm gcp update wif-config <wif_name> \ --version <version>
ocm gcp update wif-config <wif_name> \
--version <version>
- 1
- <wif_name> par le nom de la configuration WIF que vous souhaitez mettre à jour.
- 2
- Facultatif: Remplacer <version> par la version OpenShift Dedicated y-stream que vous prévoyez de mettre à jour le cluster vers. Dans le cas où vous ne spécifiez pas une version, la configuration wif-config sera mise à jour pour prendre en charge la dernière version OpenShift Dedicated y-stream ainsi que les trois dernières versions de Y-stream prises en charge par OpenShift Dedicated (en commençant par la version 4.17).
2.4.5. La vérification d’une configuration WIF Copier lienLien copié sur presse-papiers!
La configuration des ressources associées à une configuration WIF est correcte en exécutant la commande ocm gcp Vérifier wif-config. Lorsqu’une mauvaise configuration est trouvée, la sortie fournit des détails sur la mauvaise configuration et vous recommande de mettre à jour la configuration WIF.
Il vous faut le nom et l’identifiant de la configuration WIF que vous souhaitez vérifier avant la vérification. Afin d’obtenir le nom et l’ID de vos configurations WIF actives, exécutez la commande suivante:
ocm gcp list wif-configs
$ ocm gcp list wif-configs
Afin de déterminer si la configuration WIF que vous souhaitez vérifier est configurée correctement, exécutez la commande suivante:
ocm gcp verify wif-config <wif_config_name>|<wif_config_id>
$ ocm gcp verify wif-config <wif_config_name>|<wif_config_id>
- 1
- <wif_config_name> et <wif_config_id> par le nom et l’ID de votre configuration WIF, respectivement.
Exemple de sortie
Error: verification failed with error: missing role 'compute.storageAdmin'. Running 'ocm gcp update wif-config' may fix errors related to cloud resource misconfiguration. exit status 1.
Error: verification failed with error: missing role 'compute.storageAdmin'.
Running 'ocm gcp update wif-config' may fix errors related to cloud resource misconfiguration.
exit status 1.