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 tu 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.
En el caso de los clústeres que tienen el extremo público desactivado, agregar el clúster establece la dirección del clúster en KubeConfig como 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 la conexión a VM 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 conocer los pasos para crear clústeres de GKE en Cloud Code y agregar clústeres de GKE existentes a Cloud Code, consulta Crea y configura 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 su creación. 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 la sección expandida de Kubernetes, los clústeres a los que Cloud Code no se puede conectar aparecen con un ícono de error junto al nombre del clúster. Para ver las posibles soluciones y una explicación más larga 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:
- Configura un servidor proxy en la misma red de tu clúster si aún no lo hiciste. Si quieres conocer los pasos para configurar una VM de Compute Engine como un servidor proxy básico, consulta Accede de forma remota a un clúster privado mediante un host de bastión. Si quieres obtener más detalles, consulta Crea clústeres privados de Google Kubernetes Engine con proxies de red para acceder al controlador.
- Haz clic con el botón derecho en el nombre del clúster que agregaste a Cloud Code y, luego, haz clic en Configurar el proxy de Kubectl para el clúster. Sigue las indicaciones para ingresar el nombre de tu servidor proxy, que se almacena en el campo
proxy-urldel clúster. La vista de Kubernetes se vuelve a cargar para mostrar el clúster conectado.
Cancelar proxy de Kubernetes
Haz clic con el botón derecho en el nombre del clúster que configuraste para el proxy de Kubernetes y, luego, haz clic en Cancel 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:
- Ejecuta el comando Otorgar acceso a Internet saliente a los nodos privados de GKE. Para ello, haz clic con el botón derecho en un clúster o desde la paleta de comandos (presiona
Ctrl/Cmd+Shift+Po haz clic en Ver > Paleta de comandos). - En la terminal, edita los comandos
gcloud compute routers createygcloud beta compute routers nats createa fin de especificar los valores para tu aplicación. - Para ejecutar los comandos, presiona
Enter. - Para administrar o borrar los routers que creaste, consulta Cloud Routers.
¿Qué sigue?
- Obtén más información sobre las redes de nube privada virtual compartidas.