Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

Creando un clúster GKE

Requisitos previos

Se requiere configuración en Google Kubernetes Engine.

Token de cuenta de servicio

Crea una cuenta de servicio utilizando Google Kubernetes Engine. GKE utiliza esta cuenta para operar tu clúster. Crear esta cuenta también genera una clave privada utilizada para la autenticación.

La cuenta de servicio requiere los siguientes roles:

  • Visor de Computación: roles/compute.viewer

  • Visor de Proyecto: roles/viewer

  • Administrador de Kubernetes Engine: roles/container.admin

  • Usuario de Cuenta de Servicio: roles/iam.serviceAccountUser

Documentación de Google: Creación y Habilitación de Cuentas de Servicio

Para obtener ayuda para obtener una clave privada para tu cuenta de servicio, consulta la documentación de Google Cloud aquí. Necesitarás guardar la clave en formato JSON.

Google Project ID

Tu clúster deberá formar parte de un Proyecto de Google.

Para crear un nuevo proyecto, consulta la documentación de Google Cloud aquí.

Para obtener el ID del proyecto de un proyecto existente, consulta la documentación de Google Cloud aquí.

Provisionamiento de un Clúster GKE

Desplegar en GKE generará cargos.

1. Crear una Credencial de Nube

  1. Haz clic en ☰ > Gestión de Clústeres.

  2. En la barra de navegación izquierda, haz clic en Credenciales de Nube.

  3. Haga clic en Crear.

  4. Introduce un nombre para tus credenciales de Google Cloud.

  5. En el cuadro de texto Cuenta de Servicio, pega tu clave privada JSON de la cuenta de servicio o sube el archivo JSON.

  6. Haga clic en Crear.

Resultado: Has creado credenciales que Rancher utilizará para provisionar el nuevo clúster GKE.

2. Crear el Clúster GKE

Utiliza Rancher para instalar y configurar tu clúster de Kubernetes. Para crear con éxito un clúster GKE con Rancher, tu GKE debe estar en modo Estándar. GKE tiene dos modos de operación al crear un clúster de Kubernetes, Modo Autopilot y Modo Estándar. La configuración del clúster para el modo Autopilot tiene restricciones sobre la edición del espacio de nombres kube-system. Sin embargo, Rancher necesita crear recursos en el espacio de nombres kube-system durante la instalación. Como resultado, no podrás crear un clúster GKE en modo Autopilot. Para más información sobre la diferencia entre el modo Autopilot de GKE y el modo Estándar, visita Compara GKE Autopilot y Estándar.

  1. Haz clic en ☰ > Gestión de Clústeres.

  2. En la página Clústeres, haz clic en Crear.

  3. Click Google GKE.

  4. Introduce un Nombre del Clúster.

  5. Opcional: Utiliza Roles de Miembros para configurar la autorización de usuarios para el clúster. Haz clic en Añadir Miembro para añadir usuarios que puedan acceder al clúster. Utiliza el menú desplegable Rol para establecer permisos para cada usuario.

  6. Opcional: Añade etiquetas o anotaciones de Kubernetes al clúster.

  7. Introduce tu ID de proyecto de Google y tus credenciales de Google Cloud.

  8. Completa el resto del formulario. Para obtener ayuda, consulta la referencia de configuración del clúster GKE.

  9. Haga clic en Crear.

Resultado: Has desplegado con éxito un clúster GKE.

Tu clúster se ha creado y se le ha asignado un estado de Provisionando. Rancher está configurando tu clúster.

Puedes acceder a tu clúster después de que su estado se actualice a Activo.

Los clústeres Activos están asignados a dos Proyectos:

  • Default, que contiene el espacio de nombres default

  • System, que contiene los espacios de nombres cattle-system, traefik, kube-public y kube-system

Clústeres privados

Se admiten clústeres GKE privados. Nota: Esta configuración avanzada puede requerir más pasos durante el proceso de provisionamiento del clúster. Para más detalles, consulta esta sección.

Referencia de configuración

Para detalles sobre la configuración de clústeres GKE en Rancher, consulta esta página.

Actualizando la Versión de Kubernetes

La versión de Kubernetes de un clúster se puede actualizar a cualquier versión disponible en la región o zona para el clúster GKE. Actualizar la versión maestra de Kubernetes no actualiza automáticamente los nodos trabajadores. Los nodos se pueden actualizar de forma independiente.

GKE ha eliminado la autenticación básica en 1.19+. Para actualizar un clúster a 1.19+, la autenticación básica debe ser desactivada en Google Cloud. De lo contrario, aparecerá un error en Rancher cuando se intente una actualización a 1.19+. Puedes seguir la documentación de Google. Después de esto, la versión de Kubernetes se puede actualizar a 1.19+ a través de Rancher.

Sincronizando

El aprovisionador de GKE puede sincronizar el estado de un clúster de GKE entre Rancher y el proveedor. Para una explicación técnica detallada de cómo funciona esto, consulta Sincronizando.

Para información sobre cómo configurar el intervalo de actualización, consulta esta sección.

Creación programática de clústeres de GKE

La forma más común de desplegar programáticamente clústeres de GKE a través de Rancher es utilizando el proveedor de Terraform Rancher2. La documentación para crear clústeres con Terraform está aquí.