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.
En el caso de los clústeres que tienen el extremo público desactivado, agregar el clúster establece 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 conectarse 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 lo configuró durante la 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 pueden conectar aparecen con un ícono de error junto a su nombre. Para ver posibles soluciones alternativas 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 deseas 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 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 de un clúster que
hayas agregado a Cloud Code y, luego, haz clic en
Configurar Kubectl Proxying para 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 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 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 Otorga acceso a Internet saliente a los nodos privados de GKE haciendo 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 información sobre las redes de nube privada virtual compartidas.