Para informações sobre a versão, consulte as notas da versão do Distributed Cloud Connected.

Criar e gerenciar clusters

Nesta página, descrevemos como criar e gerenciar recursos de cluster conectado do Google Distributed Cloud.

Para mais informações sobre os clusters conectados do Distributed Cloud, consulte Como o Distributed Cloud Connected funciona.

Os servidores conectados do Distributed Cloud e as implantações de vários racks do Distributed Cloud Connected, em que um rack de base agrega os recursos de um ou mais racks autônomos, só oferecem suporte a clusters de plano de controle local. Não é possível criar clusters do plano de controle do Cloud nesses tipos de implantação.

Criar um cluster

Para criar um cluster conectado da Distributed Cloud, siga as etapas nesta seção. Criar um cluster é uma das várias etapas necessárias para implantar uma carga de trabalho no Distributed Cloud Connected.

Para criar um cluster com um plano de controle local que possa executar cargas de trabalho enquanto estiver temporariamente desconectado do Google Cloud, primeiro leia Modo de sobrevivência.

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

Console

No Google Cloud console, acesse a página Clusters.

Acessar Clusters
Clique em Criar cluster.
Na página Criar um cluster, clique na guia Local.
Ao lado da opção Distributed Cloud Edge, clique em Configurar.
Na página Princípios básicos do cluster, forneça as seguintes informações:
- Nome: um nome exclusivo que identifica o cluster. O 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.
- Local: a Google Cloud região em que você quer criar esse cluster.
- Máximo de pods padrão por nó: o número máximo desejado de pods do Kubernetes a serem executados em cada nó deste cluster.
- Rótulos: permite adicionar um ou mais rótulos ao cluster clicando em Adicionar rótulo.
Na navegação à esquerda, clique em Rede.
Na página Rede, forneça as seguintes informações:
- Intervalo de endereços de pod padrão do cluster: o bloco CIDR IPv4 desejado para pods do Kubernetes que são executados neste cluster.
- Intervalo de endereços de serviço: o bloco CIDR IPv4 desejado para serviços do Kubernetes executados neste cluster.
Para mais informações, consulte Alocação de endereços de rede de serviços e pods do Distributed Cloud.
Na navegação à esquerda, clique em Autorização.
Na página Autorização, informe o nome da conta de usuário no projeto Google Cloud de destino que está autorizada a modificar recursos do cluster.
Na navegação à esquerda, clique em Política de manutenção.

Aviso: um cluster conectado do Distributed Cloud não tem uma janela de manutenção padrão. Isso significa que uma atualização de software pode potencialmente derrubar uma carga de trabalho crítica. Para garantir a alta disponibilidade, configure janelas de manutenção escalonadas para seus clusters do Distributed Cloud. Assim, as atualizações de software ocorrem em momentos diferentes, e suas cargas de trabalho permanecem disponíveis.
Na página Política de manutenção, forneça as seguintes informações:
- Ativar janela de manutenção: marque essa caixa de seleção para configurar uma janela de manutenção para o cluster. Para evitar tempo de inatividade inesperado causado por atualizações de software conectado do Distributed Cloud, recomendamos que você sempre configure uma janela de manutenção para cada cluster do Distributed Cloud criado. Para mais informações, consulte Entenda as atualizações de software e as janelas de manutenção.
- Horário de início: a data e a hora desejadas em que a janela de manutenção começa para esse cluster.
- Horário de término: a data e a hora desejadas em que a janela de manutenção termina para esse cluster.
- RRule: a frequência da janela de manutenção no formato FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
  - FREQ pode ser DAILY ou WEEKLY.
  - BYDAY: uma lista delimitada por vírgulas de dias em que a manutenção pode ocorrer se FREQ estiver definido como WEEKLY. Se você omitir o parâmetro BYDAY, o Google vai escolher o dia da semana para você.
  - Se você definir FREQ como DAILY, as janelas de manutenção vão ocorrer todos os dias durante as horas especificadas.
Atribua um pool de nós ao cluster fazendo uma destas ações:
- Para atribuir um pool de nós atual a esse cluster, na seção Pools de nós da navegação à esquerda, selecione o pool de nós atual e verifique se a configuração do pool de nós na página Detalhes do pool de nós está correta.
- Para criar um pool de nós e atribuir a este cluster, clique em add_boxAdicionar pool de nós e forneça as seguintes informações na página Detalhes do pool de nós:
  - Nome do pool de nós: um nome exclusivo que identifica esse pool de nós.
  - Rótulos do pool de nós: clique em Adicionar rótulo para incluir um ou mais rótulos nesse pool de nós.
  - Preferência de nós de trabalho: selecione os nós conectados do Distributed Cloud para atribuir a este pool de nós.
Para criar o cluster conectado do Distributed Cloud, clique em Criar.

gcloud

Use o comando gcloud edge-cloud container clusters create:

gcloud edge-cloud container clusters create CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --fleet-project=FLEET_PROJECT_ID \
    --cluster-ipv4-cidr=CLUSTER_IPV4_CIDR_BLOCK \
    --services-ipv4-cidr=SERVICE_IPV4_CIDR_BLOCK \
    --default-max-pods-per-node=MAX_PODS_PER_NODE \
    --release-channel RELEASE_CHANNEL \
    --control-plane-kms-key=CONTROL_PLANE_KMS_KEY \
    --control-plane-node-location=CONTROL_PLANE_LOCATION \
    --control-plane-node-count=CONTROL_PLANE_NODE_COUNT \
    --control-plane-machine-filter=CONTROL_PLANE_NODE_FILTER \
    --control-plane-shared-deployment-policy=CONTROL_PLANE_NODE_SHARING \
    --external-lb-ipv4-address-pools=IPV4_DATA_PLANE_ADDRESSES \
    --version SOFTWARE_VERSION \
    --offline-reboot-ttl REBOOT_TIMEOUT

Substitua:

CLUSTER_ID: um nome exclusivo que identifica o cluster. O 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 do projeto Google Cloud de destino.
REGION: a região Google Cloud em que o cluster é criado e em que o plano de controle do Kubernetes para o cluster é provisionado.
FLEET_PROJECT_ID: o ID do projeto host da frota em que o cluster está registrado. Se essa flag for omitida, o projeto do cluster conectado do Distributed Cloud será usado como o projeto host da frota.
CLUSTER_IPV4_CIDR_BLOCK: o bloco CIDR IPv4 desejado para pods do Kubernetes que são executados nesse cluster.
SERVICE_IPV4_CIDR_BLOCK: o bloco CIDR IPv4 desejado para serviços do Kubernetes executados neste cluster.
MAX_PODS_PER_NODE (opcional): o número máximo desejado de pods do Kubernetes a serem executados em cada nó deste cluster.
RELEASE_CHANNEL: (opcional) especifica o canal de lançamento da versão do software do Distributed Cloud que você quer que este cluster execute. Os valores válidos são REGULAR (ativar upgrades automáticos do cluster) e NONE (desativar upgrades automáticos do cluster). Se omitido, o padrão é REGULAR.
CONTROL_PLANE_KMS_KEY (opcional): o caminho completo para a chave do Cloud KMS que você quer usar com o nó do plano de controle deste cluster. 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.

Se você estiver criando um cluster com um plano de controle local, além de substituir as variáveis anteriores, substitua também o seguinte:

CONTROL_PLANE_LOCATION: instrui o Distributed Cloud a implantar as cargas de trabalho do plano de controle para esse cluster localmente. O valor é o nome da zona conectada de destino da nuvem distribuída.
CONTROL_PLANE_NODE_COUNT (opcional): especifica o número de nós em que executar as cargas de trabalho do plano de controle local. Os valores válidos são 3 para alta disponibilidade e 1 para operação padrão. Se omitido, o padrão é 3.
CONTROL_PLANE_NODE_FILTER (opcional): especifica uma lista de nós formatada com regex que executa as cargas de trabalho do plano de controle local. Se omitido, o Distributed Cloud selecionará os nós automaticamente de forma aleatória.
CONTROL_PLANE_NODE_SHARING: (opcional) especifica se as cargas de trabalho de aplicativos podem ser executadas nos nós que executam as cargas de trabalho do plano de controle local. Os valores válidos são DISALLOWED e ALLOWED. Se omitido, o padrão será DISALLOWED.
IPV4_DATA_PLANE_ADDRESSES: especifica uma lista delimitada por vírgulas de endereços IPv4, intervalos de endereços ou sub-redes para tráfego de entrada de serviços executados por trás do balanceador de carga do Distributed Cloud quando o cluster está no modo de capacidade de sobrevivência.
SOFTWARE_VERSION: especifica a versão do software do Distributed Cloud Connected que você quer que este cluster execute no formato 1.X.Y, em que X é a versão secundária e Y é a versão de patch, por exemplo, 1.5.1. Se omitido, o padrão será a versão de software padrão do servidor, que geralmente é a versão mais recente disponível do Distributed Cloud Connected. Para conferir as versões de software disponíveis para criação de clusters, incluindo a versão padrão do servidor, consulte Receber as versões de software disponíveis para um cluster. Defina a flag RELEASE_CHANNEL como NONE para especificar uma versão do software do cluster.
REBOOT_TIMEOUT: (requer gcloud alpha) especifica um período em segundos durante o qual um nó do cluster pode se reconectar a um cluster após a reinicialização enquanto o cluster está em execução no modo de capacidade de sobrevivência. Se omitido, o padrão será 0, que não permite que os nós reinicializados voltem a participar do cluster até que a conexão com Google Cloud seja restabelecida. Este é um recurso em pré-lançamento.

ATENÇÃO: se você especificar uma janela de tempo limite de reinicialização, os nós que ficaram off-line poderão ser reinicializados e entrar novamente no cluster, mesmo que você desative ou exclua a chave de armazenamento pelo tempo especificado.

API

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

POST /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&requestId=REQUEST_ID&fleetId=FLEET_PROJECT_ID

{
  "labels": { LABELS,
  },
  "authorization": {
    "adminUsers": {
      "username": "USERNAME"
    }
  },
  "fleet": {
    "project": "FLEET_PROJECT_ID"
  },
  "networking": {
    "clusterIpv4CidrBlocks": CLUSTER_IPV4_CIDR_BLOCK,
    "servicesIpv4CidrBlocks": SERVICE_IPV4_CIDR_BLOCK,
      },
  "defaultMaxPodsPerNode": MAX_PODS_PER_NODE,
  "releaseChannel": "RELEASE_CHANNEL",
  "controlPlaneEncryption": {
   "kmsKey": CONTROL_PLANE_KMS_KEY,
  },      
  "controlPlane": {
    "local": {
      "nodeLocation": "CONTROL_PLANE_LOCATION",
      "nodeCount": CONTROL_PLANE_NODE_COUNT,
      "machineFilter": "CONTROL_PLANE_NODE_FILTER",
      "sharedDeploymentPolicy": "CONTROL_PLANE_NODE_SHARING"
    }
  },
  "externalLoadBalancerIpv4AddressPools": [
    "IPV4_DATA_PLANE_ADDRESSES"
  ],
  "targetVersion": "SOFTWARE_VERSION",
  "offlineRebootTtl": "REBOOT_TIMEOUT",
}

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 é criado.
CLUSTER_ID: um nome exclusivo que identifica o cluster. O 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.
REQUEST_ID: um ID programático exclusivo que identifica esta solicitação.
FLEET_PROJECT_ID: o ID do projeto host da frota em que o cluster está registrado. Pode ser um projeto separado ou o projeto conectado da Distributed Cloud a que este cluster pertence (PROJECT_ID). O registro da frota é obrigatório.
LABELS: uma lista de rótulos a serem aplicados a esse recurso de cluster.
USERNAME: o nome da conta de usuário no projeto Google Cloud de destino autorizada a modificar recursos do cluster.
CLUSTER_IPV4_CIDR_BLOCK: o bloco CIDR IPv4 desejado para pods do Kubernetes que são executados nesse cluster.
SERVICE_IPV4_CIDR_BLOCK: o bloco CIDR IPv4 desejado para serviços do Kubernetes executados neste cluster.
MAX_PODS_PER_NODE: o número máximo desejado de pods do Kubernetes a serem executados em cada nó deste cluster.
RELEASE_CHANNEL: (opcional) especifica o canal de lançamento da versão do software conectado do Distributed Cloud que você quer que o cluster execute. Os valores válidos são REGULAR (ativar upgrades automáticos do cluster) e NONE (desativar upgrades automáticos do cluster). Se omitido, o padrão é REGULAR.
CONTROL_PLANE_KMS_KEY (opcional): o caminho completo para a chave do Cloud KMS que você quer usar com o nó do plano de controle deste cluster. 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.

Se você estiver criando um cluster com um plano de controle local, além de substituir as variáveis anteriores, substitua também o seguinte:

CONTROL_PLANE_LOCATION: instrui o Distributed Cloud a implantar as cargas de trabalho do plano de controle para esse cluster localmente. O valor é o nome da zona de destino do Distributed Cloud.
CONTROL_PLANE_NODE_COUNT: especifica o número de nós em que executar as cargas de trabalho do plano de controle local. Os valores válidos são 3 para alta disponibilidade e 1 para operação padrão.
CONTROL_PLANE_NODE_FILTER (opcional): especifica uma lista de nós formatada com regex que executa as cargas de trabalho do plano de controle local. Se omitido, o Distributed Cloud selecionará os nós automaticamente de forma aleatória.
CONTROL_PLANE_NODE_SHARING: especifica se as cargas de trabalho de aplicativos podem ser executadas nos nós que executam as cargas de trabalho do plano de controle local. Os valores válidos são DISALLOWED e ALLOWED. Se omitido, o padrão será DISALLOWED.
IPV4_DATA_PLANE_ADDRESSES: especifica uma lista delimitada por vírgulas de endereços IPv4, intervalos de endereços ou sub-redes para tráfego de entrada de serviços executados por trás do balanceador de carga do Distributed Cloud em um cluster de plano de controle local. Não se aplica a clusters do plano de controle do Cloud.
SOFTWARE_VERSION: especifica a versão do software do Distributed Cloud em que você quer executar este cluster no formato 1.X.Y, em que X é a versão secundária e Y é a versão do patch. Por exemplo, 1.5.1. Se omitido, o padrão será a versão de software padrão do servidor, que geralmente é a versão mais recente disponível do Distributed Cloud Connected. Para conferir as versões de software disponíveis para criação de clusters, incluindo a versão padrão do servidor, consulte Receber as versões de software disponíveis para um cluster. Defina o campo RELEASE_CHANNEL como NONE para especificar uma versão do software do cluster.
REBOOT_TIMEOUT: (requer v1alpha1) especifica um período em segundos durante o qual um nó do cluster pode se reconectar a um cluster após a reinicialização enquanto o cluster está em execução no modo de capacidade de sobrevivência. Se omitido, o padrão será 0, que não permite que os nós reinicializados voltem a participar do cluster até que a conexão com Google Cloud seja restabelecida. Este é um recurso em pré-lançamento.

ATENÇÃO: se você especificar uma janela de tempo limite de reinicialização, os nós que ficaram off-line poderão ser reinicializados e entrar novamente no cluster, mesmo que você desative ou exclua a chave de armazenamento pelo tempo especificado.

Listar clusters em uma região

Para listar os clusters conectados do Distributed Cloud provisionados em uma regiãoGoogle 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 .

Console

No Google Cloud console, acesse a página Clusters.

Acessar Clusters
Examine a lista de clusters.

gcloud

Use o comando gcloud edge-cloud container clusters list:

gcloud edge-cloud container clusters list \
    --project=PROJECT_ID \
    --location=REGION

Substitua:

PROJECT_ID: o ID do projeto Google Cloud de destino.
REGION: a região Google Cloud em que você criou o cluster conectado do Distributed Cloud.

API

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

GET /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

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 é criado.
CLUSTER_ID: o nome do cluster de destino.
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 cluster

Para receber informações sobre um cluster conectado do Distributed Cloud, conclua 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 .

Console

No Google Cloud console, acesse a página Clusters.

Acessar Clusters
Selecione o cluster desejado.

Um painel expansível com informações detalhadas sobre o cluster aparece no painel à direita.

gcloud

Use o comando gcloud edge-cloud container clusters describe:

gcloud edge-cloud container clusters describe CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

Substitua:

CLUSTER_ID: o nome do cluster de destino.
PROJECT_ID: o ID do projeto Google Cloud de destino.
REGION: a região Google Cloud em que você criou sua zona conectada do Distributed Cloud.

API

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

GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID

Substitua:

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

Receber as versões de software disponíveis para um cluster

Para saber quais versões de software conectadas ao Distributed Cloud estão disponíveis na sua zona conectada ao Distributed Cloud para criar clusters, siga as etapas nesta 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 get-server-config:

gcloud edge-cloud container get-server-config --location=REGION

Substitua REGION: pela Google Cloud região em que você criou sua zona conectada do Distributed Cloud.

API

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

GET /v1/projects/PROJECT_ID/locations/REGION/serverConfig

Substitua:

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

Fazer upgrade da versão do software de um cluster de plano de controle local

Para fazer upgrade da versão do software de um cluster do plano de controle local conectado ao Distributed Cloud, siga as etapas desta seção. Esse recurso não está disponível para clusters do plano de controle do Cloud.

Dependendo do tipo de implantação, o software conectado do Distributed Cloud é atualizado da seguinte maneira:

Para implantações de servidor conectado do Distributed Cloud e implantações de rack conectado do Distributed Cloud usando um rack por zona, os nós em uma zona são atualizados e reinicializados um de cada vez.
Para implantações de racks conectados do Distributed Cloud usando vários racks por zona, todos os nós na zona são atualizados simultaneamente.

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 upgrade:

gcloud edge-cloud container clusters upgrade CLUSTER_ID \
   --location=REGION \
   --project=PROJECT_ID \
   --schedule=UPGRADE_SCHEDULE \
   --version=SOFTWARE_VERSION

Substitua:

CLUSTER_ID: o nome do cluster de destino.
REGION: a região Google Cloud em que o cluster de destino do Distributed Cloud foi criado.
PROJECT_ID: o ID do projeto Google Cloud de destino.
UPGRADE_SCHEDULE: especifica quando acionar o upgrade de software. O único valor válido é IMMEDIATELY.
SOFTWARE_VERSION: especifica a versão do software do Distributed Cloud em que você quer executar este cluster no formato 1.X.Y, em que X é a versão secundária e Y é a versão do patch. Por exemplo, 1.5.1. Para conferir as versões de software disponíveis para criação de clusters, incluindo a versão padrão do servidor, consulte Conferir as versões de software disponíveis para um cluster.

API

Faça uma solicitação POST ao método projects.locations.clusters.upgrade:

POST /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID:upgrade?requestId=REQUEST_ID
{
  "name": "projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID",
  "targetVersion": "SOFTWARE_VERSION",
    "schedule": "UPGRADE_SCHEDULE",
}

Substitua:

PROJECT_ID: o ID do projeto Google Cloud de destino.
REGION: a Google Cloud região em que o cluster conectado do Distributed Cloud de destino é criado.
CLUSTER_ID: o nome do cluster de destino.
REQUEST_ID: um ID programático exclusivo que identifica esta solicitação.
UPGRADE_SCHEDULE: especifica quando acionar o upgrade de software. O único valor válido é IMMEDIATELY.
SOFTWARE_VERSION: especifica a versão do software do Distributed Cloud Connected que você quer que este cluster execute no formato 1.X.Y, em que X é a versão secundária e Y é a versão de patch, por exemplo, 1.5.1. Para conferir as versões de software disponíveis para criação de clusters, incluindo a versão padrão do servidor, consulte Conferir as versões de software disponíveis para um cluster.

Um upgrade de software geralmente leva cerca de duas horas por nó que faz parte do pool de nós do cluster. O comando retorna uma operação que permite acompanhar o progresso do upgrade de software. Enquanto o upgrade de software está em andamento, o status do cluster é definido como Reconciling e retorna para Running quando o upgrade é concluído. Um status de cluster Error indica que a atualização de software falhou. Nesses casos, execute o processo de upgrade novamente. Consulte Receber informações sobre um cluster para saber como verificar o status dele.

Receber credenciais para um cluster

Para receber as credenciais de um cluster conectado 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 get-credentials:

gcloud edge-cloud container clusters get-credentials CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

Substitua:

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

API

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

GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID

Substitua:

PROJECT_ID: o ID do projeto Google Cloud de destino.
REGION: a Google Cloud região em que a zona de destino do Distributed Cloud é criada.
CLUSTER_ID: o nome do cluster de destino.

Configurar uma janela de manutenção para um cluster

Nesta seção, descrevemos como especificar e limpar uma janela de manutenção para um cluster conectado do Distributed Cloud.

Especificar uma janela de manutenção para um cluster

Para especificar uma janela de manutenção para um cluster conectado da nuvem distribuída, siga as etapas nesta seção. Para mais informações sobre a manutenção do cluster, consulte Entender atualizações de software e janelas de manutenção.

Para formatos de data e hora, use a RFC 5545.

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

Console

Se você estiver usando o console Google Cloud , só poderá especificar uma janela de manutenção ao criar um cluster. Para especificar uma janela de manutenção em um cluster atual, use a Google Cloud CLI ou a API Distributed Cloud Edge Container conectada.

gcloud

Use o comando gcloud edge-cloud container clusters update:

gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --maintenance-window-start=MAINTENANCE_START \
    --maintenance-window-end=MAINTENANCE_END \
    --maintenance-window-recurrence=MAINTENANCE_FREQUENCY

Substitua:

CLUSTER_ID: o nome do cluster de destino.
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 é criado.
MAINTENANCE_START: o horário de início da janela de manutenção no formato YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_END: o horário de término da janela de manutenção no formato YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_FREQUENCY: a frequência da janela de manutenção no formato FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
- BYDAY: uma lista delimitada por vírgulas de dias em que a manutenção pode ocorrer se FREQ estiver definido como WEEKLY. Se você omitir o parâmetro BYDAY, o Google vai escolher o dia da semana para você.
- Se você definir FREQ como "diário", as janelas de manutenção vão ocorrer todos os dias durante as horas especificadas.

API

Faça uma solicitação PATCH ao método projects.locations.clusters.update:

PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
 "maintenance_policy": {
   "window": {
     "recurring_window": {
       "window": {
         "start_time": "MAINTENANCE_START",
         "end_time": "MAINTENANCE_END"
         },
       "recurrence": "MAINTENANCE_FREQUENCY"
     }
   }
 }
}

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 é criado.
CLUSTER_ID: o nome do cluster de destino.
UPDATE_MASK: uma lista separada por vírgulas de nomes de campos totalmente qualificados a serem atualizados nesta solicitação no formato FieldMask.
REQUEST_ID: um ID programático exclusivo que identifica esta solicitação.
CLUSTER_ID: o nome do cluster de destino.
USERNAME: o nome da conta de usuário no projeto Google Cloud de destino autorizada a modificar recursos do cluster.
MAINTENANCE_START: o horário de início da janela de manutenção no formato YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_END: o horário de término da janela de manutenção no formato YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_FREQUENCY: a frequência da janela de manutenção no formato FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
- FREQ pode ser DAILY ou WEEKLY.
- BYDAY: uma lista delimitada por vírgulas de dias em que a manutenção pode ocorrer se FREQ estiver definido como WEEKLY. Se você omitir o parâmetro BYDAY, o Google vai escolher o dia da semana para você.
- Se você definir FREQ como "diário", as janelas de manutenção vão ocorrer todos os dias durante as horas especificadas.

Para mais informações, consulte Recurso: cluster.

Limpar a janela de manutenção de um cluster

Para limpar a janela de manutenção de um cluster conectado do Distributed Cloud, siga as etapas desta seção. Para mais informações sobre a manutenção do cluster, consulte Entender atualizações de software e janelas de manutençã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 update:

gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --clear-maintenance-window

Substitua:

CLUSTER_ID: o nome do cluster de destino.
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 é criado.

API

Faça uma solicitação PATCH ao método projects.locations.clusters.update:

PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
 "maintenance_policy": null
}

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 é criado.
CLUSTER_ID: o nome do cluster de destino.
UPDATE_MASK: uma lista separada por vírgulas de nomes de campos totalmente qualificados a serem atualizados nesta solicitação no formato FieldMask.
REQUEST_ID: um ID programático exclusivo que identifica esta solicitação.
USERNAME: o nome da conta de usuário no projeto Google Cloud de destino autorizada a modificar recursos do cluster.

Para mais informações, consulte Recurso: cluster.

Excluir um cluster

Para excluir um cluster conectado do Distributed Cloud, siga as etapas nesta seção. Antes de excluir um cluster, faça o seguinte:

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 delete:

gcloud edge-cloud container clusters delete CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

Substitua:

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

API

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

DELETE /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?requestId=REQUEST_ID

Substitua:

PROJECT_ID: o ID do projeto Google Cloud de destino.
REGION: a Google Cloud região em que o cluster conectado do Distributed Cloud de destino é criado.
CLUSTER_ID: o nome do cluster de destino.
REQUEST_ID: um ID programático exclusivo que identifica esta solicitação.

Criar e gerenciar clusters Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Criar um cluster

Console

gcloud

API

Listar clusters em uma região

Console

gcloud

API

Receber informações sobre um cluster

Console

gcloud

API

Receber as versões de software disponíveis para um cluster

gcloud

API

Fazer upgrade da versão do software de um cluster de plano de controle local

gcloud

API

Receber credenciais para um cluster

gcloud

API

Configurar uma janela de manutenção para um cluster

Especificar uma janela de manutenção para um cluster

Console

gcloud

API

Limpar a janela de manutenção de um cluster

gcloud

API

Excluir um cluster

gcloud

API

A seguir

Criar e gerenciar clusters