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
.
- 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 ou o console do Google Cloud: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:
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.
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.
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:
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.