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.

Em servidores conectados do Distributed Cloud, os pools de nós são criados e preenchidos automaticamente quando você cria um cluster. Você também tem a opção de 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 conectado funciona.

Observação :as instruções da CLI do Google Cloud 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 desta seção.

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

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

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

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

Console

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

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

Substitua:

• POOL_NAME: um nome descritivo que identifica exclusivamente esse pool de nós. Esse nome precisa estar em conformidade com a RFC 1213 e consistir apenas em caracteres alfanuméricos minúsculos e hifens (-). Ele precisa começar e terminar com um caractere alfanumérico.
• PROJECT_ID: o ID doprojeto de destino. Google Cloud
• REGION: aregião em que o Google Cloud cluster conectado do Distributed Cloud de destino 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 esse pool de nós contém.
• NODE_LABELS: uma lista separada 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 filtrados, 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 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. 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 esse pool de nós. Exemplo:

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

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

API

Faça uma solicitação POST para o 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 doprojeto de destino. Google Cloud
• REGION: aregião em que o Google Cloud cluster conectado do Distributed Cloud de destino 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 essa solicitação.
• POOL_NAME: um nome descritivo que identifica exclusivamente esse pool de nós.
• LABELS: uma lista de rótulos a serem aplicados a esse recurso de pool de nós.
• ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino. Essa zona precisa estar na região especificada em REGION.
• NODE_COUNT: o número de nós que esse pool de nós contém.
• NODE_LABELS: uma lista separada 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 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. 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 esse pool de nós. Exemplo:

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

  Esse parâmetro só será aplicado se você tiver integrado o Distributed Cloud conectado ao Cloud Key Management Service, conforme descrito em Ativar o suporte a 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 seu Google Cloud projeto.

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 doprojeto de destino. Google Cloud
• REGION: a Google Cloud região em que o cluster conectado do Distributed Cloud de destino foi criado.
• CLUSTER_NAME: o nome do cluster conectado do Distributed Cloud de destino.

API

Faça uma solicitação GET para o 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 doprojeto de destino. Google Cloud
• REGION: aregião em que o cluster conectado do Distributed Cloud de destino foi criado. Google Cloud
• 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 separada por vírgulas de nomes de campos pelos quais os resultados retornados são classificados. A ordem de classificação padrão é crescente. Para a ordem de classificação decrescente, adicione o campo desejado com ~.
• PAGE_TOKEN: um token recebido na resposta à última solicitação de lista no campo nextPageToken na resposta. Envie esse token para receber uma página de resultados.

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

Para receber 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 seu Google Cloud projeto.

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 doprojeto de destino. Google Cloud
• REGION: a Google Cloud região em que o cluster conectado do Distributed Cloud associado a esse 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 para o método projects.locations.clusters.nodePools.get:

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

Substitua:

• PROJECT_ID: o ID doprojeto de destino. Google Cloud
• REGION: a Google Cloud região em que o cluster conectado do Distributed Cloud associado a esse 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 desta seção.

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

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

Substitua:

• POOL_NAME: o nome do pool de nós de destino.
• PROJECT_ID: o ID doprojeto de destino. Google Cloud
• REGION: a Google Cloud região em que o cluster conectado do Distributed Cloud associado a esse pool de nós está hospedado.
• CLUSTER_NAME: o nome do cluster conectado do Distributed Cloud de destino.
• NODE_COUNT: o número de nós que esse 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 filtrados, 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.

API

Faça uma solicitação PATCH para o 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 doprojeto de destino. Google Cloud
• REGION: a Google Cloud região em que o cluster conectado do Distributed Cloud associado a 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 pool de nós.
• REQUEST_ID: um ID programático exclusivo que identifica essa solicitação.
• POOL_NAME: um nome descritivo que identifica exclusivamente esse pool de nós.
• LABELS: uma lista de rótulos a serem aplicados a esse recurso de pool de nós.
• ZONE_NAME: o nome da zona conectada do Distributed Cloud de destino. Essa zona precisa estar na região especificada em REGION.
• NODE_COUNT: o número de nós que esse 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 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.

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

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

  Esse parâmetro só será aplicado se você tiver integrado o Distributed Cloud conectado ao Cloud Key Management Service, conforme descrito em Ativar o suporte a 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 desta seção.

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

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 doprojeto de destino. Google Cloud
• REGION: a Google Cloud região em que o cluster conectado do Distributed Cloud associado a esse 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 para o 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 doprojeto de destino. Google Cloud
• REGION: a Google Cloud região em que o cluster conectado do Distributed Cloud associado a esse 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 essa 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 da GPU