Agrega y administra grupos de nodos

En esta página, se muestra cómo agregar y realizar operaciones en grupos de nodos mediante la ejecución de los clústeres de Google Kubernetes Engine (GKE). Para obtener información sobre cómo funcionan los grupos de nodos, consulta Grupos de nodos.

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

  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.

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 regionales, establece 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

Cómo agregar un grupo de nodos

gcloud

Para crear un grupo de nodos, ejecuta el siguiente comando:

gcloud container node-pools create pool-name --cluster cluster-name

Para ver la lista completa de opciones, consulta la documentación de gcloud container node-pools create.

Una solicitud node-pools create correcta muestra la información del grupo de nodos:

Creating node pool example-pool...done.
Created [https://container.googleapis.com/v1/projects/kubernetes-engine-docs/zones/us-central1-f/clusters/example-cluster/nodePools/example-pool].
NAME          MACHINE_TYPE   DISK_SIZE_GB  NODE_VERSION
example-pool  n1-standard-1  100           1.2.4

Se crea el grupo de nodos. Puede suceder que el grupo de nodos se cree de forma correcta, pero el comando de gcloud agote el tiempo de espera en lugar de informar sobre el estado del servidor. Para comprobar el estado de todos los grupos de nodos, incluidos aquellos que aún no están aprovisionados del todo, usa el siguiente comando:

gcloud container node-pools list --cluster cluster-name

Console

Para agregar un grupo de nodos a un clúster existente, realiza los siguientes pasos:

  1. Dirígete al menú de Google Kubernetes Engine en Cloud Console.

    Ir al menú Google Kubernetes Engine

  2. Haz clic en el botón Editar del clúster, que tiene forma de lápiz.

  3. Haz clic en Agregar grupo de nodos.

  4. Configura tu grupo de nodos como desees.

  5. Haz clic en Listo para cerrar la superposición Agregar grupo de nodos.

  6. Haz clic en Guardar para modificar el clúster.

Cómo ver grupos de nodos en un clúster

gcloud

Para enumerar todos los grupos de nodos de un clúster, ejecuta el comando de gcloud node-pools list:

gcloud container node-pools list --cluster cluster-name

Para visualizar detalles sobre un grupo de nodos específico, ejecuta el comando de gcloud node-pools describe:

gcloud container node-pools describe pool-name \
    --cluster cluster-name

Console

Para ver un grupo de nodos de un clúster, realiza los siguientes pasos:

  1. Dirígete al menú de Google Kubernetes Engine en Cloud Console.

    Ir al menú Google Kubernetes Engine

  2. Haz clic en el nombre del clúster que deseas ver.

  3. En la sección Grupos de nodos, haz clic en el ícono de divulgación junto al grupo de nodos deseado. El menú se expande para mostrar los detalles sobre el grupo de nodos.

  4. Haz clic en Listo para salir de la descripción general de los detalles del grupo de nodos.

Cómo cambiar el tamaño de un grupo de nodos

gcloud

Para cambiar el tamaño de un grupo de nodos, usa el comando de gcloud container clusters resize. Debes especificar el nombre del clúster, el nombre del grupo de nodos deseado y la nueva cantidad de nodos:

gcloud container clusters resize cluster-name --node-pool pool-name \
    --num-nodes num-nodes

Repite este comando para cada grupo de nodos. Si tu clúster solo tiene el grupo de nodos predeterminado, omite la marca --node-pool.

Para obtener más información, consulta la documentación de gcloud container clusters resize.

Console

Para cambiar el tamaño de los grupos de nodos de tu clúster, realiza los siguientes pasos:

  1. Dirígete al menú de Google Kubernetes Engine en Cloud Console.

    Ir al menú Google Kubernetes Engine

  2. Haz clic en el botón Editar del clúster, que tiene forma de lápiz.

  3. En la sección Grupos de nodos, cambia el valor del campo Tamaño al valor deseado. Repite este paso para cada grupo de nodos según sea necesario.

  4. Haz clic en Guardar.

Cómo actualizar un grupo de nodos

gcloud

Para actualizar todos los nodos a la misma versión que la instancia principal, ejecuta el comando de gcloud container clusters upgrade:

gcloud container clusters upgrade cluster-name

Para actualizar un grupo de nodos específico, establece la marca --node-pool:

gcloud container clusters upgrade cluster-name --node-pool pool-name

Console

Para actualizar un grupo de nodos, realiza los siguientes pasos:

  1. Dirígete al menú de Google Kubernetes Engine en Cloud Console.

    Ir al menú Google Kubernetes Engine

  2. Haz clic en el botón Editar del clúster, que tiene forma de lápiz.

  3. En la sección Grupos de nodos, haz clic en el vínculo Cambiar junto al campo Versión del nodo del grupo de nodos deseado.

  4. Selecciona la versión deseada de Kubernetes.

  5. Lee la advertencia y luego haz clic en Cambiar para confirmar.

  6. Haz clic en Guardar para salir de la pantalla de modificación del clúster.

Cómo borrar un grupo de nodos

Cuando se borra un grupo de nodos, se borran los nodos y las rutas a ellos. Cualquier pod que se ejecuta en esos nodos se expulsa y reprograma. Si los pods tienen selectores de nodo específicos, pueden mantenerse en una condición no programable si ningún otro nodo en el clúster cumple con los requisitos.

gcloud

Para borrar un grupo de nodos, ejecuta el comando de gcloud node-pools delete:

gcloud container node-pools delete pool-name --cluster cluster-name

Console

Para borrar un grupo de nodos, realiza los siguientes pasos:

  1. Dirígete al menú de Google Kubernetes Engine en Cloud Console.

    Ir al menú Google Kubernetes Engine

  2. Haz clic en el botón Editar del clúster, que tiene forma de lápiz.

  3. En la sección Grupos de nodos, expande el grupo de nodos que deseas borrar.

  4. Haz clic en el ícono de borrar, que tiene forma de cubo de basura.

  5. Haz clic en Guardar.

Próximos pasos