Configura un clúster privado en Cloud Code para Cloud Shell

Un clúster privado es un clúster nativo de la nube privada virtual (VPC) que solo depende de direcciones IP internas. Esto significa que los nodos y los Pods están aislados de Internet de forma predeterminada. En esta página, se explica cómo usar Cloud Code para conectarse a clústeres privados con y sin acceso a extremos públicos, y permitir que los clústeres privados accedan a recursos desde fuera de Google Cloud.

Para obtener información sobre los clústeres privados, consulta Clústeres privados. Si deseas conocer los pasos para configurar clústeres privados, consulta Crea un clúster privado.

Agrega un clúster de GKE privado a KubeConfig

Ten en cuenta los siguientes enunciados cuando agregas un clúster privado a Cloud Code:

  • En los clústeres que tienen el extremo público habilitado, cuando agregas un clúster, se establece la dirección del clúster en KubeConfig a la IP externa.

  • Agregar los conjuntos de clústeres para los clústeres que tienen desactivado el extremo público que la dirección del clúster en KubeConfig sea la IP de VPC interna del clúster.

Para agregar una red autorizada a un clúster existente, asegúrate de estar conectado a una red autorizada, ya que este clúster tiene redes autorizadas habilitadas.

Si necesitas más información para conectarte a VMs sin direcciones IP externas, consulta Conéctate a instancias de VM de forma segura. Para administrar o borrar las instancias que creaste, consulta Instancias de VM.

Para conectarse correctamente al clúster privado, Cloud Code se debe ejecutar en una máquina en la red del clúster o debe poder acceder a la red del clúster, por ejemplo, mediante un servidor proxy, Cloud Interconnect, o Cloud VPN.

Si quieres obtener los pasos para crear clústeres de GKE en Cloud Code y agregar clústeres de GKE existentes a Cloud Code, consulta Cómo crear y configurar un clúster de GKE. Cloud Code abre la consola de Google Cloud para crear tu clúster.

Después de crear el clúster, configura Cloud NAT para habilitar las conexiones a Internet salientes desde tu clúster si no se configuró durante la creación del clúster. Para administrar o borrar las redes que creaste, consulta Redes de VPC.

Soluciona problemas de conexión a clústeres privados

Si tu entorno de desarrollo no está configurado correctamente para acceder a un clúster privado, las recomendaciones sobre cómo resolver el problema aparecen en los siguientes contextos:

  • En el Kubernetes Explorer expandido, los clústeres que Cloud Code no se puede conectar para aparecer con un ícono de error junto al el nombre del clúster. Para ver las posibles soluciones y una explicación más detallada del problema potencial, haz clic en el nombre del clúster.

  • Cuando intentas ejecutar operaciones en un clúster al que no se puede acceder debido a posibles problemas con la configuración del clúster privado, aparece una notificación de mensaje de error con una explicación más detallada del problema potencial y las posibles soluciones.

Configura un servidor proxy para un clúster

Si la API del plano de control no está disponible públicamente, como en un clúster de GKE con un extremo público desactivado, puedes configurar Cloud Code para enviar solicitudes proxy al plano de control a través de un servidor proxy en la misma red o VPC que el clúster:

  1. Configura un servidor proxy en la misma red de tu clúster si aún no lo hiciste. Pasos para configurar una VM de Compute Engine como proxy básico consulta Accede de forma remota a un clúster privado con un host de bastión. Para obtener más detalles, consulta Cómo crear clústeres privados de Google Kubernetes Engine con proxies de red para acceder a los controladores.
  2. Haz clic con el botón derecho en el nombre de un clúster que agregaste a Cloud Code y, luego, en Set up Kubectl Proxying for cluster. Sigue las indicaciones para ingresar el nombre de tu servidor proxy, que se almacena en el campo proxy-url del clúster. La vista de Kubernetes se volverá a cargar para mostrar el clúster conectado.

Cancelar el proxy de Kubernetes

Haz clic con el botón derecho en el nombre de un clúster que hayas configurado para el proxy de Kubernetes y Luego, haz clic en Cancelar Kubectl Proxying for cluster. Cloud Code deja de configurar solicitudes de proxy para el clúster mediante la desconfiguración del campo proxy-url en KubeConfig.

Accede a recursos fuera de Google Cloud desde clústeres

Todas las configuraciones de los clústeres privados de GKE no proporcionan acceso a Internet a los nodos. Como resultado, los clústeres no pueden acceder a las API en Internet pública. Los clústeres se configuran de forma automática con el Acceso privado a Google, que, por ejemplo, permite que los clústeres extraigan imágenes de Artifact Registry o Container Registry. No se puede acceder a las API ni a los registros de imágenes fuera de Google Cloud sin una configuración adicional que admita conexiones salientes a Internet desde los nodos. Para proporcionar estas conexiones, puedes configurar Cloud NAT en tu VPC desde Cloud Code:

  1. Ejecuta el siguiente comando Otorga acceso a Internet saliente a los nodos privados de GKE, ya sea haciendo clic derecho en un clúster o desde la paleta de comandos (presiona Ctrl/Cmd+Shift+P o haz clic en Ver > Paleta de comandos).
  2. En la terminal, edita los comandos gcloud compute routers create y gcloud beta compute routers nats create a fin de especificar los valores para tu aplicación.
  3. Para ejecutar los comandos, presiona Enter.
  4. Para administrar o borrar los routers que creaste, consulta Cloud Routers.

¿Qué sigue?