Criar um cluster zonal

Padrão

---

Esta página mostra como criar um cluster zonal padrão, com as funcionalidades predefinidas ativadas, no Google Kubernetes Engine (GKE). Os clusters zonais têm uma única instância do plano de controlo numa única zona. Consoante os seus requisitos de disponibilidade, pode optar por distribuir os seus nós para o cluster zonal numa única zona ou em várias zonas.

Prática recomendada: use clusters regionais para executar as suas cargas de trabalho de produção, uma vez que oferecem uma disponibilidade superior à dos clusters zonais. Num cluster regional, o plano de controlo é replicado em várias zonas numa região.

Aviso: depois de criar um cluster, não pode alterá-lo de zonal para regional nem de regional para zonal. Para saber mais sobre os diferentes tipos de disponibilidade de clusters, consulte Disponibilidade de clusters.

Esta página destina-se a operadores, arquitetos da nuvem e programadores que precisam de criar e configurar clusters, e que implementam cargas de trabalho no GKE. Para saber mais sobre as funções comuns e as tarefas de exemplo que referimos no Google Cloud conteúdo, consulte Funções e tarefas comuns de utilizadores do GKE.

Antes de ler esta página, certifique-se de que conhece as opções de configuração de clusters.

Antes de começar

Antes de começar, certifique-se de que realizou as seguintes tarefas:

• Ative a API Google Kubernetes Engine.
Ative a API Google Kubernetes Engine
• Se quiser usar a CLI gcloud para esta tarefa, instale-a e, em seguida, inicialize-a. Se instalou anteriormente a CLI gcloud, execute gcloud components update para obter a versão mais recente.
  Nota: para instalações existentes da CLI gcloud, certifique-se de que define a compute/region propriedade. Se usar principalmente clusters zonais, defina o compute/zone. Ao definir uma localização predefinida, pode evitar erros na CLI gcloud, como os seguintes: One of [--zone, --region] must be supplied: Please specify location. Pode ter de especificar a localização em determinados comandos se a localização do seu cluster for diferente da predefinição que definiu.

• Certifique-se de que tem as autorizações corretas para criar clusters. No mínimo, deve ter a função de administrador do cluster do Kubernetes Engine.
• Se quiser registar o novo cluster numa frota, certifique-se de que tem as APIs e as autorizações necessárias.

Importante: os novos clusters têm a flag cos-metrics-enabled ativada por predefinição. Esta definição permite que os registos de falhas do kernel sejam recolhidos através do dmesg. O relatório não inclui registos de utilizadores e não recolhe intencionalmente PII. Pode incluir potencialmente registos do utilizador se escrever registos a partir de um contentor privilegiado e montar /dev/kmsg. Além disso, determinadas PII, por exemplo, o nome do processo, podem aparecer no relatório se o kernel as incluir nas mensagens de erro, como as eliminações por falta de memória.

Aviso: se tiver a restrição da política da organização constraints/compute.vmExternalIpAccess configurada como Deny All ou para restringir os IPs externos a instâncias de VM específicas ao nível da organização, da pasta ou do projeto onde está a tentar criar um cluster GKE público, as suas operações de criação de clusters vão falhar. Consulte as informações de resolução de problemas para ver detalhes.

Configure contas de serviço IAM para o GKE

O GKE usa contas de serviço da IAM anexadas aos seus nós para executar tarefas do sistema, como registo e monitorização. No mínimo, estas contas de serviço de nós têm de ter a função Conta de serviço de nós predefinida do Kubernetes Engine (roles/container.defaultNodeServiceAccount) no seu projeto. Por predefinição, o GKE usa a conta de serviço predefinida do Compute Engine, que é criada automaticamente no seu projeto, como a conta de serviço do nó.

Prática recomendada: em vez de usar a conta de serviço predefinida do Compute Engine, crie uma conta de serviço personalizada para os seus nós usarem e conceda-lhe apenas as autorizações de que o GKE precisa para executar tarefas do sistema. Para mais informações, consulte o artigo Use uma conta de serviço com o mínimo de privilégios.

Para conceder a função roles/container.defaultNodeServiceAccount à conta de serviço predefinida do Compute Engine, conclua os passos seguintes:

consola

1. Aceda à página Boas-vindas:

   Aceder a Boas-vindas

2. No campo Número do projeto, clique em Copiar para a área de transferência.
3. Aceda à página IAM:

   Aceda ao IAM

4. Clique em Conceder acesso.
5. No campo Novos responsáveis, especifique o seguinte valor:

   [e-mail]

   Substitua PROJECT_NUMBER pelo número do projeto que copiou.
6. No menu Selecionar uma função, selecione a função Conta de serviço do nó predefinido do Kubernetes Engine.
7. Clique em Guardar.

gcloud

1. Encontre o seu Google Cloud número do projeto:

   gcloud projects describe PROJECT_ID \
       --format="value(projectNumber)"

   Substitua PROJECT_ID pelo ID do seu projeto.

   O resultado é semelhante ao seguinte:

   12345678901
   

2. Conceda a função roles/container.defaultNodeServiceAccount à conta de serviço predefinida do Compute Engine:

   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member="serviceAccount:[e-mail]" \
       --role="roles/container.defaultNodeServiceAccount"

   Substitua PROJECT_NUMBER pelo número do projeto do passo anterior.

Crie um cluster zonal

As informações mínimas que tem de especificar quando cria um novo cluster zonal são um nome, um projeto (normalmente, o projeto atual) e uma zona (normalmente, a localização predefinida para ferramentas de linha de comandos), usando as predefinições para todos os outros valores. No entanto, existem mais definições de configuração possíveis, das quais apenas algumas são descritas nesta secção e algumas não podem ser alteradas após a criação do cluster. Certifique-se de que compreende que definições não podem ser alteradas após a criação do cluster e que escolhe a definição certa quando cria um cluster, se não quiser ter de o criar novamente.

Pode ver uma vista geral das opções de configuração de clusters em Acerca das opções de configuração de clusters e uma lista completa das opções possíveis nos guias de referência do gcloud container clusters create e do Terraform google_container_cluster.

Pode criar um cluster zonal através da CLI gcloud, da Google Cloud consola ou do Terraform.

Se estiver a desenvolver aplicações GKE com o Cloud Code para VS Code, experimente criar clusters com o Cloud Code.

gcloud

Para criar um cluster zonal com a CLI gcloud, use um dos seguintes comandos.

Nota: se estiver a criar um cluster de zona única, pode omitir a flag --node-locations do comando.

Substitua o seguinte:

• CLUSTER_NAME: o nome do novo cluster.
• CHANNEL: o tipo de canal de lançamento, que pode ser um dos seguintes: rapid, regular, stable ou None. Por predefinição, o cluster está inscrito no canal de lançamento regular, a menos que seja especificada, pelo menos, uma das seguintes flags: --cluster-version, --release-channel, --no-enable-autoupgrade e --no-enable-autorepair.
• CONTROL_PLANE_LOCATION: a zona do Compute Engine do plano de controlo do seu cluster.
• VERSION: a versão que quer especificar para o seu cluster.
• COMPUTE_ZONE,COMPUTE_ZONE1,[...]: as zonas nas quais os nós são criados. Pode especificar tantas zonas quantas forem necessárias para o seu cluster. Todas as zonas têm de estar na mesma região que o plano de controlo do cluster, especificado pela flag --location. Para clusters zonais, o elemento --node-locations tem de conter a zona principal do cluster.

Recomendamos vivamente que especifique uma conta de serviço do IAM com privilégios mínimos que os seus nós possam usar em vez da conta de serviço predefinida do Compute Engine. Para saber como criar uma conta de serviço com privilégios mínimos, consulte o artigo Use uma conta de serviço com privilégios mínimos.

Para especificar uma conta de serviço personalizada na CLI gcloud, adicione a seguinte flag ao seu comando:

--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

Substitua SERVICE_ACCOUNT_NAME pelo nome da sua conta de serviço com privilégios mínimos.

Usando um canal de lançamento específico:

Para criar um novo cluster com um canal de lançamento específico, execute o seguinte comando:

gcloud container clusters create CLUSTER_NAME \
    --release-channel CHANNEL \
    --location CONTROL_PLANE_LOCATION \
    --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

Usar uma versão específica:

Para criar um novo cluster com uma versão específica do cluster, execute o seguinte comando:

gcloud container clusters create CLUSTER_NAME \
    --cluster-version VERSION \
    --location CONTROL_PLANE_LOCATION \
    --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

Nota: se especificar uma versão do cluster, o cluster usa essa versão específica e é inscrito no canal de lançamento mais desenvolvido onde essa versão está disponível.

Usar a versão predefinida para clusters não inscritos num canal de lançamento:

Para criar um novo cluster com a versão predefinida para clusters não inscritos num canal de lançamento, não precisa de especificar uma versão do cluster, mas tem de definir o canal de lançamento como None:

gcloud container clusters create CLUSTER_NAME \
    --release-channel None \
    --location CONTROL_PLANE_LOCATION \
    --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

Exemplo

O seguinte comando cria um cluster multizonal denominado example-cluster, em que o plano de controlo do cluster está localizado na zona us-central-a e existem três localizações de nós. O cluster está inscrito no regular canal de lançamento.

Quando a flag --num-nodes é omitida, o número predefinido de nós por zona criados pelo cluster é três. Como foram especificadas três zonas, este comando cria um cluster de nove nós com três nós em us-central1-a, us-central1-b e us-central1-c.

gcloud container clusters create example-cluster \
    --location us-central1-a \
    --node-locations us-central1-a,us-central1-b,us-central1-c

Consola

Para criar um cluster zonal com a Google Cloud consola, execute as seguintes tarefas:

1. Na Google Cloud consola, aceda à página Criar um cluster do Kubernetes.

   Aceda a Crie um cluster do Kubernetes

2. Na secção Noções básicas do cluster, conclua o seguinte:

   1. Introduza o Nome do cluster.
   2. Para o Tipo de localização, selecione Zonal e, de seguida, selecione a zona para o seu cluster.
   3. Se estiver a criar um cluster multizonal, selecione a caixa de verificação Especificar localizações de nós predefinidas e, em seguida, escolha zonas adicionais nas quais quer que os conjuntos de nós sejam executados.

   4. Escolha um canal de lançamento. Opcionalmente, pode selecionar Nenhum canal na lista pendente. No entanto, recomendamos que reveja a comparação entre clusters inscritos e não inscritos num canal de lançamento antes de escolher esta opção. O GKE atualiza automaticamente os clusters que não estão num canal de lançamento com versões do canal estável.

   5. Opcional: especifique uma versão do plano de controlo na lista pendente Versão.

3. Opcional: configure outras definições para o novo cluster.

4. Opcional (disponível com o GKE Enterprise): se quiser registar o novo cluster numa frota, aceda à secção Registo de frotas e siga as Google Cloud instruções da consola para criar e registar um novo cluster para concluir o registo do cluster.

5. No painel de navegação, em Node Pools, clique em default-pool.

6. Na secção Detalhes do conjunto de nós, conclua o seguinte:

   1. Introduza um Nome para o conjunto de nós predefinido.
   2. Opcional: escolha a versão do Node.
   3. Introduza o Number of nodes (Número de nós) a criar no cluster. Tem de ter quota de recursos disponível para os nós e os respetivos recursos (como trajetos de firewall).
   4. Opcional: pode optar por desativar as atualizações automáticas de nós. No entanto, recomendamos que reveja as considerações antes de desativar as atualizações automáticas de nós antes de escolher esta opção.

7. No painel de navegação, em Node Pools, clique em Nodes.

8. Na lista pendente Tipo de imagem, selecione a imagem do nó.

9. Escolha a configuração da máquina predefinida a usar para as instâncias. Cada tipo de máquina é faturado de forma diferente. O tipo de máquina predefinido é e2-medium. Para ver informações sobre os preços dos tipos de máquinas, consulte a folha de preços dos tipos de máquinas.

10. Na lista pendente Tipo de disco de arranque, selecione o tipo de disco.

11. Introduza o tamanho do disco de arranque.

12. Opcional: no painel de navegação, em Conjuntos de nós, clique em Segurança.

13. Opcionalmente, especifique uma conta de serviço do IAM personalizada para os seus nós:
    1. Na página Definições avançadas, expanda a secção Segurança.
    2. No menu Conta de serviço, selecione a sua conta de serviço preferida.

    Recomendamos vivamente que especifique uma conta de serviço do IAM com privilégios mínimos que os seus nós possam usar em vez da conta de serviço predefinida do Compute Engine. Para saber como criar uma conta de serviço com privilégios mínimos, consulte o artigo Use uma conta de serviço com privilégios mínimos.

Aviso: não é possível modificar a conta de serviço num conjunto de nós existente após a criação.

14. Clique em Criar.

Terraform

Para criar um cluster zonal com um node pool de zona única através do Terraform, consulte o seguinte exemplo:

resource "google_container_cluster" "default" {
  name               = "gke-standard-zonal-single-zone"
  location           = "us-central1-a"
  initial_node_count = 1
}

Para criar um cluster zonal com um node pool de várias zonas através do Terraform, consulte o seguinte exemplo:

resource "google_container_cluster" "default" {
  name               = "gke-standard-zonal-multi-zone"
  location           = "us-central1-a"
  node_locations     = ["us-central1-b", "us-central1-c"]
  initial_node_count = 2
}

Para saber mais sobre a utilização do Terraform, consulte o artigo Compatibilidade do Terraform com o GKE.

Interaja com um cluster através do kubectl

Depois de criar um cluster, tem de o configurar kubectl antes de poder interagir com o cluster a partir da linha de comandos.

Modelos de clusters

Anteriormente, o GKE suportava modelos para clusters. Esses modelos foram removidos da consola do Google Cloud , mas ainda estão acessíveis através dos seguintes links:

• O seu primeiro cluster

  Nota: o GKE oferece um passo a passo guiado para O meu primeiro cluster.

• Aplicações que exigem muito da CPU

• Aplicações com utilização intensiva de memória

• Computação acelerada pela GPU

• Altamente disponível

O que se segue?

• Saiba mais sobre as opções de configuração de clusters que pode criar.
• Saiba mais sobre a arquitetura do cluster do GKE.
• Saiba como gerir os seus clusters.
• Saiba como eliminar clusters.

Experimente

Se está a usar o Google Cloud pela primeira vez, crie uma conta para avaliar o desempenho do GKE em cenários reais. Os novos clientes também recebem 300 USD em créditos gratuitos para executar, testar e implementar cargas de trabalho.

Experimente o GKE gratuitamente