Migration vers des grappes natives du réseau en nuage virtuel

Pour migrer une grappe existante afin d'intégrer son point d'extrémité d'API Kubernetes dans votre propre VCN :

1. Ouvrez le menu de navigation et sélectionnez Services de développement. Sous Conteneurs et artefacts, sélectionnez Grappes Kubernetes (OKE).

2. Sélectionnez un compartiment que vous êtes autorisé à utiliser.

   Les étiquettes Migration requise apparaissent dans la page Liste de grappes à côté des noms des grappes avec des points d'extrémité d'API Kubernetes qui ne sont pas intégrés à votre VCN.

3. Dans la page Liste de regroupements, sélectionnez le nom de la grappe à migrer.

   Lorsque vous sélectionnez une grappe que vous pouvez migrer, le bouton Migrer la grappe s'affiche en haut de la page Détails de la grappe.

4. Si vous voulez que le point d'extrémité de l'API Kubernetes de la grappe soit accessible publiquement à partir d'Internet et hébergé dans un nouveau sous-réseau public dans le même VCN que la grappe (création et configuration de nouvelles ressources de réseau selon les besoins), effectuez une migration automatique comme suit :
   1. En haut de la page Détails de la grappe, sélectionnez Migrer la grappe pour intégrer le point d'extrémité de l'API Kubernetes de la grappe dans votre propre VCN.
   2. Dans la boîte de dialogue Migrer vers une grappe native du réseau en nuage virtuel (VCN), sélectionnez Migration automatique pour créer un nouveau sous-réseau régional dans le VCN de la grappe avec un bloc CIDR 10.0.0.0/28, ainsi que des listes de sécurité et des tables de routage.
   3. Sélectionnez Lancer le flux de travail et vérifiez le sommaire de migration dans la boîte de dialogue Migration de grappe de points d'extrémité natifs de VCN.
   4. Sélectionnez Migrer pour créer de nouvelles ressources de réseau et migrer la grappe.

      Kubernetes Engine commence la migration de la grappe, comme illustré dans la boîte de dialogue Migration de grappe.

   5. Sélectionnez Fermer pour fermer la boîte de dialogue Migration de grappe.
5. Si vous voulez que le point d'extrémité de l'API Kubernetes de la grappe soit accessible en privé dans votre VCN ou accessible publiquement à partir d'Internet, et hébergé dans un sous-réseau public ou privé régional existant dans le même VCN que la grappe, effectuez une migration personnalisée comme suit :
   1. Vérifiez que les ressources de réseau suivantes existent déjà dans le VCN et qu'elles sont configurées correctement pour héberger le point d'extrémité de l'API Kubernetes (si ce n'est pas le cas, créez-les et configurez-les de manière appropriée) :
      • un sous-réseau public ou privé régional (voir Configuration du sous-réseau du point d'extrémité de l'API Kubernetes)
      • si le sous-réseau est public, une passerelle Internet (voir Configuration d'une passerelle Internet)
      • si le sous-réseau est privé, une passerelle NAT (voir Configuration d'une passerelle NAT) et une passerelle de service (voir Configuration d'une passerelle de service)
      • une table de routage avec les règles de routage nécessaires (voir Table de routage pour les sous-réseaux de point d'extrémité d'API Kubernetes)
      • un groupe de sécurité de réseau (recommandé) ou une liste de sécurité avec les règles de trafic entrant et sortant nécessaires (voir Règles de sécurité pour le point d'extrémité de l'API Kubernetes)

      Par exemple, des configurations, voir Exemples de configurations de ressources de réseau.

   2. En haut de la page Détails de la grappe, sélectionnez Migrer la grappe pour intégrer le point d'extrémité de l'API Kubernetes de la grappe dans votre propre VCN.
   3. Dans la boîte de dialogue Migrer vers une grappe native du réseau en nuage virtuel (VCN), sélectionnez Migration personnalisée.
   4. Sélectionnez Lancer le flux de travail et spécifiez :
      • Sous-réseau de point d'extrémité d'API Kubernetes : Sous-réseau régional qui héberge le point d'extrémité de l'API Kubernetes de la grappe. Le sous-réseau que vous spécifiez peut être public ou privé. Une adresse IP privée est toujours affectée au point d'extrémité de l'API Kubernetes. Si vous spécifiez un sous-réseau public, vous pouvez éventuellement exposer le point d'extrémité de l'API Kubernetes à Internet en affectant une adresse IP publique au point d'extrémité (ainsi que l'adresse IP privée). Pour simplifier la gestion des accès, Oracle recommande que le point d'extrémité de l'API Kubernetes se trouve dans un sous-réseau différent des noeuds de travail et des équilibreurs de charge. Pour plus d'informations, voir Plan de contrôle de grappe Kubernetes et API Kubernetes.
      • Utiliser les groupes de sécurité de réseau pour contrôler le trafic : Facultativement, limitez l'accès au point d'extrémité de l'API Kubernetes de la grappe à l'aide d'un ou plusieurs groupes de sécurité de réseau que vous spécifiez. Pour plus d'informations sur les règles de sécurité à spécifier pour le groupe de sécurité de réseau, voir Règles de sécurité pour le point d'extrémité de l'API Kubernetes.
      • Affecter une adresse IP publique au point d'extrémité d'API : Si vous avez sélectionné un sous-réseau public pour le point d'extrémité de l'API Kubernetes, vous pouvez éventuellement exposer le point d'extrémité à Internet en affectant une adresse IP publique au point d'extrémité (ainsi qu'une adresse IP privée). Si vous n'affectez pas d'adresse IP publique, mettez à jour les règles de routage et les règles de sécurité pour permettre l'accès au point d'extrémité à l'aide d'une passerelle de service et d'une passerelle NAT (voir Configuration du sous-réseau du point d'extrémité de l'API Kubernetes).
   5. Sélectionnez Migrer pour créer de nouvelles ressources de réseau et migrer la grappe.

      Le moteur Kubernetes commence la migration de la grappe.

La migration prend généralement environ 15 minutes. Pendant ce temps, l'API Kubernetes continue d'être accessible au moyen du point d'extrémité public qui n'est pas intégré à votre propre VCN. Toutefois, les opérations de cycle de vie de grappe (telles que les mises à jour de grappe, la création et la suppression de groupes de noeuds) ne sont pas disponibles.

Une fois la migration terminée, la page Détails de la grappe affiche le nom du sous-réseau de point d'extrémité de l'API Kubernetes, l'adresse IP du point d'extrémité privé de l'API Kubernetes et (si vous avez affecté une adresse IP publique au point d'extrémité de l'API Kubernetes) l'adresse IP du point d'extrémité public de l'API Kubernetes.

La page Détails de la grappe indique également que vous disposez de 30 jours pour mettre à jour la configuration de vos pipelines kubectl, outils et intégration et développement en continu afin d'accéder au nouveau point d'extrémité d'API Kubernetes (voir Configuration de l'accès à une grappe migrée). Pendant cette période de mise hors service, la grappe nouvellement migrée est accessible au moyen du nouveau point d'extrémité d'API Kubernetes dans votre VCN et au moyen du point d'extrémité d'API Kubernetes public qui n'est pas intégré à votre propre VCN.

Après avoir migré une grappe pour intégrer son point d'extrémité d'API Kubernetes dans votre propre VCN, vous devez mettre à jour la configuration de vos kubectl, outils et pipelines d'intégration et de développement en continu pour utiliser le nouveau point d'extrémité d'API Kubernetes. Au minimum, vous voulez mettre à jour le fichier de configuration Kubernetes de la grappe (communément appelé fichier 'kubeconfig') pour permettre l'accès à la grappe migrée à l'aide de kubectl, comme décrit dans cette rubrique. Vous devez également mettre à jour tous les fichiers manifestes qui incluent des références à l'adresse IP du point d'extrémité de l'API Kubernetes de la grappe.

Suivez les instructions de cette rubrique pour générer un nouveau fichier kubeconfig. Ces instructions supposent que le fichier kubeconfig de la grappe est enregistré à l'emplacement par défaut ($HOME/.kube) et avec le nom par défaut (config). Si ce n'est pas le cas, adaptez les instructions en conséquence.

1. Dans la fenêtre de terminal où vous exécutez normalement les commandes de l'interface de ligne de commande Oracle Cloud Infrastructure, exécutez la commande suivante pour mettre à jour le fichier kubeconfig existant de la grappe :

   oci ce cluster create-kubeconfig --cluster-id <cluster-ocid> --file <kubeconfig-file-location> --region <region-name> --token-version 2.0.0 --kube-endpoint PRIVATE_ENDPOINT|PUBLIC_ENDPOINT

   où :

   • --cluster-id <cluster-ocid> est l'OCID de la grappe existante que vous voulez rendre native pour le VCN.
   • --file <kubeconfig-file-location> est l'emplacement du fichier kubeconfig de la grappe.
   • --region <region-name> est la région dans laquelle se trouve la grappe.
   • --kube-endpoint PRIVATE_ENDPOINT|PUBLIC_ENDPOINT indique si l'adresse IP privée ou l'adresse IP publique du point d'extrémité de l'API Kubernetes de la grappe doit être ajoutée au fichier kubeconfig. Pour plus d'informations, voir Plan de contrôle de grappe Kubernetes et API Kubernetes.

   Par exemple :

   oci ce cluster create-kubeconfig --cluster-id ocid1.cluster.oc1.phx.aaaaaaaaae... --file $HOME/.kube/config --region us-phoenix-1 --token-version 2.0.0 --kube-endpoint PUBLIC_ENDPOINT

   En supposant que le fichier kubeconfig existe déjà à l'emplacement spécifié, les détails de la grappe sont ajoutés en tant que nouveau contexte au fichier kubeconfig existant, y compris le nouveau point d'extrémité de l'API Kubernetes de la grappe dans votre propre VCN. L'élément current-context: du fichier kubeconfig est défini de manière à pointer vers le contexte qui vient d'être ajouté.

   Pour plus d'informations sur la configuration du fichier kubeconfig, voir Configuration de l'accès aux grappes.

2. Vérifiez que kubectl peut se connecter à la grappe à l'aide du point d'extrémité de l'API Kubernetes dans votre propre VCN en entrant la commande suivante :

   kubectl get nodes

   Les informations sur les noeuds de la grappe s'affichent.

   Vous pouvez maintenant utiliser kubectl pour effectuer des opérations sur la grappe à l'aide du point d'extrémité de l'API Kubernetes dans votre propre VCN.