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 Google 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
.
- Verifique se você tem a permissão correta para criar clusters. Você precisa ser, no mínimo, um Administrador de clusters do Kubernetes Engine.
- Se quiser registrar o novo cluster em uma frota, verifique se tem as APIs e permissões necessárias.
Criar um cluster do Autopilot
É possível criar um cluster do Autopilot usando a CLI do Google Cloud, o console do Google Cloud ou 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 do cluster, comous-central1
.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:
Acesse a página Google Kubernetes Engine no console do Google Cloud.
Clique em add_box Criar.
Na seção Princípios básicos do cluster, conclua o seguinte:
- Insira o Nome do cluster.
- Selecione uma região para o cluster.
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.
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.
Opcionalmente, defina outras configurações, como janelas de manutenção e recursos avançados de segurança.
Clique em Criar.
Terraform
Para criar um cluster do Autopilot usando o Terraform, consulte o exemplo a seguir:
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.
gcloud
Para definir o canal de lançamento e a versão do cluster ao criar um cluster do Autopilot, execute o seguinte comando. A definição da versão do cluster só é útil se você tiver um requisito de versão específico. Na maioria das situações, recomendamos que você defina apenas o canal de lançamento.
gcloud container clusters create-auto CLUSTER_NAME \
--location=LOCATION \
--release-channel=RELEASE_CHANNEL \
--cluster-version=VERSION
Substitua:
RELEASE_CHANNEL
: o nome do canal de lançamento para o cluster. O padrão éRegular
.CLUSTER_VERSION
: a versão do GKE do cluster, como1.22.11-gke.400
. Se omitido, o valor padrão será 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.
Essas sinalizações são opcionais. Se você definir uma versão específica do GKE, ela será aplicada até que uma nova versão se torne a versão padrão no canal de lançamento do cluster. O GKE faz upgrade automaticamente do cluster para a nova versão padrão.
Console
Para definir o canal de lançamento ao criar um cluster do Autopilot, faça o seguinte:
Acesse a página Google Kubernetes Engine no console do Google Cloud.
Clique em add_box Criar.
Em Autopilot, clique em Configurar.
Na seção Princípios básicos do cluster, conclua o seguinte:
- Especificar um nome
- Selecione uma Região.
Na seção Configurações avançadas, escolha um canal de lançamento.
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:
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
Na lista de clusters, além do cluster ao qual você quer se conectar, clique em more_vert Ações e, em seguida, em Conectar.
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
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:
- Na lista de clusters, clique no nome do cluster.
- Na seção Automação, verifique se o campo Provisionamento automático de nós (modo Autopilot) está definido como Ativado.