Associer votre cluster EKS.

Présentation

Associer un cluster signifie le connecter à Google Cloud en l'enregistrant avec laGoogle Cloud gestion de parc et en y installant le logiciel des clusters associés à GKE.

Vous pouvez associer un cluster à l'aide de gcloud CLI ou de Terraform. Pour apprendre comment créer et associer un cluster EKS à l'aide de Terraform, consultez le dépôt GitHub d'exemples pour les clusters associés à GKE

Cette page s'adresse aux administrateurs et opérateurs informatiques qui souhaitent configurer, surveiller et gérer l'infrastructure cloud. Pour en savoir plus sur les rôles courants et les exemples de tâches que nous citons dans le contenu Google Cloud , consultez Rôles utilisateur et tâches courantes de GKE.

Pour associer un cluster EKS à l'aide de gcloud, procédez comme suit.

Prérequis

Vérifiez que votre cluster répond aux exigences de cluster.

Lorsque vous associez votre cluster, vous devez spécifier les éléments suivants :

• Une région administrative Google Cloud compatible
• Une version de la plate-forme

La région administrative est une région Google Cloud à partir de laquelle vous souhaitez administrer le cluster associé. Vous pouvez choisir n'importe quelle région compatible, mais il est recommandé de choisir la région la plus proche de votre cluster. Aucune donnée utilisateur n'est stockée dans la région administrative.

La version de la plate-forme est la version des clusters associés à GKE à installer sur votre cluster. Vous pouvez lister toutes les versions compatibles en exécutant la commande suivante :

gcloud container attached get-server-config  \
  --location=GOOGLE_CLOUD_REGION

Remplacez GOOGLE_CLOUD_REGION par le nom de l'emplacementGoogle Cloud à partir duquel administrer votre cluster.

Numérotation des versions de la plate-forme

Dans ces documents, la version des clusters associés à GKE est nommée la "version de la plate-forme" pour la distinguer de la version de Kubernetes. Les clusters associés à GKE utilisent la même convention de numérotation de version que GKE (par exemple, 1.21.5-gke.1). Lorsque vous associez ou mettez à jour votre cluster, vous devez choisir une version de plate-forme dont la version mineure est identique ou inférieure d'un niveau à la version Kubernetes de votre cluster. Par exemple, vous pouvez associer un cluster exécutant Kubernetes v1.22.* à la version de plate-forme v1.21.* ou v1.22.* des clusters associés à GKE.

Cela vous permet de passer à la version mineure suivante avant de mettre à niveau les clusters associés à GKE.

Associer un cluster EKS

Remarque : Par défaut, vous pouvez associer jusqu'à 50 clusters par projet. Pour augmenter ce quota, contactez l'assistanceGoogle Cloud .

Pour associer votre cluster EKS à la gestion de parc Google Cloud, procédez comme suit :

1. Assurez-vous que votre fichier kubeconfig contient une entrée correspondant au cluster que vous souhaitez associer :

   aws eks update-kubeconfig --region AWS_REGION \
     --name EKS_CLUSTER_NAME
   

2. Récupérez l'URL d'émetteur OIDC à l'aide de la commande suivante :

   aws eks describe-cluster \
     --region AWS_REGION \
     --name EKS_CLUSTER_NAME \
     --query "cluster.identity.oidc.issuer" \
     --output text
   

   Cette commande génère l'URL de votre émetteur OIDC. Enregistrez cette valeur pour une utilisation ultérieure.

3. Exécutez la commande suivante pour extraire le contexte kubeconfig de votre cluster et le stocker dans la variable d'environnement KUBECONFIG_CONTEXT :

   KUBECONFIG_CONTEXT=$(kubectl config current-context)
   

4. Utilisez la commande gcloud container attached clusters register pour enregistrer le cluster :

   gcloud container attached clusters register CLUSTER_NAME \
     --location=GOOGLE_CLOUD_REGION \
     --fleet-project=PROJECT_NUMBER \
     --platform-version=PLATFORM_VERSION \
     --distribution=eks \
     --issuer-url=ISSUER_URL \
     --context=KUBECONFIG_CONTEXT \
     --kubeconfig=KUBECONFIG_PATH
   

   Remplacez :

• AWS_REGION : région AWS dans laquelle se trouve votre cluster EKS
• CLUSTER_NAME : nom du cluster Ce nom peut être le même EKS_CLUSTER_NAME que celui que vous avez utilisé lors des étapes précédentes. CLUSTER_NAME doit être conforme à la norme RFC 1123 pour les noms de libellés.
• GOOGLE_CLOUD_REGION : région Google Cloud dans laquelle administrer votre cluster
• PLATFORM_VERSION : version des clusters associés à GKE à utiliser pour le cluster
• PROJECT_NUMBER : projet hôte du parc dans lequel le cluster sera enregistré
• ISSUER_URL : URL de l'émetteur récupérée précédemment
• KUBECONFIG_CONTEXT : contexte dans le fichier kubeconfig pour accéder au cluster EKS, tel qu'extrait précédemment

• KUBECONFIG_PATH : chemin d'accès à votre fichier kubeconfig

  Remarque : Si l'association de votre cluster échoue, le système annule automatiquement toutes les modifications apportées aux ressources Google Cloud associées au cluster, comme le pool d'identités de charge de travail. Cela signifie que la connexion entre votre cluster et les clusters GKE associés n'est pas établie, mais que votre cluster EKS réel n'est pas affecté. Vous pouvez réessayer d'associer le cluster après avoir corrigé le problème à l'origine de la défaillance.

Autoriser Cloud Logging/Cloud Monitoring

Remarque : À partir de la version 1.28 de Kubernetes, la liaison manuelle des règles pour autoriser le compte de service gke-system/gke-telemetry-agent à collecter les journaux et les métriques n'est plus nécessaire. Les autorisations requises sont automatiquement accordées à ce compte de service. Vous pouvez donc ignorer cette section.

Pour que les clusters associés GKE puissent créer et importer des journaux système et des métriques dansGoogle Cloud, ils doivent être autorisés.

Pour autoriser l'identité de charge de travail Kubernetes gke-system/gke-telemetry-agent à écrire des journaux dans Google Cloud Logging et des métriques dans Google Cloud Monitoring, exécutez la commande suivante :

gcloud projects add-iam-policy-binding GOOGLE_PROJECT_ID \
  --member="serviceAccount:GOOGLE_PROJECT_ID.svc.id.goog[gke-system/gke-telemetry-agent]" \
  --role=roles/gkemulticloud.telemetryWriter

Remplacez GOOGLE_PROJECT_ID par l'ID de projet du cluster. Google Cloud

Cette liaison IAM permet à tous les clusters du projet Google Cloud d'importer des journaux et des métriques. Vous ne devez l'exécuter qu'après avoir créé votre premier cluster pour le projet.

L'ajout de cette liaison IAM échouera si vous n'avez pas créé au moins un cluster dans votre projet Google Cloud . En effet, le pool d'identités de charge de travail auquel il fait référence (GOOGLE_PROJECT_ID.svc.id.goog) n'est pas provisionné avant la création du cluster.