Criar um cluster do Autopilot

Confira nesta página como criar um cluster do Google Kubernetes Engine (GKE) no modo Autopilot. O Autopilot é um modo de operação do GKE que permite que você se concentre nos serviços e aplicativos enquanto o GKE gerencia os nós e a infraestrutura. Quando você implanta as cargas de trabalho, o GKE provisiona, configura e gerencia os recursos e o hardware, incluindo o escalonamento.

Antes de começar

Antes de começar, verifique se você realizou as tarefas a seguir:

  • Ativar a API Google Kubernetes Engine.
    • Ativar a API Google Kubernetes Engine
  • Se você quiser usar a Google Cloud CLI para essa tarefa, instale e, em seguida, inicialize a CLI gcloud. Se você instalou a CLI gcloud anteriormente, instale a versão mais recente executando gcloud components update.

Criar um cluster do Autopilot

É possível criar um cluster do Autopilot usando a CLI do Google Cloud, no console do Google Cloud ou usando o Terraform:

gcloud

Execute este comando:

gcloud container clusters create-auto CLUSTER_NAME \
    --location=LOCATION \
    --project=PROJECT_ID

Substitua:

  • CLUSTER_NAME: o nome do novo cluster de Autopilot.
  • LOCATION: a região para o cluster.
  • PROJECT_ID: o ID do projeto.

Outra opção é usar a sinalização --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com para especificar uma conta de serviço do IAM diferente que os nós usem em vez da conta de serviço padrão do Compute Engine. Recomendamos que você crie e use uma conta de serviço com privilégios mínimos para que os nós não tenham mais privilégios do que o necessário.

Para ver uma lista de outras opções que podem ser especificadas, consulte a documentação de referência de gcloud container clusters create-auto.

Console

Execute as seguintes tarefas:

  1. Acesse a página Google Kubernetes Engine no console do Google Cloud.

    Acessar o Google Kubernetes Engine

  2. Clique em Criar.

  3. Na seção Princípios básicos do cluster, conclua o seguinte:

  4. Insira o Nome do cluster.

  5. Selecione uma região para o cluster.

    1. Opcional (disponível no GKE Enterprise): se você quiser registrar o novo cluster em uma frota, acesse a seção Registro da frota e siga as as instruções do console do Google Cloud para Criar e registrar um novo cluster e concluir o registro dele.

  6. Na seção Rede, escolha uma das seguintes opções:

    • Para criar um cluster com um endpoint acessível publicamente, escolha Cluster público.
    • Se a organização tiver requisitos de isolamento de rede específicos, escolha Cluster particular. Veja as instruções de configuração em Criar um cluster particular.

  7. Opcionalmente, defina outras configurações, como janelas de manutenção e recursos avançados de segurança.

  8. Clique em Criar.

Terraform

Para criar um cluster do Autopilot usando o Terraform, consulte o exemplo a seguir:

resource "google_container_cluster" "default" {
  name     = "gke-autopilot-basic"
  location = "us-central1"

  enable_autopilot = true

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Para saber mais como usar o Terraform, consulte o Suporte do Terraform para GKE.

Definir a versão e o canal de lançamento de um novo cluster do Autopilot

Por padrão, o GKE inscreve novos clusters do Autopilot no canal de lançamento normal, com a versão padrão do GKE no canal. É possível alterar o canal de lançamento ao criar um cluster do Autopilot usando a gcloud CLI, o console do Google Cloud ou o Terraform.

Também é possível definir uma versão específica do GKE ao criar um cluster usando a gcloud CLI. A definição da versão do cluster só é útil se você tiver um requisito de versão específico. Para definir a versão do cluster, especifique a flag --cluster-version no comando gcloud container clusters create-auto. A versão especificada precisa ser uma versão do GKE disponível.

As instruções a seguir para configurar o canal de lançamento e a versão são opcionais. A menos que você precise de uma versão específica do GKE, mantenha a configuração padrão do canal de lançamento.

gcloud

Execute este comando:

gcloud container clusters create-auto CLUSTER_NAME \
    --location=LOCATION \
    --release-channel=RELEASE_CHANNEL \

Substitua RELEASE_CHANNEL pelo nome do canal de lançamento para o cluster. O padrão é Regular.

Também é possível especificar --cluster-version=CLUSTER_VERSION, substituindo CLUSTER_VERSION pela versão para o cluster, como 1.29.4-gke.1043002. A versão especificada se aplica até que uma versão mais recente se torne o padrão no seu canal de lançamento. O GKE faz upgrade automaticamente do cluster para a nova versão padrão. Se você omitir essa flag, O GKE define a versão como a versão padrão do canal de lançamento.

Para verificar as versões disponíveis, consulte Quais versões estão disponíveis em um canal?. É possível executar qualquer versão secundária no canal selecionado ou escolher um subconjunto de versões de patch de outros canais.

Console

Para definir o canal de lançamento ao criar um cluster do Autopilot, faça o seguinte:

  1. Acesse a página Google Kubernetes Engine no console do Google Cloud.

    Acessar o Google Kubernetes Engine

  2. Clique em Criar.

  3. Em Autopilot, clique em Configurar.

  4. Na seção Princípios básicos do cluster, conclua o seguinte:

    1. Especificar um nome
    2. Selecione uma Região.

  5. Na seção Configurações avançadas, escolha um canal de lançamento.

  6. Clique em Criar.

Terraform

Para definir o canal de lançamento e a versão do cluster ao criar um cluster do Autopilot usando o Terraform, consulte o exemplo a seguir:

resource "google_container_cluster" "default" {
  name     = "gke-autopilot-release-channel"
  location = "us-central1"

  enable_autopilot = true

  release_channel {
    channel = "REGULAR"
  }

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Para saber mais como usar o Terraform, consulte o Suporte do Terraform para GKE.

Também é possível alterar o canal de lançamento e a versão do GKE para clusters existentes. Para ver instruções, consulte Como fazer upgrade manual de um plano de controle e Como selecionar um novo canal de lançamento.

Conexão ao cluster

gcloud

gcloud container clusters get-credentials CLUSTER_NAME \
    --location=LOCATION \
    --project=PROJECT_ID

Esse comando configura kubectl para usar o cluster que você criou.

Console

  1. Na lista de clusters, além do cluster ao qual você quer se conectar, clique em Ações e, em seguida, em Conectar.

  2. Clique em Executar no Cloud Shell quando solicitado. O comando gerado é copiado no Cloud Shell, por exemplo:

    gcloud container clusters get-credentials autopilot-cluster --location=us-central1 --project=autopilot-test

  3. Pressione Enter para executar o comando.

Verificar o modo do cluster

Verifique se o cluster é do Autopilot usando a CLI gcloud ou o console do Google Cloud.

gcloud

Para verificar se o cluster foi criado no modo Autopilot, execute o seguinte comando:

gcloud container clusters describe CLUSTER_NAME \
    --location=LOCATION

A saída contém o seguinte:

autopilot:
  enabled: true

Console

Para verificar se o cluster foi criado no modo Autopilot, faça o seguinte:

  1. Na lista de clusters, clique no nome do cluster.
  2. Na seção Automação, verifique se o campo Provisionamento automático de nós (modo Autopilot) está definido como Ativado.

A seguir