Crear y administrar grupos de nodos

En esta página, se describe cómo crear y administrar recursos de grupos de nodos de Google Distributed Cloud en una zona conectada de Distributed Cloud.

En los servidores conectados de Distributed Cloud, los grupos de nodos se crean y completan automáticamente cuando creas un clúster. También tienes la opción de configurar grupos de nodos adicionales después de crear el clúster.

Para obtener más información sobre los grupos de nodos de Distributed Cloud, consulta Cómo funciona Distributed Cloud conectado.

Nota: En las instrucciones de Google Cloud CLI de esta página, se supone que usas Cloud Shell o algún otro entorno con bash instalado.

Crea un grupo de nodos

Para crear un grupo de nodos de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener los siguientes roles en tu proyecto deGoogle Cloud :

• Rol de administrador de contenedores de Edge (roles/edgecontainer.admin)

• Rol de usuario de máquina de contenedores de Edge (roles/edgecontainer.machineUser)

  También debes tener este rol en el proyecto Google Cloud que contiene las máquinas conectadas de Distributed Cloud que se asignarán a este grupo de nodos si ese proyecto es diferente del proyectoGoogle Cloud en el que creas el grupo de nodos.

Console

Si usas la consola de Google Cloud , solo puedes crear un grupo de nodos cuando creas un clúster. Para crear un grupo de nodos independiente, debes usar Google Cloud CLI o la API de Distributed Cloud Edge Container.

gcloud

Usa el comando gcloud edge-cloud container clusters node-pools create:

gcloud edge-cloud container clusters node-pools create POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME \
    --node-location=ZONE_NAME \
    --node-count=NODE_COUNT \
    --node-labels=NODE_LABELS \
    --machine-filter=MACHINE_FILTER \
    --local-disk-kms-key=POOL_KMS_KEY \
    --node-storage-schema=WORKER_NODE_STORAGE_SCHEMA

Reemplaza lo siguiente:

• POOL_NAME: Es un nombre descriptivo que identifica de forma única este grupo de nodos. Este nombre debe cumplir con el RFC 1213 y constar solo de caracteres alfanuméricos en minúscula y guiones (-). Debe comenzar y terminar con un carácter alfanumérico.
• PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
• REGION: Es la región de Google Cloud en la que se aloja el clúster de Distributed Cloud conectado de destino para este grupo de nodos.
• CLUSTER_NAME: Es el nombre del clúster conectado de Distributed Cloud de destino.
• ZONE_NAME: Es el nombre de la zona de Distributed Cloud de destino. Esta zona debe estar en la región especificada en REGION.
• NODE_COUNT: Es la cantidad de nodos que contiene este grupo de nodos.
• NODE_LABELS: Es una lista delimitada por comas de pares clave-valor que comprenden etiquetas para los nodos individuales del grupo de nodos.
• MACHINE_FILTER (opcional): Especifica los criterios de filtrado para la selección de máquinas. Para ver los campos por los que puedes filtrar, consulta Cómo obtener información sobre una máquina. Solo se permite que las máquinas que coincidan con este filtro se unan a este grupo de nodos. En el caso de los clústeres de varios racks, usa esta marca para especificar los racks conectados de Distributed Cloud cuyos nodos componen este grupo de nodos. Si se omite, se agregarán todos los nodos disponibles en la zona a este grupo de nodos.

• POOL_KMS_KEY (opcional): Es la ruta de acceso completa a la clave de Cloud KMS que deseas usar con este grupo de nodos. Por ejemplo:

  /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
  

  Esta marca solo se aplica si integraste Distributed Cloud Connected con Cloud Key Management Service, como se describe en Cómo habilitar la compatibilidad con las claves de encriptación administradas por el cliente (CMEK) para el almacenamiento local.

• WORKER_NODE_STORAGE_SCHEMA (opcional): Especifica el esquema de almacenamiento local para los nodos trabajadores incluidos en este grupo de nodos. Para obtener más información, consulta Configura esquemas de almacenamiento local.

API

Realiza una solicitud POST al método projects.locations.clusters.nodePools.create:

POST /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME?nodePoolId=NODEPOOL_ID&requestId=REQUEST_ID
{
 "name": POOL_NAME,
 "labels": { LABELS,
  },
 "nodeLocation": ZONE_NAME,
 "nodeCount": NODE_COUNT,
 "nodeLabels": NODE_LABELS,
 "machineFilter": MACHINE_FILTER,
 "localDiskEncryption": {
   "kmsKey": POOL_KMS_KEY,
  }
}

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
• REGION: Es la región de Google Cloud en la que se aloja el clúster de Distributed Cloud conectado de destino para este grupo de nodos.
• CLUSTER_NAME: Es el nombre del clúster conectado de Distributed Cloud de destino.
• NODEPOOL_ID: Es un ID programático único que identifica este recurso de grupo de nodos.
• REQUEST_ID: Es un ID programático único que identifica esta solicitud.
• POOL_NAME: Es un nombre descriptivo que identifica de forma única este grupo de nodos.
• LABELS: Es una lista de etiquetas que se aplicarán a este recurso de grupo de nodos.
• ZONE_NAME: Es el nombre de la zona conectada de Distributed Cloud de destino. Esta zona debe estar en la región especificada en REGION.
• NODE_COUNT: Es la cantidad de nodos que contiene este grupo de nodos.
• NODE_LABELS: Es una lista delimitada por comas de pares clave-valor que comprenden etiquetas para los nodos individuales del grupo de nodos.
• MACHINE_FILTER (opcional): Especifica los criterios de filtrado para la selección de máquinas. Solo se pueden unir al grupo de nodos las máquinas que coincidan con este filtro. En el caso de los clústeres de varios racks, usa esta marca para especificar los racks conectados de Distributed Cloud cuyos nodos componen este grupo de nodos. Si se omite, se agregarán todos los nodos disponibles en la zona a este grupo de nodos.

• POOL_KMS_KEY (opcional): Es la ruta de acceso completa a la clave de Cloud KMS que deseas usar con este grupo de nodos. Por ejemplo:

  /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
  

  Este parámetro solo se aplica si integraste Distributed Cloud Connected con Cloud Key Management Service, como se describe en Cómo habilitar la compatibilidad con las claves de encriptación administradas por el cliente (CMEK) para el almacenamiento local.

Mostrar lista de grupos de nodos

Para enumerar los grupos de nodos de Distributed Cloud disponibles en una zona conectada de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de visualizador de contenedores de Edge (roles/edgecontainer.viewer) en tu proyecto de Google Cloud .

gcloud

Usa el comando gcloud edge-cloud container clusters node-pools list:

gcloud edge-cloud container clusters node-pools list \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
• REGION: Es la región Google Cloud en la que se creó el clúster de Distributed Cloud conectado de destino.
• CLUSTER_NAME: Es el nombre del clúster conectado de Distributed Cloud de destino.

API

Realiza una solicitud GET al método projects.locations.clusters.nodePools.list:

GET /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
• REGION: Es la Google Cloud región en la que se creó el clúster de Distributed Cloud conectado de destino.
• CLUSTER_NAME: Es el nombre del clúster de Distributed Cloud de destino.
• FILTER: Es una expresión que limita los resultados devueltos a valores específicos.
• PAGE_SIZE: Es la cantidad de resultados que se mostrarán por página.
• SORT_BY: Es una lista delimitada por comas de los nombres de los campos por los que se ordenan los resultados devueltos. El orden de clasificación predeterminado es ascendente. Para obtener un orden de clasificación descendente, agrega el prefijo ~ al campo deseado.
• PAGE_TOKEN: Es un token que se recibe en la respuesta a la última solicitud de lista en el campo nextPageToken de la respuesta. Envía este token para recibir una página de resultados.

Obtén información sobre un grupo de nodos

Para obtener información sobre un grupo de nodos de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de visualizador de contenedores de Edge (roles/edgecontainer.viewer) en tu proyecto de Google Cloud .

gcloud

Usa el comando gcloud edge-cloud container clusters node-pools describe:

gcloud edge-cloud container clusters node-pools describe POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

Reemplaza lo siguiente:

• POOL_NAME: Es el nombre del grupo de nodos de destino.
• PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
• REGION: Es la Google Cloud región en la que se aloja el clúster de Distributed Cloud conectado asociado con este grupo de nodos.
• CLUSTER_NAME: Es el nombre del clúster conectado de Distributed Cloud de destino.

API

Realiza una solicitud GET al método projects.locations.clusters.nodePools.get:

GET /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools/POOL_NAME

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
• REGION: Es la Google Cloud región en la que se aloja el clúster de Distributed Cloud conectado asociado con este grupo de nodos.
• CLUSTER_NAME: Es el nombre del clúster conectado de Distributed Cloud de destino.
• POOL_NAME: Es el nombre del grupo de nodos de destino.

Modifica un grupo de nodos

Para modificar un grupo de nodos de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de administrador de contenedores perimetrales (roles/edgecontainer.admin) en tu proyecto de Google Cloud .

gcloud

Usa el comando gcloud edge-cloud container clusters node-pools update:

gcloud edge-cloud container clusters node-pools update POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME \
    --node-count=NODE_COUNT \
    --machine-filter=MACHINE_FILTER \
    --local-disk-kms-key=POOL_KMS_KEY

Reemplaza lo siguiente:

• POOL_NAME: Es el nombre del grupo de nodos de destino.
• PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
• REGION: Es la Google Cloud región en la que se aloja el clúster de Distributed Cloud conectado asociado con este grupo de nodos.
• CLUSTER_NAME: Es el nombre del clúster conectado de Distributed Cloud de destino.
• NODE_COUNT: Es la cantidad de nodos que contiene este grupo de nodos.
• MACHINE_FILTER (opcional): Especifica los criterios de filtrado para la selección de máquinas. Para ver los campos por los que puedes filtrar, consulta Cómo obtener información sobre una máquina. En el caso de los clústeres de varios racks, usa esta marca para especificar los racks conectados de Distributed Cloud cuyos nodos componen este grupo de nodos.

• POOL_KMS_KEY (opcional): Es la ruta de acceso completa a la clave de Cloud KMS que deseas usar con este grupo de nodos. Por ejemplo:

  /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
  

  Esta marca solo se aplica si integraste Distributed Cloud Connected con Cloud Key Management Service, como se describe en Cómo habilitar la compatibilidad con las claves de encriptación administradas por el cliente (CMEK) para el almacenamiento local.

  Para revertir un grupo de nodos para que use una clave administrada por Google, usa la marca --use-google-managed-key.

API

Realiza una solicitud PATCH al método projects.locations.clusters.nodePools.patch:

PATCH /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME?nodePoolId=NODEPOOL_ID&requestId=REQUEST_ID
{
 "name": POOL_NAME,
 "labels": { LABELS,
  },
 "nodeLocation": ZONE_NAME,
 "nodeCount": NODE_COUNT,
 "machineFilter": MACHINE_FILTER,
 "localDiskEncryption": {
   "kmsKey": KMS_KEY,
  }
}

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
• REGION: Es la Google Cloud región en la que se aloja el clúster de Distributed Cloud conectado asociado con este grupo de nodos.
• CLUSTER_NAME: Es el nombre del clúster conectado de Distributed Cloud de destino.
• NODEPOOL_ID: Es un ID programático único que identifica este grupo de nodos.
• REQUEST_ID: Es un ID programático único que identifica esta solicitud.
• POOL_NAME: Es un nombre descriptivo que identifica de forma única este grupo de nodos.
• LABELS: Es una lista de etiquetas que se aplicarán a este recurso de grupo de nodos.
• ZONE_NAME: Es el nombre de la zona conectada de Distributed Cloud de destino. Esta zona debe estar en la región especificada en REGION.
• NODE_COUNT: Es la cantidad de nodos que contiene este grupo de nodos.
• MACHINE_FILTER (opcional): Especifica los criterios de filtrado para la selección de máquinas. Solo se pueden unir al grupo de nodos las máquinas que coincidan con este filtro. En el caso de los clústeres de varios racks, usa esta marca para especificar los racks conectados de Distributed Cloud cuyos nodos componen este grupo de nodos.

• KMS_KEY (opcional): Es la ruta de acceso completa a la clave de Cloud KMS que deseas usar con este grupo de nodos. Por ejemplo:

  /projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
  

  Este parámetro solo se aplica si integraste Distributed Cloud Connected con Cloud Key Management Service, como se describe en Cómo habilitar la compatibilidad con las claves de encriptación administradas por el cliente (CMEK) para el almacenamiento local.

Borrar un grupo de nodos

Para borrar un grupo de nodos de Distributed Cloud, completa los pasos de esta sección.

Para completar esta tarea, debes tener el rol de administrador de contenedores perimetrales (roles/edgecontainer.admin) en tu proyecto de Google Cloud .

gcloud

Usa el comando gcloud edge-cloud container clusters node-pools delete:

gcloud edge-cloud container clusters node-pools delete POOL_NAME \
    --project=PROJECT_ID \
    --location=REGION \
    --cluster=CLUSTER_NAME

Reemplaza lo siguiente:

• POOL_NAME: Es el nombre del grupo de nodos de destino.
• PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
• REGION: Es la Google Cloud región en la que se aloja el clúster de Distributed Cloud conectado asociado con este grupo de nodos.
• CLUSTER_NAME: Es el nombre del clúster conectado de Distributed Cloud de destino.

API

Realiza una solicitud DELETE al método projects.locations.clusters.nodePools.delete:

DELETE /v1/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME/nodePools/POOL_NAME?requestId=REQUEST_ID

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto Google Cloud de destino.
• REGION: Es la Google Cloud región en la que se aloja el clúster de Distributed Cloud conectado asociado con este grupo de nodos.
• CLUSTER_NAME: Es el nombre del clúster conectado de Distributed Cloud de destino.
• POOL_NAME: Es el nombre del grupo de nodos de destino.
• REQUEST_ID: Es un ID programático único que identifica esta solicitud.

¿Qué sigue?

• Implementa cargas de trabajo en Distributed Cloud conectado
• Administrar zonas
• Administrar máquinas
• Cómo crear y administrar clústeres
• Cómo crear y administrar conexiones de VPN
• Administra máquinas virtuales
• Administra cargas de trabajo de GPU