Configurer un cluster privé dans Cloud Code pour VS Code

Un cluster privé est un cluster de cloud privé virtuel (VPC) natif qui ne dépend que des adresses IP internes. Cela signifie que les nœuds et les pods sont isolés d'Internet par défaut. Cette page explique comment utiliser Cloud Code pour se connecter à des clusters privés avec ou sans accès à un point de terminaison public, et comment autoriser les clusters privés à accéder aux ressources depuis l'extérieur Google Cloud.

Pour en savoir plus sur les clusters privés, consultez Clusters privés. Pour savoir comment configurer des clusters privés, consultez Créer un cluster privé.

Ajouter un cluster GKE privé à votre fichier KubeConfig

L'ajout d'un cluster privé dans Cloud Code présente le comportement suivant :

  • Pour les clusters dont le point de terminaison public est activé, l'ajout du cluster définit l'adresse du cluster dans le fichier KubeConfig sur l'adresse IP externe.

  • Pour les clusters dont le point de terminaison public est désactivé, l'ajout du cluster définit l'adresse du cluster dans le fichier KubeConfig sur l'adresse IP VPC interne du cluster.

Pour ajouter un réseau autorisé à un cluster existant, assurez-vous d'être connecté à un réseau autorisé, car ce cluster a activé les réseaux autorisés.

Pour en savoir plus sur la connexion à des VM sans adresse IP externe, consultez Se connecter en toute sécurité aux instances de VM. Pour gérer ou supprimer les instances que vous avez créées, consultez Instances de VM.

Pour se connecter au cluster privé, Cloud Code doit s'exécuter sur une machine du réseau du cluster ou être en mesure d'accéder au réseau du cluster, par exemple à l'aide d'un serveur proxy, de Cloud Interconnect ou de Cloud VPN.

Pour savoir comment créer des clusters GKE dans Cloud Code et ajouter des clusters GKE existants à Cloud Code, consultez Créer et configurer un cluster GKE. Cloud Code ouvre la console Google Cloud pour créer votre cluster.

Une fois le cluster créé, configurez Cloud NAT pour activer les connexions Internet sortantes depuis votre cluster si cela n'a pas été fait lors de la création du cluster. Pour gérer ou supprimer les réseaux que vous avez créés, consultez Réseaux VPC.

Résoudre les problèmes de connexion aux clusters privés

Si votre environnement de développement n'est pas configuré correctement pour accéder à un cluster privé, les recommandations de résolution du problème apparaissent dans les contextes suivants :

  • Dans la section Kubernetes développée, les clusters auxquels Cloud Code ne peut pas se connecter sont indiqués par une icône d'erreur à côté de leur nom. Pour afficher les solutions de contournement possibles et une explication plus détaillée du problème potentiel, cliquez sur le nom du cluster.

  • Lorsque vous essayez d'exécuter des opérations sur un cluster inaccessible en raison de problèmes potentiels liés à la configuration du cluster privé, une notification affiche un message d'erreur avec une explication plus détaillée du problème potentiel et des solutions de contournement possibles.

Configurer un serveur proxy pour un cluster

Si l'API du plan de contrôle n'est pas disponible publiquement, par exemple dans un cluster GKE avec un point de terminaison public désactivé, vous pouvez configurer Cloud Code pour qu'il envoie des requêtes par proxy au plan de contrôle via un serveur proxy sur le même réseau ou VPC que le cluster :

  1. Si vous ne l'avez pas déjà fait, configurez un serveur proxy sur le même réseau que votre cluster. Pour savoir comment configurer une VM Compute Engine en tant que serveur proxy de base, consultez Accéder à distance à un cluster privé à l'aide d'un hôte bastion. Pour en savoir plus, consultez Créer des clusters privés Google Kubernetes Engine avec des proxys réseau pour l'accès au contrôleur.
  2. Effectuez un clic droit sur le nom d'un cluster que vous avez ajouté à Cloud Code, puis cliquez sur Configurer le proxy Kubectl pour le cluster. Suivez les instructions pour saisir le nom de votre serveur proxy, qui est stocké dans le champ proxy-url du cluster. La vue Kubernetes se recharge pour afficher le cluster connecté.

Annuler le proxy Kubernetes

Effectuez un clic droit sur le nom d'un cluster que vous avez configuré pour le proxy Kubernetes, puis cliquez sur Annuler le proxy kubectl pour le cluster. Cloud Code arrête de transférer les requêtes pour le cluster en supprimant le champ proxy-url dans le fichier KubeConfig.

Accéder aux ressources en dehors de Google Cloud depuis les clusters

Toutes les configurations de clusters privés GKE ne fournissent pas d'accès à Internet aux nœuds. Par conséquent, les clusters ne peuvent pas accéder aux API sur l'Internet public. Les clusters sont automatiquement configurés avec l'accès privé à Google, ce qui leur permet, par exemple, d'extraire des images d'Artifact Registry. Les API et les registres d'images en dehors de Google Cloud sont inaccessibles sans configuration supplémentaire pour autoriser les connexions Internet sortantes depuis les nœuds. Pour fournir ces connexions, vous pouvez configurer Cloud NAT sur votre VPC à partir de Cloud Code :

  1. Exécutez la commande Accorder aux nœuds GKE privés un accès à Internet sortant en effectuant un clic droit sur un cluster ou à partir de la palette de commandes (appuyez sur Ctrl/Cmd+Shift+P ou cliquez sur Affichage > Palette de commandes).
  2. Dans le terminal, modifiez les commandes gcloud compute routers create et gcloud beta compute routers nats create pour spécifier les valeurs de votre application.
  3. Pour exécuter les commandes, appuyez sur Enter.
  4. Pour gérer ou supprimer les routeurs que vous avez créés, consultez Routeurs Cloud Router.

Étapes suivantes

Obtenir de l'aide

Pour envoyer des commentaires, posez une question sur Stack Overflow. Si vous êtes un client Google Cloud, vous pouvez envoyer des demandes via les canaux d'assistance Google Cloud standards.