En esta página, se muestra cómo crear un clúster zonal estándar con las funciones predeterminadas habilitadas en Google Kubernetes Engine (GKE). Los clústeres zonales tienen una sola instancia del plano de control en una sola zona. Según tus requisitos de disponibilidad, puedes optar por distribuir los nodos para tu clúster zonal en una sola zona o en varias zonas.
Esta página está dirigida a operadores, arquitectos de la nube y desarrolladores que necesitan crear y configurar clústeres, y que implementan cargas de trabajo en GKE. Para obtener más información sobre los roles comunes y las tareas de ejemplo a las que hacemos referencia en el contenido de Google Cloud, consulta Roles y tareas comunes del usuario de GKE.
Antes de leer esta página, asegúrate de estar familiarizado con las opciones de configuración del clúster.
Antes de comenzar
Antes de comenzar, asegúrate de haber realizado las siguientes tareas:
- Habilita la API de Google Kubernetes Engine. Habilitar la API de Google Kubernetes Engine
- Si deseas usar Google Cloud CLI para esta tarea,
instala y, luego,
inicializa la
gcloud CLI. Si ya instalaste gcloud CLI, ejecuta el comando
gcloud components updatepara obtener la versión más reciente. Es posible que las versiones anteriores de gcloud CLI no admitan la ejecución de los comandos de este documento.
- Asegúrate de tener los permisos correctos para crear clústeres. Como mínimo, debes ser un administrador de clústeres de Kubernetes Engine.
- Si deseas registrar tu clúster nuevo en una flota, asegúrate de tener las APIs y los permisos necesarios.
Configura cuentas de servicio de IAM para GKE
GKE usa cuentas de servicio de IAM que se adjuntan a tus nodos para
ejecutar tareas del sistema, como el registro y la supervisión. Como mínimo, estas cuentas de servicio de nodo
deben tener el rol de
cuenta de servicio de nodo predeterminado de Kubernetes Engine
(roles/container.defaultNodeServiceAccount) en tu proyecto. De forma predeterminada,
GKE usa la
cuenta de servicio predeterminada de Compute Engine,
que se crea automáticamente en tu proyecto, como la cuenta de servicio del nodo.
Para otorgar el rol roles/container.defaultNodeServiceAccount a la
cuenta de servicio predeterminada de Compute Engine, completa los siguientes pasos:
Console
- Ve a la página Bienvenida:
- En el campo Número del proyecto, haz clic en Copiar al portapapeles.
- Ve a la página IAM:
- Haz clic en Otorgar acceso.
- En el campo Principales nuevas, especifica el siguiente valor:
ReemplazaPROJECT_NUMBER-compute@developer.gserviceaccount.comPROJECT_NUMBERpor el número de proyecto que copiaste. - En el menú Selecciona un rol, elige el rol Cuenta de servicio de nodo predeterminado de Kubernetes Engine.
- Haz clic en Guardar.
gcloud
- Busca el número de proyecto de Google Cloud :
gcloud projects describe PROJECT_ID \ --format="value(projectNumber)"
Reemplaza
PROJECT_IDcon el ID del proyecto.El resultado es similar a lo siguiente:
12345678901
- Otorga el rol
roles/container.defaultNodeServiceAccounta la cuenta de servicio predeterminada de Compute Engine:gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com" \ --role="roles/container.defaultNodeServiceAccount"
Reemplaza
PROJECT_NUMBERpor el número de proyecto del paso anterior.
Crea un clúster zonal
La información mínima que debes especificar cuando creas un clúster zonal nuevo es un nombre, un proyecto (por lo general, el proyecto actual) y una zona (por lo general, la ubicación predeterminada para las herramientas de línea de comandos), con la configuración predeterminada para todos los demás valores. Sin embargo, hay más parámetros de configuración posibles, de los cuales solo algunos se describen en esta sección y algunos no se pueden cambiar después de crear el clúster. Asegúrate de comprender qué parámetros de configuración no se pueden cambiar después de crear el clúster y de elegir el parámetro de configuración correcto cuando crees un clúster si no quieres tener que volver a crearlo.
Puedes ver una descripción general de las opciones de configuración del clúster en Acerca de las opciones de configuración del clúster y una lista completa de las opciones posibles en las guías de referencia de gcloud container clusters create y Terraform google_container_cluster.
Puedes crear un clúster zonal con gcloud CLI, la consola deGoogle Cloud o Terraform.
Si estás desarrollando aplicaciones de GKE con Cloud Code para VS Code, intenta crear clústeres con Cloud Code.
gcloud
Para crear un clúster zonal con gcloud CLI, usa uno de los siguientes comandos.
Reemplaza lo siguiente:
CLUSTER_NAME: Es el nombre del clúster nuevo.CHANNEL: Es el tipo de canal de versiones, que puede serrapid,regular,stableoNone(obsoleto). De forma predeterminada, el clúster se inscribe en el canal de versionesregular.CONTROL_PLANE_LOCATION: Es la zona de Compute Engine del plano de control de tu clúster.VERSION: Es la versión que deseas especificar para el clúster.COMPUTE_ZONE,COMPUTE_ZONE1,[...]: son las zonas en las que se crean los nodos. Puedes especificar tantas zonas como sea necesario para tu clúster. Todas las zonas deben estar en la misma región que el plano de control del clúster, especificado por la marca--location. En el caso de los clústeres zonales,--node-locationsdebe contener la zona principal del clúster.
Te recomendamos que especifiques una cuenta de servicio de IAM con privilegios mínimos que tus nodos puedan usar en lugar de la cuenta de servicio predeterminada de Compute Engine. Para obtener información sobre cómo crear una cuenta de servicio con privilegios mínimos, consulta Usa una cuenta de servicio privilegio mínimo mínimos.
Para especificar una cuenta de servicio personalizada en gcloud CLI, agrega la siguiente marca a tu comando:
--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.comReemplaza SERVICE_ACCOUNT_NAME por el nombre de tu cuenta de servicio con privilegios mínimos.
Usa un canal de versiones específico:
Para crear un clúster nuevo con un canal de versiones específico, ejecuta el siguiente comando:
gcloud container clusters create CLUSTER_NAME \
--release-channel CHANNEL \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE,COMPUTE_ZONE1
Usa una versión específica:
Para crear un clúster nuevo con una versión de clúster específica, ejecuta el siguiente comando:
gcloud container clusters create CLUSTER_NAME \
--cluster-version VERSION \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE,COMPUTE_ZONE1
Ejemplo
Con el siguiente comando, se crea un clúster multizonal llamado example-cluster,
en el que el plano de control del clúster se encuentra en la zona us-east4-a y
hay tres ubicaciones de nodos. El clúster está inscrito en el canal de versiones
regular.
Cuando se omite la marca --num-nodes, el número predeterminado de nodos por zona creados por el clúster es tres. Debido a que se especificaron tres zonas, este comando crea un clúster de nueve nodos con tres nodos cada uno en us-east4-a, us-east4-b y us-east4-c. En la versión 1.37.1-gke.1153000 y posteriores de GKE, puedes establecer la marca --num-nodes en un valor de 0 para crear un clúster que no tenga nodos.
gcloud container clusters create example-cluster \
--location us-east4-a \
--node-locations us-east4-a,us-east4-b,us-east4-c
Console
Para crear un clúster zonal con la consola de Google Cloud , realiza las siguientes tareas:
En la consola de Google Cloud , ve a la página Crea un clúster de Kubernetes.
En la sección Aspectos básicos del clúster, completa lo siguiente:
- Ingresa el nombre de tu clúster.
- En Tipo de ubicación, selecciona Zonal y, luego, selecciona la zona deseada para tu clúster.
- Si creas un clúster multizonal, selecciona la casilla de verificación Especificar las ubicaciones predeterminadas de nodos y, luego, elige las zonas adicionales en las que deseas que se ejecuten los grupos de nodos.
Elige un canal de versiones. De manera opcional, puedes seleccionar Sin canal, pero esta opción de configuración ya no está disponible y se quitará. Para obtener más información, consulta Clústeres no inscritos en un canal de versiones.
Opcional: Especifica una versión del plano de control en la lista desplegable Versión.
Opcional: Establece otros parámetros de configuración para tu clúster nuevo.
Opcional: Si deseas registrar tu clúster nuevo en una flota, ve a la sección Configuración avanzada y sigue las instrucciones de la consola de Google Cloud para crear y registrar un clúster nuevo y completar el registro del clúster.
Para crear y configurar tus propios grupos de nodos, sigue estos pasos:
- Haz clic en Agregar grupo de nodos.
- En el diálogo Cambios necesarios, haz clic en Hacer cambios.
En el menú de navegación, aparece un grupo de nodos llamado
default-pool.Opcional: Para crear un clúster que no tenga grupos de nodos, sigue estos pasos:
- En el menú de navegación, haz clic en default-pool.
- Haz clic en Quitar grupo de nodos.
- Establece cualquier configuración restante para el clúster y, luego, haz clic en Crear.
Opcional: Para agregar grupos de nodos al clúster, haz clic en Agregar grupo de nodos. En el menú de navegación, aparecerá un nuevo grupo de nodos.
Establece la configuración básica de un grupo de nodos:
- En el menú de navegación, en la sección Grupos de nodos, haz clic en el nombre del grupo de nodos. Se abrirá la página Detalles del grupo de nodos administrado por el usuario.
- En el campo Nombre, ingresa un nombre para el grupo de nodos.
- En la sección Tamaño, en el campo Cantidad de nodos,
especifica la cantidad de nodos que se crearán. Debes tener una
cuota de recursos disponible para los nodos y sus
recursos (como las rutas de firewall). En la versión 1.37.1-gke.1153000 y posteriores de GKE, puedes crear un grupo de nodos vacío especificando un valor de
0.
Establece la configuración de las instancias de VM que ejecutan los nodos:
- En el menú de navegación, en la sección expandida del grupo de nodos seleccionado, haz clic en Nodos.
- En la lista desplegable Tipo de imagen, selecciona la imagen de nodo.
- Elige la Configuración de la máquina predeterminada para usar en las instancias. Cada tipo de máquina se factura de manera diferente. El tipo de máquina predeterminado es
e2-medium. Para obtener información sobre el precio del tipo de máquina, consulta la hoja de precios de tipos de máquinas. - En la lista desplegable Tipo de disco de arranque, selecciona el tipo de disco.
- En el campo Tamaño del disco de arranque, especifica un tamaño, en GB, para el disco de arranque.
Establece la configuración de seguridad para el grupo de nodos:
- En el menú de navegación, en la sección expandida del grupo de nodos seleccionado, haz clic en Seguridad.
- De manera opcional, especifica una cuenta de servicio de IAM personalizada para tus nodos:
- En la página Configuración avanzada, expande la sección Seguridad.
- En el menú Cuenta de servicio, selecciona la cuenta de servicio que prefieras.
Te recomendamos que especifiques una cuenta de servicio de IAM con privilegios mínimos que tus nodos puedan usar en lugar de la cuenta de servicio predeterminada de Compute Engine. Para obtener información sobre cómo crear una cuenta de servicio con privilegios mínimos, consulta Usa una cuenta de servicio privilegio mínimo mínimos.
Haz clic en Crear.
Terraform
Para crear un clúster zonal con un grupo de nodos de zona única mediante Terraform, consulta el siguiente ejemplo:
Para crear un clúster zonal con un grupo de nodos multizona mediante Terraform, consulta el siguiente ejemplo:
Si deseas obtener más información sobre el uso de Terraform, consulta Compatibilidad con Terraform para GKE.
Interactúa con un clúster mediante kubectl
Después de crear un clúster, debes configurar kubectl para poder interactuar con el clúster de la línea de comandos.
Crea un clúster zonal que no tenga nodos
En la versión 1.37.1-gke.1153000 y posteriores de GKE, puedes crear un clúster zonal que no tenga nodos de una de las siguientes maneras:
- Omitir la creación del grupo de nodos predeterminado: GKE no agrega ningún grupo de nodos al clúster. Si planeas ejecutar cargas de trabajo con ComputeClasses de Autopilot, creación automática de grupos de nodos o grupos de nodos personalizados que crees más adelante, usa esta opción.
- Crea un grupo de nodos vacío: GKE crea un grupo de nodos que no tiene nodos. Si deseas personalizar la configuración del grupo de nodos durante la creación del clúster sin crear los nodos reales, usa esta opción.
Cuando creas un clúster que no tiene nodos, los Pods del sistema permanecen en un estado no programable hasta que exista al menos un nodo en el clúster. Para crear un clúster zonal que no tenga nodos, selecciona una de las siguientes opciones:
gcloud
Para omitir la creación del grupo de nodos predeterminado, usa solo la marca
--num-nodes=0en el comandogcloud container clusters create:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0Reemplaza lo siguiente:
CLUSTER_NAME: Es el nombre del clúster zonal nuevo.CONTROL_PLANE_LOCATION: Es la zona de Compute Engine del plano de control del clúster, comous-central1-a.
Si especificas cualquier otra marca de configuración del grupo de nodos, como las marcas
--machine-type,--disk-typeo--disk-size, el comando fallará porque no hay un grupo de nodos para que GKE lo configure.Para crear un clúster que tenga un grupo de nodos vacío, usa la marca
--num-nodes=0y la marca--node-pool-nameen el comandogcloud container clusters create:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0 \ --node-pool-name=NODEPOOL_NAMEReemplaza
NODEPOOL_NAMEpor un nombre para el grupo de nodos vacío. Puedes especificar otras marcas de configuración de nodos para personalizar los nodos en el grupo de nodos vacío.
Console
En la consola de Google Cloud , ve a la página Crea un clúster de Kubernetes.
Especifica un nombre para el clúster.
En la sección Tipo de ubicación, selecciona Zonal.
En la lista desplegable Zona, selecciona una zona para el plano de control del clúster.
Omite la creación del grupo de nodos predeterminado o crea un grupo de nodos vacío:
Para omitir la creación del grupo de nodos predeterminado, en la sección Modo predeterminado, verifica que esté seleccionada la opción Autopilot. Como alternativa, activa la creación del grupo de nodos predeterminado y, luego, quítalo:
- Haz clic en Agregar grupo de nodos.
- En el diálogo Cambios necesarios, haz clic en Hacer cambios.
Aparecerá un grupo de nodos llamado
default-pool. - En el menú de navegación, haz clic en default-pool.
- Haz clic en Quitar grupo de nodos.
Con estos pasos, se crea un clúster que no tiene grupos de nodos y usa el modo Autopilot para ejecutar cargas de trabajo que no seleccionan una ComputeClass. También puedes evitar el uso del modo Autopilot seleccionando la opción Grupo de nodos administrado por el usuario en la sección Modo predeterminado.
Para crear un grupo de nodos vacío, sigue estos pasos:
- Haz clic en Agregar grupo de nodos.
- En el diálogo Cambios necesarios, haz clic en Hacer cambios.
Aparecerá un grupo de nodos llamado
default-pool. - En el menú de navegación, haz clic en default-pool.
- En el campo Cantidad de nodos, especifica un valor de
0.
Establece cualquier configuración restante para el clúster y, luego, haz clic en Crear.
Terraform
- Para omitir la creación del grupo de nodos predeterminado, en tu recurso
google_container_cluster, establece el campoinitial_node_counten un valor de0. Para crear un grupo de nodos inicial vacío, haz lo siguiente:
- En el recurso
google_container_cluster, establece el campoinitial_node_counten un valor de0. - Agrega un recurso
google_container_node_pooly establece el camponode_counten un valor de0.
- En el recurso
Después de crear un clúster que no tenga nodos, puedes aprovisionar nodos de las siguientes maneras:
- Configura clústeres de Standard para usar Autopilot de forma predeterminada o ejecuta cargas de trabajo específicas en el modo Autopilot.
- Usa ComputeClasses para crear nodos automáticamente para las cargas de trabajo entrantes.
- Agrega un grupo de nodos o cambia el tamaño de un grupo de nodos vacío existente de forma manual.
Plantillas de clúster
GKE antes admitía las plantillas para clústeres. Esas plantillas se quitaron de la consola de Google Cloud , pero todavía puedes acceder a ellas desde los siguientes vínculos:
¿Qué sigue?
- Obtén más información sobre las opciones de configuración del clúster que puedes crear.
- Obtén más información sobre la arquitectura del clúster de GKE.
- Más información sobre cómo administrar tus clústeres.
- Más información para borrar clústeres.
Pruébalo tú mismo
Si es la primera vez que usas Google Cloud, crea una cuenta para evaluar el rendimiento de GKE en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar e implementar cargas de trabajo.
Probar GKE gratis