Como criar um cluster regional

Neste tópico, você verá como criar um cluster regional para aumentar a disponibilidade do plano de controle e cargas de trabalho do cluster durante upgrades de cluster, manutenção automatizada ou uma interrupção por zona. Ao criar um cluster regional em vez de um cluster de zona única ou de várias zonas, as réplicas do plano de controle e dos nós são executadas em várias zonas de uma determinada região. Por padrão, os nós de um cluster regional também são replicados nas mesmas zonas que o plano de controle.

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

Depois de criar um cluster regional, não será possível convertê-lo em um cluster de zona única ou de várias zonas.

Os clusters regionais replicam recursos em várias zonas e consomem cotas adicionais.

Se você estiver desenvolvendo aplicativos do GKE com o Visual Studio Code, tente criar clusters regionais com a extensão do Cloud Code.

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

Como criar um cluster regional

É possível criar um cluster regional usando a ferramenta gcloud ou o Console do Google Cloud.

gcloud

Para criar um cluster regional 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 regional;
  • compute-region: a região desejada para o cluster, como us-central1;
  • compute-zone: a zona desejada para o cluster;
  • channel: o tipo de canal de lançamento, que pode ser rapid, regular ou stable;
  • 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 menos zonas são preferenciais, use a sinalização --node-locations opcional para modificar as zonas padrão em que os nós são replicados. Ao usar essa sinalização, especifique uma lista separada por vírgulas de valores compute-zone. Não coloque espaços entre as zonas.

Como usar a versão padrão:

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

Exemplo: para criar um cluster regional 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 --region us-west1

Exemplo: para criar um cluster regional com seis nós (três zonas com dois nós cada, especificadas por --num-nodes):

gcloud container clusters create my-regional-cluster \
    --num-nodes 2 \
    --region us-west1

Exemplo: para criar um cluster regional 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 \
    --region us-central1 \
    --node-locations us-central1-b,us-central1-c

Como usar uma versão específica:

Também é possível especificar uma versão exata do cluster usando a sinalização --cluster-version. Sem as especificações de canal de lançamento ou versão do cluster, a versão usada será a padrão atual.

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

Como usar um canal de lançamento:

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

Console

  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 Regional e selecione a região pretendida para o cluster.
    3. 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.

A seguir