Como criar um cluster zonal

Neste tópico, mostramos como criar um cluster zonal padrão com os recursos padrão ativados no Google Kubernetes Engine (GKE). Os clusters de zona têm somente um plano de controle em uma única zona Dependendo dos requisitos de disponibilidade, é possível distribuir os nós para o cluster de zona em uma única ou em várias zonas.

Leia mais sobre os tipos de clusters que podem ser criados.

Zona única versus várias zonas

Um cluster de zona única tem um único plano de controle em execução em uma zona. Este plano de controle gerencia cargas de trabalho em nós em execução na mesma zona.

Os nós de um cluster de várias zonas são executados em várias zonas, mas têm apenas uma réplica do plano de controle. Se você precisar de maior disponibilidade para o plano de controle, crie um cluster regional em seu lugar. Em um cluster regional, o plano de controle é replicado em várias zonas em uma região.

Antes de começar

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

Defina as configurações padrão da gcloud usando um dos métodos a seguir:

  • Use gcloud init se quiser orientações para definir os padrões.
  • Use gcloud config para definir individualmente a região, a zona e o ID do projeto.

Como usar o gcloud init

Se você receber o erro One of [--zone, --region] must be supplied: Please specify location, conclua esta seção.

  1. Execute gcloud init e siga as instruções:

    gcloud init

    Se você estiver usando SSH em um servidor remoto, utilize a sinalização --console-only para impedir que o comando inicie um navegador:

    gcloud init --console-only
  2. Siga as instruções para autorizar a gcloud a usar sua conta do Google Cloud.
  3. Crie uma nova configuração ou selecione uma atual.
  4. Escolha um projeto do Google Cloud.
  5. Escolha uma zona padrão do Compute Engine.

Como usar o gcloud config

  • Defina o ID do projeto padrão:
    gcloud config set project project-id
  • Se você estiver trabalhando com clusters zonais, defina a zona do Compute padrão:
    gcloud config set compute/zone compute-zone
  • Se você estiver trabalhando com clusters regionais, defina a região do Compute padrão:
    gcloud config set compute/region compute-region
  • Atualize gcloud para a versão mais recente:
    gcloud components update
  • Clusters de várias zonas usam mais recursos do que clusters de zona única. Se você estiver criando um cluster com várias zonas, verifique se você tem cotas adequadas.

Criar um cluster zonal

É possível criar uma zona usando a ferramenta gcloud ou o Console do Google Cloud.

gcloud

Para criar um cluster zonal com a ferramenta de linha de comando gcloud, use um dos comandos a seguir.

Substitua os valores de marcador nos comandos pelo seguinte:

  • cluster-name: o nome do novo cluster;
  • channel: o tipo de canal de lançamento, que pode ser rapid, regular ou stable;
  • compute-zone: a zona de computação do plano de controle do cluster.
  • version: a versão que você quer especificar para o cluster.
  • Na sinalização --node-locations, especifique uma lista separada por vírgulas de valores compute-zone em que o plano de controle e os nós são criados. Não coloque espaços entre os valores da zona.

Como usar um canal de lançamento:

gcloud container clusters create cluster-name \
    --release-channel channel \
    --zone compute-zone \
    --node-locations compute-zone,compute-zone,[...]

Como usar a versão padrão:

gcloud container clusters create cluster-name \
    --zone compute-zone \
    --node-locations compute-zone,compute-zone,[...]

Como usar uma versão específica:

gcloud container clusters create cluster-name \
    --cluster-version version \
    --zone compute-zone \
    --node-locations compute-zone,compute-zone,[...]

Exemplo: o comando a seguir cria um cluster multizonal chamado example-cluster, em que o plano de controle do cluster está localizado na zona us-central-a e há três locais de nó.

Quando a sinalização --num-nodes é omitida, o número padrão de nós por zona criado pelo cluster é três. Como três zonas foram especificadas, esse 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 \
    --zone us-central1-a \
    --node-locations us-central1-a,us-central1-b,us-central1-c

Console

Para criar um cluster zonal com o Console do Google Cloud, execute as seguintes tarefas:

  1. Acesse o menu do Google Kubernetes Engine no Console do Cloud.

    Acessar o menu do Google Kubernetes Engine

  2. Clique no botão Criar cluster.

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

    1. Insira o Nome do seu cluster.
    2. Em Tipo de local, selecione Por zona e selecione a zona pretendida do cluster.
    3. Se você estiver criando um cluster de várias zonas, marque a caixa de seleção Especificar os locais do nó e escolha as outras zonas em que quer executar o cluster.
    4. Escolha uma Versão principal. Recomendamos selecionar um canal de lançamento. Se você precisa especificar uma versão estática, o upgrade automático precisa estar ativado para seus pools de nós.

  4. No painel de navegação, em Pools de nós, clique em default-pool.

  5. Na seção Detalhes do pool de nós, preencha o seguinte:

    1. Insira um Nome para o pool de nós padrão.
    2. Escolha a versão de seus nós.
    3. Digite o Número de nós a serem criados no cluster. É preciso ter uma cota de recursos disponível para os nós e os respectivos recursos (como rotas de firewall).
  6. No painel de navegação, em Pools de nós, clique em Nós.

  7. Na lista suspensa Tipo de imagem, selecione a imagem de nó pretendida.

  8. 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 tipos de máquina, consulte a tabela de preços.

  9. Na lista suspensa Tipo de disco de inicialização, selecione o tipo de disco pretendido.

  10. Digite o Tamanho do disco de inicialização.

  11. Clique em Criar.

Depois de criar um cluster, é preciso configurar a kubectl antes de interagir com o cluster a partir da linha de comando.

Modelos de cluster

O GKE anteriormente era compatível com modelos para clusters. Esses modelos foram removidos do Console do Google Cloud, mas ainda podem ser acessados nos seguintes links:

A seguir