Neste documento, mostramos como criar um cluster regional padrão para aumentar a disponibilidade do plano de controle e das cargas de trabalho do cluster durante upgrades de cluster, manutenção automatizada ou uma interrupção por zona.
Os clusters do Autopilot do GKE são sempre regionais.
Visão geral
Ao criar um cluster regional em vez de um cluster zonal, o plano de controle do cluster é replicado em várias zonas em uma determinada região. Para pools de nós em um cluster regional, é possível especificar manualmente as zonas em que os pools de nós serão executados. Também é possível usar a configuração padrão, que replica cada pool de nós em três zonas do plano de controle. Todas as zonas precisam estar na mesma região do plano de controle do cluster.
Os clusters regionais replicam recursos em várias zonas e consomem cotas adicionais.
Para saber mais sobre os diferentes tipos de disponibilidade de cluster, consulte Sobre opções de configuração de cluster.
Nas instruções das seções a seguir, mostramos como:
- Crie um cluster regional com um pool de nós de zona única.
- Crie um cluster regional com um pool de nós de várias zonas.
- Crie um cluster regional que não tenha nós.
Depois de criar um cluster regional, não é possível convertê-lo em um cluster zonal.
As informações mínimas que você precisa especificar ao criar um novo cluster regional são um nome, um projeto (geralmente o projeto atual) e uma região (geralmente o local padrão para ferramentas de linha de comando), usando as configurações padrão para todos os outros valores. No entanto, há mais configurações possíveis, mas apenas algumas delas são descritas neste guia, e algumas não podem ser alteradas após a criação do cluster. Entenda quais configurações não podem ser alteradas após a criação do cluster e escolha a configuração certa ao criar um cluster se não quiser criá-lo novamente.
Confira uma visão geral das opções de configuração de cluster em Sobre as opções de configuração de cluster e uma lista completa de opções possíveis nos guias de referência gcloud container clusters create e google_container_cluster do Terraform.
Antes de começar
Antes de começar, verifique se você realizou as tarefas a seguir:
- Ative a API Google Kubernetes Engine. Ativar a API Google Kubernetes Engine
- Para usar a Google Cloud CLI nesta tarefa,
instale e
inicialize a
CLI gcloud. Se você instalou a CLI gcloud anteriormente, instale a versão mais recente executando o comando
gcloud components update. Talvez as versões anteriores da CLI gcloud não sejam compatíveis com a execução dos comandos neste documento.
- 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.
Configurar contas de serviço do IAM para o GKE
O GKE usa contas de serviço do IAM anexadas aos nós para
executar tarefas do sistema, como geração de registros e monitoramento. No mínimo, essas contas de serviço de nó
precisam ter o papel
Conta de serviço de nó padrão do Kubernetes Engine
(roles/container.defaultNodeServiceAccount) no projeto. Por padrão,
o GKE usa a
conta de serviço padrão do Compute Engine,
que é criada automaticamente no projeto, como a conta de serviço do nó.
Para conceder o papel roles/container.defaultNodeServiceAccount à
conta de serviço padrão do Compute Engine, siga estas etapas:
Console
- Acesse a página de boas-vindas:
- No campo Número do projeto, clique em Copiar para a área de transferência.
- Acesse a página do IAM:
- Clique em Conceder acesso.
- No campo Novos participantes, especifique o seguinte valor:
SubstituaPROJECT_NUMBER-compute@developer.gserviceaccount.comPROJECT_NUMBERpelo número do projeto que você copiou. - No menu Selecionar um papel, selecione o papel Conta de serviço de nó padrão do Kubernetes Engine.
- Clique em Salvar.
gcloud
- Encontre o número do projeto do Google Cloud :
gcloud projects describe PROJECT_ID \ --format="value(projectNumber)"
Substitua
PROJECT_IDpelo ID do projeto.O resultado será o seguinte:
12345678901
- Conceda o papel
roles/container.defaultNodeServiceAccountà conta de serviço padrão do Compute Engine:gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com" \ --role="roles/container.defaultNodeServiceAccount"
Substitua
PROJECT_NUMBERpelo número do projeto da etapa anterior.
Criar um cluster regional com um pool de nós de zona única
Nas instruções a seguir, mostramos como criar um cluster regional com um pool de nós que opera em uma única zona dentro da região. O plano de controle do cluster é replicado em várias zonas na região especificada, mas os nós estão localizados na zona única e não são replicados em outras zonas.
É possível usar a CLI gcloud, o console do Google Cloud ou o Terraform para criar o cluster.
Se você estiver desenvolvendo aplicativos do GKE com o Cloud Code para VS Code, crie clusters com o Cloud Code.
gcloud
Antes de executar os comandos da CLI gcloud para criar o cluster, defina o projeto correto executando o seguinte:
gcloud config set project PROJECT_ID
# gcloud config set billing/quota_project PROJECT_ID
Para criar um cluster regional com a CLI gcloud, use um dos comandos a seguir e substitua as seguintes variáveis:
CLUSTER_NAME: o nome do novo cluster regional;CONTROL_PLANE_LOCATION: a região do Compute Engine do plano de controle do cluster. Informe uma região, comous-east4.COMPUTE_ZONE: a zona do pool de nós, comous-east4-a. A zona precisa estar na mesma região que o plano de controle do cluster.CHANNEL: o tipo de canal de lançamento, que pode serrapid,regular,stableouNone(descontinuado). Por padrão, o cluster é registrado no canal de lançamentoregular.VERSION: a versão que você quer especificar para o cluster.
Recomendamos que você especifique uma conta de serviço do IAM com privilégios mínimos para os nós usarem em vez da conta de serviço padrão do Compute Engine. Para saber como criar uma conta de serviço com privilégios mínimos, consulte Usar uma conta de serviço privilégio mínimo mínimos.
Para especificar uma conta de serviço personalizada na CLI gcloud, adicione a seguinte flag ao comando:
--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.comSubstitua SERVICE_ACCOUNT_NAME pelo nome da conta de serviço com privilégios mínimos.
Como usar um canal de lançamento específico:
Para criar um novo cluster usando um canal de lançamento específico, execute o comando a seguir:
gcloud container clusters create CLUSTER_NAME \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE \
--release-channel CHANNEL
Como usar uma versão específica:
Para criar um novo cluster usando uma versão de cluster específica, execute o comando a seguir:
gcloud container clusters create CLUSTER_NAME \
--location CONTROL_PLANE_LOCATION \
--node-locations COMPUTE_ZONE \
--cluster-version VERSION
Exemplo
O comando a seguir cria um cluster regional inscrito no canal de lançamento
regular (padrão), com três nós (padrão) na zona
us-west1-c:
gcloud container clusters create my-regional-cluster \
--location us-west1 \
--node-locations us-west1-c
Exemplo
O comando a seguir cria um cluster regional inscrito no canal de lançamento
regular (padrão), com dois nós localizados na zona us-west1-c:
gcloud container clusters create my-regional-cluster \
--location us-west1 \
--node-locations us-west1-c \
--num-nodes 2
Console
No console do Google Cloud , acesse a página Criar um cluster do Kubernetes.
Na seção Princípios básicos do cluster, conclua o seguinte:
- Insira o Nome do cluster.
- Em Tipo de local, selecione Regional e selecione a região pretendida para o cluster.
- Se você quiser modificar os locais padrão dos nós (por exemplo, para execução em uma única zona), marque a caixa de seleção Especificar os locais padrão do nó e escolha as zonas em que você quer que os pools de nós sejam executados.
Escolher um canal de lançamento Como opção, selecione Nenhum canal, mas essa opção de configuração foi descontinuada e será removida. Para mais informações, consulte Clusters não registrados em um canal de lançamento.
Opcional: especifique uma versão do plano de controle na lista suspensa Versão.
Opcional: defina outras configurações para o novo cluster.
Opcional: se você quiser registrar o novo cluster em uma frota, acesse a seção Configurações avançadas e siga as instruções do console do Google Cloud para Criar e registrar um novo cluster e concluir o registro dele.
Para criar e configurar seus próprios pools de nós, siga estas etapas:
- Clique em Adicionar pool de nós.
- Na caixa de diálogo Alterações necessárias, clique em Fazer alterações.
No menu de navegação, um pool de nós chamado
default-poolé exibido.Opcional: para criar um cluster sem pools de nós, siga estas etapas:
- No menu de navegação, clique em default-pool.
- Clique em Remover pool de nós.
- Defina as configurações restantes do cluster e clique em Criar.
Opcional: para adicionar pools de nós ao cluster, clique em Adicionar pool de nós. No menu de navegação, um novo pool de nós é exibido.
Defina as configurações básicas de um pool de nós:
- No menu de navegação, na seção Pools de nós, clique no nome do pool de nós. A página Detalhes do pool de nós gerenciado pelo usuário é aberta.
- No campo Nome, insira um nome para o pool de nós.
- Na seção Tamanho, no campo Número de nós,
especifique o número de nós a serem criados. É necessário ter uma cota de recursos disponível para os nós e os recursos deles (como rotas de firewall). No GKE versão
1.37.1-gke.1153000 e posterior, é possível criar um pool de nós vazio
especificando um valor de
0.
Defina as configurações das instâncias de VM que executam os nós:
- No menu de navegação, na seção expandida do pool de nós selecionado, clique em Nós.
- Na lista suspensa Tipo de imagem, selecione a imagem de nó.
- Escolha a Configuração da máquina padrão para usar nas instâncias. O faturamento varia de acordo com cada tipo de máquina. O tipo de máquina padrão é
e2-medium. Para informações sobre preços de tipo de máquina, consulte a tabela de preços. - Na lista suspensa Tipo de disco de inicialização, selecione o tipo de disco.
- No campo Tamanho do disco de inicialização, especifique um tamanho em GB para o disco de inicialização.
Defina as configurações de segurança para o pool de nós:
- No menu de navegação, na seção expandida do pool de nós selecionado, clique em Segurança.
- Se quiser, especifique uma conta de serviço personalizada do IAM para os nós:
- Na página Configurações avançadas, expanda a seção Segurança.
- No menu Conta de serviço, selecione a conta de serviço que preferir.
Recomendamos que você especifique uma conta de serviço do IAM com privilégios mínimos para os nós usarem em vez da conta de serviço padrão do Compute Engine. Para saber como criar uma conta de serviço com privilégios mínimos, consulte Usar uma conta de serviço privilégio mínimo mínimos.
Clique em Criar.
Terraform
Para criar um cluster regional com um pool de nós de zona única usando o Terraform, consulte o exemplo a seguir:
Para saber mais como usar o Terraform, consulte o Suporte do Terraform para GKE.
Interagir com um cluster usando a kubectl
Depois de criar um cluster, é preciso configurar a kubectl antes de interagir com o cluster a partir da linha de comando.
Criar um cluster regional com um pool de nós de várias zonas
Nas instruções a seguir, mostramos como criar um cluster regional com um pool de nós de várias zonas, que é a configuração padrão. O plano de controle e os nós do cluster são replicados em várias zonas na região especificada.
É possível usar a CLI gcloud, o console do Google Cloud ou o Terraform para criar o cluster.
Se você estiver desenvolvendo aplicativos do GKE com o Visual Studio Code, tente criar clusters com o Cloud Code.
gcloud
Antes de executar os comandos da CLI gcloud para criar o cluster, defina o projeto correto executando o seguinte:
gcloud config set project PROJECT_ID
# The project set above is used for quota and billing by default.
# To use a different project for quota and billing, run the following command:
# gcloud config set billing/quota_project PROJECT_ID
Para criar um cluster regional com a CLI gcloud, use um dos comandos a seguir e substitua as seguintes variáveis:
CLUSTER_NAME: o nome do novo cluster regional;CONTROL_PLANE_LOCATION: a região do Compute Engine do plano de controle do cluster. Informe uma região, comous-east4.CHANNEL: o tipo de canal de lançamento, que pode serrapid,regular,stableouNone(descontinuado). Por padrão, o cluster é registrado no canal de lançamentoregular.VERSION: a versão que você quer especificar para o cluster.- Para regiões com mais de três zonas
ou nos casos em que é preferível menos zonas, use a sinalização
--node-locationsopcional para modificar as zonas padrão em que os nós são replicados.
Recomendamos que você especifique uma conta de serviço do IAM com privilégios mínimos para os nós usarem em vez da conta de serviço padrão do Compute Engine. Para saber como criar uma conta de serviço com privilégios mínimos, consulte Usar uma conta de serviço privilégio mínimo mínimos.
Para especificar uma conta de serviço personalizada na CLI gcloud, adicione a seguinte flag ao comando:
--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.comSubstitua SERVICE_ACCOUNT_NAME pelo nome da conta de serviço com privilégios mínimos.
Como usar um canal de lançamento específico:
Para criar um novo cluster usando um canal de lançamento específico, execute o comando a seguir:
gcloud container clusters create CLUSTER_NAME \
--location CONTROL_PLANE_LOCATION \
--release-channel CHANNEL
Como usar uma versão específica:
Para criar um novo cluster usando uma versão de cluster específica, execute o comando a seguir:
gcloud container clusters create CLUSTER_NAME \
--location CONTROL_PLANE_LOCATION \
--cluster-version VERSION
Exemplo
O comando a seguir cria um cluster regional inscrito no canal de lançamento regular,
com nove nós em us-west1 (três zonas com três nós
cada, que é o padrão):
gcloud container clusters create my-regional-cluster --location us-west1
Exemplo
O comando a seguir cria um cluster regional inscrito no canal de lançamento regular,
com seis nós (três zonas com dois nós cada, especificadas
por --num-nodes):
gcloud container clusters create my-regional-cluster \
--location us-west1 \
--num-nodes 2
Exemplo
O comando a seguir cria um cluster regional inscrito no canal de lançamento regular,
com seis nós em duas zonas (duas zonas especificadas por
--node-locations com três nós cada):
gcloud container clusters create my-regional-cluster \
--location us-east4 \
--node-locations us-east4-b,us-east4-c
Console
No console do Google Cloud , acesse a página Criar um cluster do Kubernetes.
Na seção Princípios básicos do cluster, conclua o seguinte:
- Insira o Nome do cluster.
- Em Tipo de local, selecione Regional e selecione a região pretendida para o cluster.
- Se você quiser modificar os locais padrão dos nós (por exemplo, para execução em uma única zona), marque a caixa de seleção Especificar os locais padrão do nó e escolha as zonas em que você quer que os pools de nós sejam executados.
Escolher um canal de lançamento Como opção, selecione Nenhum canal, mas essa opção de configuração foi descontinuada e será removida. Para mais informações, consulte Clusters não registrados em um canal de lançamento.
Opcional: especifique uma versão do plano de controle na lista suspensa Versão.
Opcional: defina outras configurações para o novo cluster.
Opcional: se você quiser registrar o novo cluster em uma frota, acesse a seção Configurações avançadas e siga as instruções do console do Google Cloud para Criar e registrar um novo cluster e concluir o registro dele.
Para criar e configurar seus próprios pools de nós, siga estas etapas:
- Clique em Adicionar pool de nós.
- Na caixa de diálogo Alterações necessárias, clique em Fazer alterações.
No menu de navegação, um pool de nós chamado
default-poolé exibido.Opcional: para criar um cluster sem pools de nós, siga estas etapas:
- No menu de navegação, clique em default-pool.
- Clique em Remover pool de nós.
- Defina as configurações restantes do cluster e clique em Criar.
Opcional: para adicionar pools de nós ao cluster, clique em Adicionar pool de nós. No menu de navegação, um novo pool de nós é exibido.
Defina as configurações básicas de um pool de nós:
- No menu de navegação, na seção Pools de nós, clique no nome do pool de nós. A página Detalhes do pool de nós gerenciado pelo usuário é aberta.
- No campo Nome, insira um nome para o pool de nós.
- Na seção Tamanho, no campo Número de nós,
especifique o número de nós a serem criados. É necessário ter uma cota de recursos disponível para os nós e os recursos deles (como rotas de firewall). No GKE versão
1.37.1-gke.1153000 e posterior, é possível criar um pool de nós vazio
especificando um valor de
0.
Defina as configurações das instâncias de VM que executam os nós:
- No menu de navegação, na seção expandida do pool de nós selecionado, clique em Nós.
- Na lista suspensa Tipo de imagem, selecione a imagem de nó.
- Escolha a Configuração da máquina padrão para usar nas instâncias. O faturamento varia de acordo com cada tipo de máquina. O tipo de máquina padrão é
e2-medium. Para informações sobre preços de tipo de máquina, consulte a tabela de preços. - Na lista suspensa Tipo de disco de inicialização, selecione o tipo de disco.
- No campo Tamanho do disco de inicialização, especifique um tamanho em GB para o disco de inicialização.
Defina as configurações de segurança para o pool de nós:
- No menu de navegação, na seção expandida do pool de nós selecionado, clique em Segurança.
- Se quiser, especifique uma conta de serviço personalizada do IAM para os nós:
- Na página Configurações avançadas, expanda a seção Segurança.
- No menu Conta de serviço, selecione a conta de serviço que preferir.
Recomendamos que você especifique uma conta de serviço do IAM com privilégios mínimos para os nós usarem em vez da conta de serviço padrão do Compute Engine. Para saber como criar uma conta de serviço com privilégios mínimos, consulte Usar uma conta de serviço privilégio mínimo mínimos.
Clique em Criar.
Terraform
Para criar um cluster regional com um pool de nós de várias zonas usando o Terraform, consulte o exemplo a seguir:
Para saber mais como usar o Terraform, consulte o Suporte do Terraform para GKE.
Interagir com um cluster usando a kubectl
Depois de criar um cluster, é preciso configurar a kubectl antes de interagir com o cluster a partir da linha de comando.
Criar um cluster regional sem nós
No GKE versão 1.37.1-gke.1153000 e posterior, é possível criar um cluster regional que não tenha nós de uma das seguintes maneiras:
- Pular a criação do pool de nós padrão: o GKE não adiciona pools de nós ao cluster. Se você planeja executar cargas de trabalho usando ComputeClasses do Autopilot, criação automática de pools de nós ou pools de nós personalizados que você criar mais tarde, use essa opção.
- Criar um pool de nós vazio: o GKE cria um pool de nós que não tem nós. Se você quiser personalizar as configurações do pool de nós durante a criação do cluster sem criar os nós reais, use essa opção.
Quando você cria um cluster sem nós, os pods do sistema permanecem em um estado não programável até que haja pelo menos um nó no cluster. Para criar um cluster regional com zero nós, selecione uma das seguintes opções:
gcloud
Para pular a criação do pool de nós padrão, use apenas a flag
--num-nodes=0no comandogcloud container clusters create:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0Substitua:
CLUSTER_NAME: o nome do novo cluster regional.CONTROL_PLANE_LOCATION: a região do Compute Engine do plano de controle do cluster, comous-central1.
Se você especificar outras flags de configuração do pool de nós, como
--machine-type,--disk-typeou--disk-size, o comando vai falhar, porque não há um pool de nós para o GKE configurar.Para criar um cluster com um pool de nós vazio, use as sinalizações
--num-nodes=0e--node-pool-nameno comandogcloud container clusters create:gcloud container clusters create CLUSTER_NAME \ --location=CONTROL_PLANE_LOCATION \ --num-nodes=0 \ --node-pool-name=NODEPOOL_NAMESubstitua
NODEPOOL_NAMEpor um nome para o pool de nós vazio. É possível especificar outras flags de configuração de nó para personalizar os nós no pool de nós vazio.
Console
No console do Google Cloud , acesse a página Criar um cluster do Kubernetes.
Especifique um nome para o cluster.
Na seção Tipo de local, selecione Regional.
Na lista suspensa Região, selecione uma região para o plano de controle do cluster.
Pule a criação do pool de nós padrão ou crie um pool de nós vazio:
Para pular a criação do pool de nós padrão, na seção Modo padrão, verifique se a opção Autopilot está selecionada. Como alternativa, acione a criação do pool de nós padrão e remova-o:
- Clique em Adicionar pool de nós.
- Na caixa de diálogo Alterações necessárias, clique em Fazer alterações.
Um pool de nós chamado
default-poolvai aparecer. - No menu de navegação, clique em default-pool.
- Clique em Remover pool de nós.
Essas etapas criam um cluster que não tem pools de nós e usa o modo Autopilot para executar cargas de trabalho que não selecionam uma ComputeClass. Também é possível impedir o uso do modo Autopilot selecionando a opção Pool de nós gerenciado pelo usuário na seção Modo padrão.
Para criar um pool de nós vazio, siga estas etapas:
- Clique em Adicionar pool de nós.
- Na caixa de diálogo Alterações necessárias, clique em Fazer alterações.
Um pool de nós chamado
default-poolvai aparecer. - No menu de navegação, clique em default-pool.
- No campo Número de nós (por zona), especifique um valor de
0.
Defina as configurações restantes do cluster e clique em Criar.
Terraform
- Para pular a criação do pool de nós padrão, no recurso
google_container_cluster, defina o campoinitial_node_countcomo um valor de0. Para criar um pool de nós inicial vazio, faça o seguinte:
- No recurso
google_container_cluster, defina o campoinitial_node_countcomo um valor de0. - Adicione um recurso
google_container_node_poole defina o camponode_countcomo um valor de0.
- No recurso
Depois de criar um cluster sem nós, é possível provisionar nós das seguintes maneiras:
- Configure clusters Standard para usar o Autopilot por padrão ou execute cargas de trabalho específicas no modo Autopilot.
- Use ComputeClasses para criar nós automaticamente para as cargas de trabalho recebidas.
- Adicione manualmente um pool de nós ou redimensione um pool de nós vazio existente.
A seguir
- Saiba mais sobre os tipos de clusters que podem ser criados.
- Crie um cluster zonal.