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.
Para obtener más información sobre cómo 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 explorador de Kubernetes, los clústeres que Cloud Code no puede conectar para aparecer con un ícono de error junto al 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. Para ver el mensaje de error, mantén el puntero sobre un clúster con un ícono de error.
Para ver los documentos de clústeres privados, haz clic con el botón derecho en un clúster y selecciona Ver configuración privada Documentos de clústeres
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:
- 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.
- Haz clic con el botón derecho en el nombre del clúster
agregado a Cloud Code y, luego, haz clic
Configura el proxy de Kubectl. Sigue las indicaciones para ingresar el nombre de tu servidor proxy, que se almacena en el campo
proxy-urldel clúster. Kubernetes Explorer se volverá a cargar para mostrar el clúster conectado.
Cancela el proxy de Kubernetes
Haz clic con el botón derecho en el nombre de un clúster que configuraste para el proxy de Kubernetes y, luego, haz clic en Cancel Kubectl Proxying. 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:
- En Kubernetes Explorer, haz clic con el botón derecho en un clúster y selecciona Otorgar acceso a Internet privado de GKE.
- En la terminal, edita los comandos
gcloud compute routers createygcloud beta compute routers nats createa fin de especificar los valores para tu aplicación. Asegúrate de elegir el{REGION}en el que se encuentra el clúster privado. Para obtener una lista de las regiones admitidas, consulta Regiones y zonas. - Para ejecutar los comandos, presiona
Enter. - Para administrar o borrar los routers que creaste, consulta Cloud Routers.
¿Qué sigue?
- Más información sobre Redes de nube privada virtual compartidas.