Configurer un cluster d'utilisateur pour qu'il soit géré par l'API GKE On-Prem

L'API GKE On-Prem est une API hébergée par Google Cloud qui vous permet de gérer le cycle de vie de vos clusters sur site à l'aide d'outils standards : la console Google Cloud, Google Cloud CLI ou Terraform. Lorsque vous créez un cluster à l'aide de l'un de ces outils, l'API stocke les métadonnées sur l'état de votre cluster dans la région Google Cloud que vous avez spécifiée lors de la création du cluster. Ces métadonnées vous permettent de gérer le cycle de vie du cluster à l'aide des outils standards. Si vous souhaitez utiliser ces outils pour afficher les détails d'un cluster ou gérer le cycle de vie des clusters créés à l'aide de gkectl, vous devez inscrire les clusters dans l'API GKE On-Prem.

Terminologie

L'enregistrement d'un cluster vous permet de gérer son cycle de vie à l'aide de la console, de gcloud CLI ou de Terraform.

L'inscription d'un cluster est un processus distinct de l'enregistrement d'un cluster dans un parc. Un parc est un regroupement logique de clusters Kubernetes que vous pouvez gérer ensemble. Tous les clusters Google Distributed Cloud sont enregistrés dans une flotte au moment de leur création. Lorsque vous créez un cluster à l'aide de gkectl, il est enregistré dans le projet Google Cloud que vous spécifiez dans le champ gkeConnect.projectID du fichier de configuration du cluster. Ce projet est appelé projet hôte du parc. Pour en savoir plus sur les parcs, y compris sur les cas d'utilisation, les bonnes pratiques et obtenir des exemples, consultez la documentation sur la gestion de parc.

Afficher les clusters enregistrés

Tous vos clusters de parc s'affichent sur les pages Clusters GKE de la console. Vous obtenez ainsi une vue d'ensemble de votre parc et, pour Google Distributed Cloud, vous pouvez voir quels clusters sont gérés par l'API GKE On-Prem.

Pour afficher les clusters de votre parc, procédez comme suit :

1. Dans la console, accédez à la page Clusters GKE.
   Accéder aux clusters GKE
2. Sélectionnez le projet Google Cloud.
   • Si la valeur VMware s'affiche dans la colonne Type, le cluster est géré par l'API GKE On-Prem.
   • Si la valeur Externe s'affiche dans la colonne Type, cela signifie que le cluster n'est pas géré par l'API GKE On-Prem.

Conditions requises

• Les clusters d'utilisateur doivent être de la version 1.11 ou ultérieure.

• Les clusters d'administrateur doivent être à la version 1.13 ou ultérieure.

• Si vous n'êtes pas propriétaire du projet, vous devez disposer au minimum du rôle Identity and Access Management roles/gkeonprem.admin sur le projet. Pour en savoir plus sur les autorisations incluses dans ce rôle, consultez la section Rôles GKE On-Prem dans la documentation IAM.

Avant de commencer

1. Configurez gcloud CLI, si nécessaire.

   1. Si vous devez installer gcloud CLI, consultez la documentation de gcloud CLI.

   2. Mettez à jour les composants de gcloud CLI, si nécessaire :

      gcloud components update
      

2. Pour activer et utiliser l'API GKE On-Prem, procédez comme suit :

   1. Activez l'API dans votre projet :

      gcloud services enable \
          --project PROJECT_ID \
          gkeonprem.googleapis.com
      

      Remplacez PROJECT_ID par l'ID de votre projet hôte de parc. Il s'agit de l'ID de projet configuré dans la section gkeconnect de votre fichier de configuration de cluster d'administrateur ou de votre fichier de configuration de cluster d'utilisateur.

      Si une erreur PERMISSION_DENIED s'affiche, vérifiez l'ID de projet que vous avez saisi. Si l'ID du projet est correct, exécutez gcloud auth login pour vous connecter à Google Cloud CLI avec le compte ayant accès au projet.

   2. Si c'est la première fois que vous activez l'API GKE On-Prem dans votre projet, vous devez initialiser l'API. Pour ce faire, appelez une commande de la gcloud CLI qui affiche les versions disponibles que vous pouvez utiliser pour créer un cluster d'utilisateurs :

      gcloud container vmware clusters query-version-config \
          --project=PROJECT_ID \
          --location=REGION
      

      Remplacez REGION par us-west1 ou une autre région compatible.

3. Si votre organisation a configuré une liste d'autorisation qui permet au trafic des API Google et d'autres adresses de transiter par votre serveur proxy, ajoutez ce qui suit à la liste d'autorisation :

   • gkeonprem.googleapis.com
   • gkeonprem.mtls.googleapis.com

   Voici les noms de service de l'API GKE On-Prem.

Enregistrer un cluster d'utilisateur

gcloud container vmware clusters enroll USER_CLUSTER_NAME  \
  --project=PROJECT_ID \
  --admin-cluster-membership=projects/PROJECT_ID/locations/global/memberships/ADMIN_CLUSTER_NAME \
  --location=REGION

Enregistrer un cluster d'administrateur

gcloud container vmware admin-clusters enroll ADMIN_CLUSTER_NAME \
    --project=PROJECT_ID \
    --admin-cluster-membership=projects/PROJECT_ID/locations/global/memberships/ADMIN_CLUSTER_NAME \
    --location=REGION

Obtenir des informations sur votre cluster

Une fois le cluster enregistré, vous pouvez utiliser les commandes suivantes pour obtenir des informations sur vos clusters :

gcloud container vmware clusters describe USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION

gcloud container vmware clusters list \
  --project=PROJECT_ID \
  --location=-

gcloud container vmware admin-clusters describe ADMIN_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION

gcloud container vmware admin-clusters list \
  --project=PROJECT_ID \
  --location=-

Se connecter au cluster

Une fois le cluster enregistré auprès de l'API GKE On-Prem, vous devez choisir et configurer une méthode d'authentification pour pouvoir gérer le cluster à partir de la console Google Cloud. La méthode d'authentification que vous sélectionnez contrôle également l'accès au cluster à partir de la ligne de commande. Pour en savoir plus, consultez les ressources suivantes :

• Gérer des clusters depuis la console Google Cloud
• GKE Identity Service