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.

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.

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

Nas instruções das seções a seguir, mostramos como:

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 para clusters zonais ou uma região para clusters regionais ou de Autopilot.

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 de Autopilot ou 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

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.

Use a ferramenta gcloud ou o Console do Google Cloud para criar o cluster.

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

gcloud

Para criar um cluster regional com a ferramenta gcloud, use um dos comandos a seguir e substitua as seguintes variáveis:

  • 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 pool de nós, como us-central1-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 ser rapid, regular, stable ou None Por padrão, o cluster é registrado no canal de lançamento regular se as seguintes sinalizações não forem especificadas: --cluster-version, --release-channel, --no-enable-autoupgrade e --no-enable-autorepair.
  • VERSION: a versão que você quer especificar para o cluster.

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 \
    --region COMPUTE_REGION \
    --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 \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --cluster-version VERSION

Como usar a versão padrão estática:

Para criar um novo cluster usando a versão estática padrão do cluster, não é necessário precisa especificar uma versão do cluster, mas é necessário definir o canal de lançamento como None:

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --release-channel None

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 \
    --region 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 \
    --region us-west1 \
    --node-locations us-west1-c \
    --num-nodes 2

Console

  1. Acesse a página do Google Kubernetes Engine no Console do Cloud:

    Acessar o Google Kubernetes Engine

  2. Clique em Criar.

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

    1. Insira o Nome do cluster.
    2. Em Tipo de local, selecione Regional e selecione a região pretendida para o cluster.
    3. 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.
    4. Escolha uma Versão do plano de controle. O padrão é a opção recomendada de Canal de lançamento. Se você precisar especificar uma versão estática, o upgrade automático precisa estar ativado para os 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. Para nós de versão estática, escolha a Versão do nó.
    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.

  12. Na seção Padrão, clique em Configurar.

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.

Use a ferramenta gcloud ou o Console do Google Cloud para criar o cluster.

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

gcloud

Para criar um cluster regional com a ferramenta gcloud, use um dos comandos a seguir e substitua as seguintes variáveis:

  • CLUSTER_NAME: o nome do novo cluster regional;
  • COMPUTE_REGION: a região desejada para o cluster, como us-central1;
  • CHANNEL: o tipo de canal de lançamento, que pode ser rapid, regular, stable ou None Por padrão, o cluster é registrado no canal de lançamento regular se as seguintes sinalizações não forem especificadas: --cluster-version, --release-channel, --no-enable-autoupgrade e --no-enable-autorepair.
  • 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-locations opcional para modificar as zonas padrão em que os nós são replicados.

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 \
    --region COMPUTE_REGION \
    --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 \
    --region COMPUTE_REGION \
    --cluster-version VERSION

Como usar a versão padrão estática:

Para criar um novo cluster usando a versão estática padrão do cluster, não é necessário precisa especificar uma versão do cluster, mas é necessário definir o canal de lançamento como None:

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --release-channel None

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 --region 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 \
    --region 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 \
    --region us-central1 \
    --node-locations us-central1-b,us-central1-c

Console

  1. Acesse a página do Google Kubernetes Engine no Console do Cloud:

    Acessar o Google Kubernetes Engine

  2. Clique em Criar.

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

    1. Insira o Nome do cluster.
    2. Em Tipo de local, selecione Regional e selecione a região pretendida para o cluster.
    3. 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.
    4. Escolha uma Versão do plano de controle. O padrão é a opção recomendada de Canal de lançamento. Se você precisar especificar uma versão estática, o upgrade automático precisa estar ativado para os 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. Para nós de versão estática, escolha a Versão do nó.
    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.

  12. Na seção Padrão, clique em Configurar.

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

A seguir