Criar e gerenciar pools de nós

Esta página descreve como criar e gerenciar recursos de pool de nós do Google Distributed Cloud em uma zona conectada do Distributed Cloud.

Nos servidores conectados do Distributed Cloud, os pools de nós são criados e preenchidos automaticamente quando você cria um cluster. Você também pode configurar outros pools de nós depois de criar o cluster.

Para mais informações sobre pools de nós do Distributed Cloud, consulte Como o Distributed Cloud Connected funciona.

Observação: as instruções da Google Cloud CLI nesta página pressupõem que você esteja usando o Cloud Shell ou outro ambiente com bash instalado.

Crie um pool de nós.

Para criar um pool de nós do Distributed Cloud, siga as etapas nesta seção.

Para concluir essa tarefa, você precisa ter os seguintes papéis no seu projetoGoogle Cloud :

• Papel de administrador do Edge Container (roles/edgecontainer.admin)

• Papel de usuário do Edge Container Machine (roles/edgecontainer.machineUser)

  Você também precisa ter essa função no projeto Google Cloud que contém as máquinas conectadas do Distributed Cloud que serão atribuídas a esse pool de nós se o projeto for diferente do projetoGoogle Cloud em que você está criando o pool de nós.

Console

Se você estiver usando o console Google Cloud , só poderá criar um pool de nós ao criar um cluster. Para criar um pool de nós independente, use a Google Cloud CLI ou a API Distributed Cloud Edge Container.

gcloud

Use o 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

Substitua:

• POOL_NAME: um nome descritivo que identifica exclusivamente este pool de nós. O nome precisa estar em conformidade com a RFC 1213 e consistir apenas de caracteres alfanuméricos minúsculos e hifens (-). Ele precisa começar e terminar com um caractere alfanumérico.
• PROJECT_ID: o ID do projeto Google Cloud de destino.
• REGION: a região Google Cloud em que o cluster de destino do Distributed Cloud Connected para esse pool de nós está hospedado.
• CLUSTER_NAME: o nome do cluster conectado do Distributed Cloud de destino.
• ZONE_NAME: o nome da zona de destino do Distributed Cloud. Essa zona precisa estar na região especificada em REGION.
• NODE_COUNT: o número de nós que este pool de nós contém.
• NODE_LABELS: uma lista delimitada por vírgulas de pares de chave-valor que compreendem rótulos para os nós individuais no pool de nós.
• MACHINE_FILTER (opcional): especifica os critérios de filtragem para a seleção de máquinas. Para conferir os campos que podem ser usados para filtrar, consulte Receber informações sobre uma máquina. Somente as máquinas que correspondem a esse filtro podem participar desse pool de nós. Para clusters multirrack, use esta flag para especificar os racks conectados do Distributed Cloud cujos nós compõem esse pool de nós. Se omitido, todos os nós disponíveis na zona serão adicionados a esse pool de nós.

• POOL_KMS_KEY (opcional): o caminho completo para a chave do Cloud KMS que você quer usar com este pool de nós. Exemplo:

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

  Essa flag só se aplica se você tiver integrado o Distributed Cloud Connected ao Cloud Key Management Service, conforme descrito em Ativar o suporte para chaves de criptografia gerenciadas pelo cliente (CMEK) para armazenamento local.

• WORKER_NODE_STORAGE_SCHEMA (opcional): especifica o esquema de armazenamento local para os nós de trabalho incluídos nesse pool de nós. Para mais informações, consulte Configurar esquemas de armazenamento local.

API

Faça uma solicitação POST ao 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,
  }
}

Substitua:

• PROJECT_ID: o ID do projeto Google Cloud de destino.
• REGION: a região Google Cloud em que o cluster de destino do Distributed Cloud Connected para esse pool de nós está hospedado.
• CLUSTER_NAME: o nome do cluster conectado do Distributed Cloud de destino.
• NODEPOOL_ID: um ID programático exclusivo que identifica esse recurso de pool de nós.
• REQUEST_ID: um ID programático exclusivo que identifica esta solicitação.
• POOL_NAME: um nome descritivo que identifica exclusivamente este pool de nós.
• LABELS: uma lista de rótulos a serem aplicados a esse recurso do pool de nós.
• ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud. Essa zona precisa estar na região especificada em REGION.
• NODE_COUNT: o número de nós que este pool de nós contém.
• NODE_LABELS: uma lista delimitada por vírgulas de pares de chave-valor que compreendem rótulos para os nós individuais no pool de nós.
• MACHINE_FILTER (opcional): especifica os critérios de filtragem para a seleção de máquinas. Somente as máquinas que correspondem a esse filtro podem participar desse pool de nós. Para clusters multirrack, use essa flag para especificar os racks conectados do Distributed Cloud cujos nós compõem esse pool de nós. Se omitido, todos os nós disponíveis na zona serão adicionados a este pool de nós.

• POOL_KMS_KEY (opcional): o caminho completo para a chave do Cloud KMS que você quer usar com este pool de nós. Exemplo:

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

  Esse parâmetro só se aplica se você tiver integrado o Distributed Cloud Connected ao Cloud Key Management Service, conforme descrito em Ativar o suporte para chaves de criptografia gerenciadas pelo cliente (CMEK) para armazenamento local.

Listar pools de nós

Para listar os pools de nós do Distributed Cloud disponíveis em uma zona conectada do Distributed Cloud, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de Leitor do Edge Container (roles/edgecontainer.viewer) no projeto Google Cloud .

gcloud

Use o 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

Substitua:

• PROJECT_ID: o ID do projeto Google Cloud de destino.
• REGION: a região do Google Cloud em que o cluster de destino do Distributed Cloud conectado foi criado.
• CLUSTER_NAME: o nome do cluster conectado do Distributed Cloud de destino.

API

Faça uma solicitação GET ao 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

Substitua:

• PROJECT_ID: o ID do projeto Google Cloud de destino.
• REGION: a Google Cloud região em que o cluster de destino do Distributed Cloud Connected foi criado.
• CLUSTER_NAME: o nome do cluster de destino do Distributed Cloud.
• FILTER: uma expressão que restringe os resultados retornados a valores específicos.
• PAGE_SIZE: o número de resultados a serem retornados por página.
• SORT_BY: uma lista delimitada por vírgulas de nomes de campos pelos quais os resultados retornados são classificados. A ordem de classificação padrão é crescente. Para classificar em ordem decrescente, adicione o prefixo ~ ao campo desejado.
• PAGE_TOKEN: um token recebido na resposta à última solicitação de lista no campo nextPageToken da resposta. Envie esse token para receber uma página de resultados.

Receber informações sobre um pool de nós

Para informações sobre um pool de nós do Distributed Cloud, siga as etapas desta seção.

Para concluir essa tarefa, você precisa ter o papel de Leitor do Edge Container (roles/edgecontainer.viewer) no projeto Google Cloud .

gcloud

Use o 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

Substitua:

• POOL_NAME: o nome do pool de nós de destino.
• PROJECT_ID: o ID do projeto Google Cloud de destino.
• REGION: a região Google Cloud em que o cluster conectado do Distributed Cloud associado a este pool de nós está hospedado.
• CLUSTER_NAME: o nome do cluster conectado do Distributed Cloud de destino.

API

Faça uma solicitação GET ao método projects.locations.clusters.nodePools.get:

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

Substitua:

• PROJECT_ID: o ID do projeto Google Cloud de destino.
• REGION: a região Google Cloud em que o cluster conectado do Distributed Cloud associado a este pool de nós está hospedado.
• CLUSTER_NAME: o nome do cluster conectado do Distributed Cloud de destino.
• POOL_NAME: o nome do pool de nós de destino.

Modificar um pool de nós

Para modificar um pool de nós do Distributed Cloud, siga as etapas nesta seção.

Para concluir essa tarefa, você precisa ter o papel de Administrador de contêineres de borda (roles/edgecontainer.admin) no seu projeto Google Cloud .

gcloud

Use o 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

Substitua:

• POOL_NAME: o nome do pool de nós de destino.
• PROJECT_ID: o ID do projeto Google Cloud de destino.
• REGION: a região Google Cloud em que o cluster conectado do Distributed Cloud associado a este pool de nós está hospedado.
• CLUSTER_NAME: o nome do cluster de destino do Distributed Cloud Connected.
• NODE_COUNT: o número de nós que este pool de nós contém.
• MACHINE_FILTER (opcional): especifica os critérios de filtragem para a seleção de máquinas. Para conferir os campos que podem ser usados para filtrar, consulte Receber informações sobre uma máquina. Para clusters de vários racks, use essa flag para especificar os racks conectados do Distributed Cloud cujos nós compõem esse pool de nós.

• POOL_KMS_KEY (opcional): o caminho completo para a chave do Cloud KMS que você quer usar com este pool de nós. Exemplo:

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

  Essa flag só se aplica se você tiver integrado o Distributed Cloud Connected ao Cloud Key Management Service, conforme descrito em Ativar o suporte para chaves de criptografia gerenciadas pelo cliente (CMEK) para armazenamento local.

  Para reverter um pool de nós para usar um Google-owned and Google-managed encryption key, use a flag --use-google-managed-key.

API

Faça uma solicitação PATCH ao 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,
  }
}

Substitua:

• PROJECT_ID: o ID do projeto Google Cloud de destino.
• REGION: a região Google Cloud em que o cluster conectado do Distributed Cloud associado a este pool de nós está hospedado.
• CLUSTER_NAME: o nome do cluster conectado do Distributed Cloud de destino.
• NODEPOOL_ID: um ID programático exclusivo que identifica este pool de nós.
• REQUEST_ID: um ID programático exclusivo que identifica esta solicitação.
• POOL_NAME: um nome descritivo que identifica exclusivamente este pool de nós.
• LABELS: uma lista de rótulos a serem aplicados a esse recurso do pool de nós.
• ZONE_NAME: o nome da zona conectada de destino do Distributed Cloud. Essa zona precisa estar na região especificada em REGION.
• NODE_COUNT: o número de nós que este pool de nós contém.
• MACHINE_FILTER (opcional): especifica os critérios de filtragem para a seleção de máquinas. Somente as máquinas que correspondem a esse filtro podem participar desse pool de nós. Para clusters multirrack, use essa flag para especificar os racks conectados do Distributed Cloud cujos nós compõem esse pool de nós.

• KMS_KEY (opcional): o caminho completo para a chave do Cloud KMS que você quer usar com este pool de nós. Exemplo:

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

  Esse parâmetro só se aplica se você tiver integrado o Distributed Cloud Connected ao Cloud Key Management Service, conforme descrito em Ativar o suporte para chaves de criptografia gerenciadas pelo cliente (CMEK) para armazenamento local.

Excluir um pool de nós

Para excluir um pool de nós do Distributed Cloud, siga as etapas nesta seção.

Para concluir essa tarefa, você precisa ter o papel de Administrador de contêineres de borda (roles/edgecontainer.admin) no seu projeto Google Cloud .

gcloud

Use o 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

Substitua:

• POOL_NAME: o nome do pool de nós de destino.
• PROJECT_ID: o ID do projeto Google Cloud de destino.
• REGION: a região Google Cloud em que o cluster conectado do Distributed Cloud associado a este pool de nós está hospedado.
• CLUSTER_NAME: o nome do cluster conectado do Distributed Cloud de destino.

API

Faça uma solicitação DELETE ao método projects.locations.clusters.nodePools.delete:

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

Substitua:

• PROJECT_ID: o ID do projeto Google Cloud de destino.
• REGION: a região Google Cloud em que o cluster conectado do Distributed Cloud associado a este pool de nós está hospedado.
• CLUSTER_NAME: o nome do cluster conectado do Distributed Cloud de destino.
• POOL_NAME: o nome do pool de nós de destino.
• REQUEST_ID: um ID programático exclusivo que identifica esta solicitação.

A seguir

• Implantar cargas de trabalho no Distributed Cloud conectado
• Gerenciar zonas
• Gerenciar máquinas
• Criar e gerenciar clusters
• Criar e gerenciar conexões VPN
• Gerenciar máquinas virtuais
• Gerenciar cargas de trabalho de GPU