Migrer votre cluster associé à EKS

La version précédente des clusters associés à GKE est appelée "clusters associés à GKE (génération précédente)". La migration depuis la version antérieure des clusters associés à GKE vers la génération actuelle vous donne accès à cette fonctionnalité, y compris à la gestion du cycle de vie et à l'enregistrement du parc. La migration est une opération à sens unique : une fois que vous avez migré vers la génération actuelle des clusters associés à GKE, il n'est plus possible de revenir aux clusters associés à GKE (génération précédente).

Règle de numérotation de version

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.

Vérifier que Workload Identity est activé

Workload Identity doit être activé sur les clusters existants des clusters associés à GKE (génération précédente) avant leur migration vers la génération actuelle des clusters associés à GKE.

Pour déterminer si WI est activé, exécutez la commande suivante et vérifiez le résultat de n'importe quel champ Workload Identity :

gcloud container hub memberships describe MEMBERSHIP_NAME

Si Workload Identity n'est pas activé, l'appartenance doit être mise à jour pour l'activer.

Récupérez l'URL d'émetteur OIDC de votre cluster à l'aide de la commande suivante :
```
aws eks describe-cluster \
--region AWS_REGION \
--name 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.
Mettez à jour l'appartenance :
```
gcloud container fleet memberships register MEMBERSHIP_NAME \
--context=KUBECONFIG_CONTEXT \
--kubeconfig=KUBECONFIG_PATH \
--enable-workload-identity \
--public-issuer-url=OIDC_URL
```
Remplacez :
- MEMBERSHIP_NAME : nom d'appartenance de votre cluster
- KUBECONFIG_CONTEXT : contexte dans le fichier kubeconfig pour accéder au cluster EKS
- KUBECONFIG_PATH : chemin d'accès au fichier kubeconfig
- OIDC_URL : URL OIDC récupérée précédemment

Migrer votre cluster

Pour migrer votre cluster des clusters associés à GKE (génération précédente) vers les clusters associés à GKE :

Extrayez le contexte kubeconfig de votre cluster et stockez-le dans la variable d'environnement KUBECONFIG_CONTEXT :
```
KUBECONFIG_CONTEXT=$(kubectl config current-context)
```
Exécutez la commande suivante pour migrer votre cluster vers la génération actuelle des clusters associés à GKE. Cette commande extrait les informations pertinentes de la configuration de votre cluster, enregistre votre cluster auprès du service de gestion des parcs de Google, et installe ou met à niveau les logiciels nécessaires, tels que l'agent de cycle de vie, sur votre cluster.
```
gcloud container attached clusters import \
  --location=GOOGLE_CLOUD_REGION \
  --fleet-membership=FLEET_MEMBERSHIP \
  --platform-version=PLATFORM_VERSION \
  --distribution=CLUSTER_DISTRIBUTION \
  --context=KUBECONFIG_CONTEXT \
  [--kubeconfig=KUBECONFIG_PATH]
```
Remplacez :
- GOOGLE_CLOUD_REGION : emplacement Google Cloud à partir duquel votre cluster est administré.
- FLEET_MEMBERSHIP : indicateur d'appartenance complet de votre cluster enregistré (voir ci-dessous).
- PLATFORM_VERSION : version des clusters associés à GKE vers laquelle vous souhaitez migrer (exemple : v1.22.0-gke.1)
- CLUSTER_DISTRIBUTION : type de cluster (eks pour AWS Elastic Kubernetes Service, aks pour Azure Kubernetes Service ou generic pour toute autre distribution).
- KUBECONFIG_CONTEXT : nom du contexte dans votre fichier kubeconfig avec lequel se connecter au cluster.
- KUBECONFIG_PATH : emplacement de votre fichier kubeconfig. Si aucune valeur n'est spécifiée, la valeur par défaut est ~/.kube/config.
L'indicateur d'appartenance est une chaîne qui identifie de manière unique votre cluster associé et se présente sous la forme projects/PROJECT_NUMBER/locations/global/memberships/MEMBERSHIP_ID, où
- PROJECT_NUMBER est le numéro de votre projet hôte de parc. Vous devez spécifier le même numéro de projet que celui auquel votre cluster appartient actuellement.
- MEMBERSHIP_ID : doit correspondre à l'ID d'appartenance au parc de votre cluster existant. Les clusters associés à GKE utiliseront cette valeur comme nom du cluster.