Administra clústeres

En esta página, se muestra cómo administrar clústeres en Google Kubernetes Engine (GKE). Para obtener información sobre cómo funcionan los clústeres, consulta Arquitectura de clústeres.

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

Visualiza los clústeres

gcloud

Para ver un clúster específico, ejecuta el siguiente comando:

gcloud container clusters describe CLUSTER_NAME

Reemplaza CLUSTER_NAME por el nombre del clúster.

Para ver todos los clústeres en tu zona predeterminada, ejecuta:

gcloud container clusters list

Console

Para ver tus clústeres, ve a la página de Google Kubernetes Engine en Cloud Console.

Ir a Google Kubernetes Engine

Para obtener más información sobre un clúster, selecciona el clúster de la lista.

Configura un clúster predeterminado para kubectl

Si tienes varios clústeres, puedes configurar un clúster predeterminado para la herramienta de línea de comandos de kubectl.

Si deseas obtener más información, consulta Configura un clúster predeterminado para los comandos de kubectl.

Configura un clúster predeterminado para gcloud

A fin de establecer un clúster predeterminado para los comandos de gcloud, ejecuta el siguiente comando:

gcloud config set container/cluster CLUSTER_NAME

Reemplaza CLUSTER_NAME por el nombre del clúster.

Actualiza clústeres

De forma predeterminada, GKE actualiza los clústeres automáticamente. Sin embargo, puedes optar por actualizar tus clústeres estándar por tu cuenta. Para obtener más información, consulta Actualiza un clúster de forma manual.

A fin de obtener orientación sobre la actualización de clústeres, consulta Prácticas recomendadas para actualizar clústeres.

Agrega o quita zonas

Esta sección solo se aplica a los clústeres creados en el modo estándar.

Las siguientes secciones explican cómo agregar o quitar zonas del clúster.

Cómo cambiar zonas para clústeres zonales

En los clústeres zonales existentes, puedes agregar o quitar zonas.

gcloud

Para agregar o quitar zonas de un clúster zonal, usa el comando gcloud container clusters update:

gcloud container clusters update CLUSTER_NAME \
  --zone COMPUTE_ZONE \
  --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

Reemplaza lo siguiente:

  • CLUSTER_NAME: el nombre que eliges para el clúster
  • COMPUTE_ZONE: la zona del plano de control del clúster.
  • COMPUTE_ZONE,COMPUTE_ZONE1,[...]: 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 --zone. En el caso de los clústeres zonales, --node-locations debe contener la zona principal del clúster.

Por ejemplo, example-cluster se ejecuta en us-central1-a. Para agregar dos zonas más al clúster, ejecuta el siguiente comando:

gcloud container clusters update example-cluster \
  --zone us-central1-a
  --node-locations us-central1-a,us-central1-b,us-central1-c

Otro ejemplo es example-cluster, que se ejecuta en us-central1-a, us-central1-b y us-central1-c. Si deseas que el clúster solo se ejecute en us-central1-a y us-central1-b, debes ejecutar el siguiente comando:

gcloud container clusters update example-cluster \
  --zone us-central1-a \
  --node-locations us-central1-a,us-central1-b

Console

Para agregar o quitar zonas en un clúster existente, realiza los siguientes pasos:

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

    Ir a Google Kubernetes Engine

  2. Junto al clúster que deseas editar, haz clic en Acciones y, luego, en Editar.

  3. En la pestaña Detalles, en el campo Zonas de nodo predeterminadas, haz clic en Editar grupos de nodos.

  4. Selecciona las zonas deseadas y guarda los cambios.

Cambia zonas para clústeres regionales

Esta sección solo se aplica a los clústeres creados en el modo estándar.

Por el momento, solo es posible cambiar las zonas de los clústeres regionales existentes mediante el comando gcloud.

Para agregarle o quitarle zonas a un clúster regional, usa el comando gcloud container clusters update con la marca --region:

gcloud container clusters update CLUSTER_NAME \
  --region COMPUTE_REGION \
  --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

Reemplaza lo siguiente:

  • CLUSTER_NAME: el nombre del clúster
  • COMPUTE_REGION: la región en la que se ejecuta el clúster.
  • COMPUTE_ZONE y COMPUTE_ZONE1,[...]: Es la región del plano de control de las zonas en la que se crean los nodos. Las zonas deben estar en la misma COMPUTE_REGION que los planos de control del clúster, especificados por la marca --region.

Por ejemplo, example-cluster se ejecuta en us-central1-a y us-central1-b. Para agregar us-central1-c, debes ejecutar el siguiente comando:

gcloud container clusters update example-cluster \
  --region us-central1 \
  --node-locations us-central1-a,us-central1-b,us-central1-c

Otro ejemplo es example-cluster, que se ejecuta en us-central1-a, us-central1-b y us-central1-c. Si deseas que el clúster solo se ejecute en us-central1-a y us-central1-b, debes ejecutar el siguiente comando:

gcloud container clusters update example-cluster \
  --region us-central1 \
  --node-locations us-central1-a,us-central1-b

Cambia el tamaño de los clústeres

Puedes cambiar el tamaño de un clúster estándar para aumentar o disminuir la cantidad de nodos que tiene. Por ejemplo, si deseas evitar que tu clúster consuma recursos sin borrarlo, puedes reducir los nodos a cero. Para obtener más información sobre cómo cambiar el tamaño, consulta Cambia el tamaño de un clúster.

El tamaño de los clústeres de Autopilot se ajusta automáticamente según las especificaciones de tu pod. Por lo tanto, no debes preocuparte por cambiar el tamaño de tu clúster. Por ejemplo, si cambias el número de réplicas de tu pod o los recursos que solicita, el tamaño del clúster se aumentará o disminuirá de forma adecuada.

Si deseas usar una forma más eficiente de optimizar tus clústeres, también puedes usar el Ajuste de escala automático vertical de pods (VPA). El escalador automático te puede recomendar valores de solicitudes de CPU y memoria o puede actualizar de manera automática los valores.

Borra clústeres

Cuando sea necesario, puedes borrar un clúster. Para obtener más información, consulta Borra un clúster.

¿Qué sigue?