Criar e gerenciar pools de nós

Nesta página, descrevemos como criar e gerenciar recursos de pool de nós do Google Distributed Cloud em uma zona do Distributed Cloud.

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

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:

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 \
    --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 de destino do Distributed Cloud para esse pool de nós está hospedado.
  • CLUSTER_NAME: o nome do cluster de destino do Distributed Cloud.
  • 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.
  • 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.

  • 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 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,   
 "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 de destino do Distributed Cloud para esse pool de nós está hospedado.
  • CLUSTER_NAME: o nome do cluster de destino do Distributed Cloud.
  • 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 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.
  • 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.

  • 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 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 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 de destino do Distributed Cloud foi criado.
  • CLUSTER_NAME: o nome do cluster de destino do Distributed Cloud.

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: a Google Cloud região em que o cluster de destino do Distributed Cloud 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 de nomes de campos separados por vírgulas 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: aregião em que o Google Cloud cluster do Distributed Cloud associado a esse pool de nós está hospedado.
  • CLUSTER_NAME: o nome do cluster de destino do Distributed Cloud.

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: aregião em que o Google Cloud cluster do Distributed Cloud associado a esse pool de nós está hospedado.
  • CLUSTER_NAME: o nome do cluster de destino do Distributed Cloud.
  • 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: aregião em que o Google Cloud cluster do Distributed Cloud associado a esse pool de nós está hospedado.
  • CLUSTER_NAME: o nome do cluster de destino do Distributed Cloud.
  • 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.

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: aregião em que o Google Cloud cluster do Distributed Cloud associado a esse pool de nós está hospedado.
  • CLUSTER_NAME: o nome do cluster de destino do Distributed Cloud.
  • 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 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.
  • 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.

  • 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 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: aregião em que o Google Cloud cluster do Distributed Cloud associado a esse pool de nós está hospedado.
  • CLUSTER_NAME: o nome do cluster de destino do Distributed Cloud.

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: aregião em que o Google Cloud cluster do Distributed Cloud associado a esse pool de nós está hospedado.
  • CLUSTER_NAME: o nome do cluster de destino do Distributed Cloud.
  • 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