Crea un clúster regional


En este tema, se muestra cómo crear un clúster regional para aumentar la disponibilidad del plano de control y las cargas de trabajo del clúster durante las actualizaciones del clúster, el mantenimiento automático o una interrupción zonal.

Descripción general

Cuando creas un clúster regional en lugar de un clúster zonal, el plano de control del clúster se replica en varias zonas en una región determinada. Para los grupos de nodos en un clúster regional, puedes especificar de forma manual las zonas en las que se ejecutan los grupos de nodos o puedes usar la configuración predeterminada, que replica cada grupo de nodos en tres zonas de la región del plano de control. Todas las zonas deben estar dentro de la misma región que el plano de control del clúster.

Los clústeres regionales replican recursos en varias zonas y consumen cuotas adicionales.

Obtén más información sobre los tipos de clústeres que puedes crear.

En las instrucciones de las siguientes secciones, se explica cómo hacer lo siguiente:

Antes de comenzar

Antes de comenzar, asegúrate de haber realizado las siguientes tareas:

Establece la configuración de gcloud predeterminada mediante uno de los siguientes métodos:

  • Usa gcloud init si deseas ver una explicación sobre cómo configurar parámetros predeterminados.
  • Usa gcloud config para establecer el ID, la zona y la región del proyecto de manera individual.

Usa gcloud init

Si recibes el error One of [--zone, --region] must be supplied: Please specify location, completa esta sección.

  1. Ejecuta gcloud init y sigue las instrucciones:

    gcloud init

    Si usas SSH en un servidor remoto, usa la marca --console-only para evitar que el comando abra un navegador:

    gcloud init --console-only
  2. Sigue las instrucciones a fin de autorizar a gcloud para que use tu cuenta de Google Cloud.
  3. Crea una configuración nueva o selecciona una existente.
  4. Elige un proyecto de Google Cloud.
  5. Elige una zona predeterminada de Compute Engine para clústeres zonales o una región para clústeres regionales o de Autopilot.

Usa gcloud config

  • Establece tu ID del proyecto predeterminado:
    gcloud config set project PROJECT_ID
  • Si trabajas con clústeres zonales, establece tu zona de procesamiento predeterminada:
    gcloud config set compute/zone COMPUTE_ZONE
  • Si trabajas con clústeres de Autopilot o regionales, configura tu región de procesamiento predeterminada:
    gcloud config set compute/region COMPUTE_REGION
  • Actualiza gcloud a la versión más reciente:
    gcloud components update

Crear un clúster regional con un grupo de nodos de zona única

En las siguientes instrucciones, se muestra cómo crear un clúster regional con un grupo de nodos que opera en una zona única dentro de la región. El plano de control del clúster se replica en varias zonas de la región especificada, pero los nodos se encuentran en la zona única y no se replican en otras zonas.

Puedes usar la herramienta de gcloud o Google Cloud Console para crear el clúster.

Si estás desarrollando aplicaciones de GKE con Visual Studio Code, intenta crear clústeres con Cloud Code.

gcloud

Para crear un clúster regional con la herramienta de gcloud, usa uno de los siguientes comandos y reemplaza las siguientes variables:

  • CLUSTER_NAME: Es el nombre del clúster regional nuevo.
  • COMPUTE_REGION: Es la región deseada para tu clúster, como us-central1.
  • COMPUTE_ZONE: es la zona deseada para tu grupo de nodos, como us-central1-a. La zona debe estar en la misma región que el plano de control del clúster.
  • CHANNEL: Es el tipo de canal de versiones, que puede ser rapid, regular, stable o None. De forma predeterminada, el clúster se inscribe en el canal de versiones regular si no se especifican las siguientes marcas: --cluster-version, --release-channel, --no-enable-autoupgrade y --no-enable-autorepair.
  • VERSION: Es la versión que deseas especificar para el clúster.

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 \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --release-channel CHANNEL

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 \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --cluster-version VERSION

Usa la versión predeterminada estática:

Para crear un clúster nuevo con la versión predeterminada estática del clúster, no necesitas especificar una versión del clúster, pero debes configurar el canal de versiones como None:

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --release-channel None

Ejemplo

Con el siguiente comando, se crea un clúster regional inscrito en el canal de versiones regular (predeterminado), con tres nodos (predeterminado) en la zona us-west1-c:

gcloud container clusters create my-regional-cluster \
    --region us-west1 \
    --node-locations us-west1-c

Ejemplo

Con el siguiente comando, se crea un clúster regional inscrito en el canal de versiones regular (predeterminado), con dos nodos ubicados en la zona us-west1-c:

gcloud container clusters create my-regional-cluster \
    --region us-west1 \
    --node-locations us-west1-c \
    --num-nodes 2

Console

  1. Ve a la página de Google Kubernetes Engine en Cloud Console:

    Ir a Google Kubernetes Engine

  2. Haz clic en Crear.

  3. En la sección Aspectos básicos del clúster, completa lo siguiente:

    1. Ingresa el nombre de tu clúster.
    2. En Tipo de ubicación, selecciona Regional y, luego, la región que desees para el clúster.
    3. Si deseas anular las ubicaciones de nodos predeterminadas (por ejemplo, para ejecutarlas en una zona única), selecciona la casilla de verificación Especificar las ubicaciones predeterminada de nodos y, luego, elige las zonas en las que deseas que se ejecuten los grupos de nodos.
    4. Elige una versión de plano de control. De forma predeterminada, tendrá la opción recomendada de Canal de versiones. Si debes especificar una versión estática, asegúrate de que la actualización automática esté habilitada para tus grupos de nodos.

  4. En el panel de navegación, en Grupos de nodos, haz clic en default-pool.

  5. En la sección Detalles del grupo de nodos, completa lo siguiente:

    1. Ingresa un Nombre para el Grupo de nodos predeterminado.
    2. Para los nodos de la versión estática, elige la Versión de nodo.
    3. Ingresa la Cantidad de nodos que deseas crear en el clúster. Debes tener una cuota de recursos disponible para los nodos y sus recursos (como las rutas de firewall).
  6. En el panel de navegación, en Grupos de nodos, haz clic en Nodos.

  7. En la lista desplegable Tipo de imagen, selecciona la imagen de nodo deseada.

  8. 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.

  9. En la lista desplegable Tipo de disco de arranque, selecciona el tipo de disco deseado.

  10. Ingresa el Tamaño de disco de arranque.

  11. Haga clic en Crear.

  12. En la sección Estándar, haz clic en Configurar.

Después de crear un clúster, debes configurar kubectl para poder interactuar con el clúster de la línea de comandos.

Crear un clúster regional con un grupo de nodos multizonal

En las siguientes instrucciones, se muestra cómo crear un clúster regional con un grupo de nodos multizonal, que es la configuración predeterminada. El plano de control y los nodos del clúster se replican en varias zonas de la región especificada.

Puedes usar la herramienta de gcloud o Google Cloud Console para crear el clúster.

Si estás desarrollando aplicaciones de GKE con Visual Studio Code, intenta crear clústeres con Cloud Code.

gcloud

Para crear un clúster regional con la herramienta de gcloud, usa uno de los siguientes comandos y reemplaza las siguientes variables:

  • CLUSTER_NAME: Es el nombre del clúster regional nuevo.
  • COMPUTE_REGION: Es la región deseada para tu clúster, como us-central1.
  • CHANNEL: Es el tipo de canal de versiones, que puede ser rapid, regular, stable o None. De forma predeterminada, el clúster se inscribe en el canal de versiones regular si no se especifican las siguientes marcas: --cluster-version, --release-channel, --no-enable-autoupgrade y --no-enable-autorepair.
  • VERSION: Es la versión que deseas especificar para el clúster.
  • Para las regiones con más de tres zonas o en las que se prefieren menos zonas, puedes usar la marca opcional --node-locations a fin de anular las zonas predeterminadas en las que se replican los nodos.

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 \
    --region COMPUTE_REGION \
    --release-channel CHANNEL

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 \
    --region COMPUTE_REGION \
    --cluster-version VERSION

Usa la versión predeterminada estática:

Para crear un clúster nuevo con la versión predeterminada estática del clúster, no necesitas especificar una versión del clúster, pero debes configurar el canal de versiones como None:

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --release-channel None

Ejemplo

Con el siguiente comando, se crea un clúster regional inscrito en el canal de versiones regular, con nueve nodos en us-west1 (tres zonas con tres nodos cada una, que es la configuración predeterminada):

gcloud container clusters create my-regional-cluster --region us-west1

Ejemplo

Con el siguiente comando, se crea un clúster regional inscrito en el canal de versiones regular con seis nodos (tres zonas con dos nodos cada una, especificado por --num-nodes):

gcloud container clusters create my-regional-cluster \
    --region us-west1 \
    --num-nodes 2

Ejemplo

Con el siguiente comando, se crea un clúster regional inscrito en el canal de versiones regular, con seis nodos en dos zonas (dos zonas, especificadas por --node-locations, con tres nodos cada una):

gcloud container clusters create my-regional-cluster \
    --region us-central1 \
    --node-locations us-central1-b,us-central1-c

Console

  1. Ve a la página de Google Kubernetes Engine en Cloud Console:

    Ir a Google Kubernetes Engine

  2. Haz clic en Crear.

  3. En la sección Aspectos básicos del clúster, completa lo siguiente:

    1. Ingresa el nombre de tu clúster.
    2. En Tipo de ubicación, selecciona Regional y, luego, la región que desees para el clúster.
    3. Si deseas anular las ubicaciones de nodos predeterminadas (por ejemplo, para ejecutarlas en una zona única), selecciona la casilla de verificación Especificar las ubicaciones predeterminada de nodos y, luego, elige las zonas en las que deseas que se ejecuten los grupos de nodos.
    4. Elige una versión de plano de control. De forma predeterminada, tendrá la opción recomendada de Canal de versiones. Si debes especificar una versión estática, asegúrate de que la actualización automática esté habilitada para tus grupos de nodos.

  4. En el panel de navegación, en Grupos de nodos, haz clic en default-pool.

  5. En la sección Detalles del grupo de nodos, completa lo siguiente:

    1. Ingresa un Nombre para el Grupo de nodos predeterminado.
    2. Para los nodos de la versión estática, elige la Versión de nodo.
    3. Ingresa la Cantidad de nodos que deseas crear en el clúster. Debes tener una cuota de recursos disponible para los nodos y sus recursos (como las rutas de firewall).
  6. En el panel de navegación, en Grupos de nodos, haz clic en Nodos.

  7. En la lista desplegable Tipo de imagen, selecciona la imagen de nodo deseada.

  8. 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.

  9. En la lista desplegable Tipo de disco de arranque, selecciona el tipo de disco deseado.

  10. Ingresa el Tamaño de disco de arranque.

  11. Haga clic en Crear.

  12. En la sección Estándar, haz clic en Configurar.

Después de crear un clúster, debes configurar kubectl para poder interactuar con el clúster de la línea de comandos.

¿Qué sigue?