Usar canais de lançamento

Como administrador da plataforma, você pode escolher um canal de lançamento específico para o cluster e garantir que o GKE faça upgrade automático para versões com o equilíbrio escolhido entre disponibilidade e estabilidade de recursos. Para saber mais sobre os canais de lançamento, consulte Sobre os canais de lançamento.

O GKE inscreve todos os clusters do Autopilot em um canal de lançamento e, por padrão, os clusters padrão em um canal de lançamento. Para todos os modos de cluster, é possível escolher um canal de lançamento específico. Com clusters padrão, você pode optar por não registrar seu cluster em um canal de lançamento.

Nesta página, explicamos como realizar as seguintes ações relacionadas aos canais de lançamento:

Antes de começar

Antes de começar, veja se você realizou as seguintes tarefas:

  • Ative a API Google Kubernetes Engine.
    • Ativar a API Google Kubernetes Engine
  • Se você quiser usar a CLI do Google Cloud para essa tarefa, instale e, em seguida, inicialize a CLI gcloud. Se você instalou a gcloud CLI anteriormente, instale a versão mais recente executando gcloud components update.
  • Se você quiser inscrever um cluster no canal estendido, confira os preços do suporte estendido. É possível inscrever um cluster no canal estendido sem custo financeiro extra se o projeto tiver ativado o GKE Enterprise. Ou, para clusters da edição GKE Standard, os custos de pagamento por uso são aplicados quando o cluster está inscrito no canal estendido e a versão secundária do cluster entra no período de suporte estendido.

Registrar um cluster em um canal de lançamento

Esta seção mostra como selecionar um canal de lançamento específico para clusters novos ou para clusters atuais que não usavam um canal de lançamento anteriormente. Também é possível mudar o canal de lançamento de um cluster existente que já esteja inscrito em um canal de lançamento.

Registrar um novo cluster em um canal de lançamento específico

Por padrão, todos os clusters são inscritos no canal de lançamento normal. É possível escolher um canal de lançamento específico para um cluster ao criá-lo ou mudar o canal de lançamento depois que o cluster for criado. Os clusters do Autopilot precisam estar registrados em um canal de lançamento. Os clusters padrão podem ser inscritos ou cancelados em um canal de lançamento. Para o canal estendido, consulte Receber suporte de longo prazo com o Canal estendido antes de selecionar esse canal.

É possível criar e inscrever um novo cluster em um canal de lançamento específico usando o console do Google Cloud ou a CLI gcloud.

Console

Crie um cluster com as seguintes etapas, dependendo do modo do cluster:

  • Para clusters do Autopilot:

    1. Na página de criação do cluster do Autopilot, no painel de navegação, clique em Configurações avançadas:

      Criar um cluster do Autopilot

    2. Na lista suspensa Canal de lançamento, selecione um canal de lançamento para registrar o cluster ou deixe o valor padrão Canal normal.

  • Para clusters padrão:

    1. Na página de criação de cluster padrão, na seção Noções básicas do cluster, navegue até a subseção Canal de lançamento:

      crie um cluster do Kubernetes

    2. Na lista suspensa Canal de lançamento, selecione um canal de lançamento para registrar o cluster ou deixe o valor padrão Canal normal.

gcloud

Para criar e inscrever um cluster do Autopilot em um canal de lançamento específico, execute o seguinte comando:

gcloud container clusters create-auto CLUSTER_NAME \
    --location=COMPUTE_LOCATION
    --release-channel=CHANNEL

Para criar e registrar um cluster Standard em um canal de lançamento específico, execute o seguinte comando:

gcloud container clusters create CLUSTER_NAME \
    --location=COMPUTE_LOCATION \
    --release-channel=CHANNEL

Substitua:

  • CLUSTER_NAME: o nome do novo cluster;
  • CLUSTER_LOCATION: a região do Compute Engine para o novo cluster.
  • CHANNEL: o tipo de canal de lançamento: rapid, regular, stable ou, apenas para o padrão, extended.

Para conferir uma lista de outras opções que podem ser especificadas, consulte a documentação de referência de gcloud container clusters create-auto e gcloud container clusters create.

Também é possível criar um cluster com uma versão específica usando a sinalização --cluster-version. Se você não especificar um canal de lançamento, o GKE registrará seu cluster no canal de lançamento mais maduro em que essa versão estiver disponível.

Além disso, se você não especificar o canal de lançamento ou a versão do cluster, o cluster será padronizado para o canal de lançamento regular na versão padrão.

Registrar um cluster

É possível inscrever um cluster atual em um canal de lançamento, desde que a versão secundária do plano de controle do cluster esteja disponível no canal de lançamento de destino. Para verificar se a versão secundária do plano de controle do cluster está disponível no canal de lançamento de destino, confira as versões padrão e disponíveis para os canais de lançamento. Para saber mais sobre como alinhar a versão do plano de controle do cluster às versões disponíveis para o canal de lançamento de destino, consulte Selecionar um novo canal de lançamento.

O GKE não exige tempo de inatividade para mudar a inscrição do canal de lançamento de um cluster. No entanto, o GKE pode ter diferentes upgrades automáticos disponíveis em um canal de lançamento diferente, o que significa que, após a mudança, o GKE pode atualizar o cluster automaticamente. Recomendamos usar janelas de manutenção e exclusões para controlar o tempo dos upgrades.

Para se inscrever, atualize o canal de lançamento do cluster para o CHANNEL desejado.

O GKE não faz upgrade imediato do plano de controle do cluster e dos nós para a versão secundária de destino do upgrade automático nesse canal de lançamento ao se inscrever. Em vez disso, eles são atualizados gradualmente pelo processo de upgrade automático do GKE. Para conferir os destinos de upgrade automático de um cluster específico, consulte Receber informações sobre os upgrades de um cluster (pré-lançamento).

Inscrever um cluster que não está registrado em um canal de lançamento e com o upgrade automático do nó desativado

Se você tiver um cluster padrão que não está inscrito em um canal de lançamento e tiver desativado os upgrades automáticos de nós em um ou mais dos pools de nós do cluster, mas quiser acessar os recursos adicionais dos canais de lançamento, use exclusões de manutenção para impedir upgrades de nós. Se você mudar para um canal de lançamento e usar exclusões de manutenção, não será possível impedir upgrades automáticos de nós no nível do pool de nós, apenas no nível do cluster. No entanto, é possível fazer upgrade manual dos pools de nós.

Siga estas etapas para inscrever um cluster em um canal de lançamento e continuar impedindo upgrades automáticos de nós:

  1. Configure uma exclusão de manutenção com o escopo "Sem upgrades". Esse é o único escopo de exclusão de manutenção disponível para clusters não inscritos em um canal de lançamento. Isso impede que o cluster seja atualizado automaticamente imediatamente se houver um novo destino de upgrade automático qualificado no canal de lançamento selecionado.
  2. Inscreva o cluster no canal de lançamento de destino. Com essa mudança, o GKE faz as seguintes alterações nas configurações dos seus pools de nós:
    1. O GKE ativa a configuração de upgrade automático de nós para todos os pools de nós em que o recurso está desativado, mas não faz upgrade automático dos nós porque você configurou a exclusão de manutenção na etapa 1.
    2. O GKE ativa o reparo automático de nós em todos os pools de nós em que o recurso está desativado. No entanto, você pode desativar o reparo automático de nós com a CLI gcloud se quiser manter essa configuração.
  3. Configure uma exclusão de manutenção com o escopo "Sem upgrades menores ou de nós". Isso impede todos os upgrades, exceto os upgrades de patch para o plano de controle. Agora que o cluster está registrado em um canal de lançamento, é possível usar esse escopo de exclusão de manutenção, que pode durar até o fim da data de suporte da versão secundária no canal de lançamento do cluster.
  4. Remova a exclusão de manutenção criada na etapa 1 agora que você adicionou a nova exclusão de manutenção na etapa anterior.

Depois de concluir essas etapas, você terá um cluster em que o GKE não vai fazer upgrade automático dos nós até que você remova a exclusão de manutenção ou a versão secundária dos nós atinja o fim do suporte.

Encontrar o canal de lançamento do cluster

É possível determinar o canal de lançamento do cluster usando o console do Google Cloud ou a CLI gcloud.

Console

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

    Acessar o Google Kubernetes Engine

  2. Clique no nome do cluster que você quer inspecionar.

  3. Em Conceitos básicos do cluster, verifique o valor no campo Canal de lançamento (por exemplo, Canal normal).

Se o valor for Nenhum, o cluster não estará inscrito em um canal de lançamento.

gcloud

gcloud container clusters describe CLUSTER_NAME \
    --location=COMPUTE_LOCATION --format="value(releaseChannel.channel)"

Substitua:

Se a saída estiver vazia, o cluster não está registrado em um canal de lançamento.

Ver as versões padrão e disponível para canais de lançamento

Para verificar quais versões estão disponíveis em um canal de lançamento específico com o console do Google Cloud ou a CLI gcloud, siga as instruções para verificar as versões disponíveis e padrão.

Alterar o canal de lançamento do cluster

Será possível alterar o canal de lançamento do cluster se a versão secundária do plano de controle estiver disponível no canal de lançamento de destino. Talvez seja necessário fazer upgrade ou downgrade do plano de controle do cluster para uma versão disponível.

Para verificar se a versão do plano de controle do cluster está disponível no canal de lançamento de destino, veja as versões padrão e disponíveis para os canais de lançamento. A versão precisa estar disponível no canal de destino.

  • Se a versão do plano de controle do cluster já estiver disponível no canal de lançamento de destino, selecione o novo canal de lançamento.
  • Se a versão do plano de controle do cluster não estiver disponível no canal de lançamento de destino, será possível fazer upgrade do plano de controle do cluster para uma versão disponível. Como alternativa, se o canal de destino tiver apenas versões anteriores disponíveis, você poderáfazer downgrade do cluster , desde que a versão de destino seja umlançamento de patch anterior da mesma versão secundária.

Para selecionar um novo canal de lançamento, atualize o canal de lançamento do cluster para o CHANNEL desejado. Se você quiser impedir temporariamente o upgrade automático do cluster quando selecionar o novo canal, configure uma exclusão de manutenção antes de selecionar o novo canal.

Se não for possível selecionar o canal de lançamento de destino porque o cluster está executando uma versão que não está disponível nesse canal de lançamento, faça o seguinte:

  1. Configure uma exclusão de manutenção com o escopo "Sem upgrades menores".
  2. Aguarde até que o canal de lançamento de destino seja disponibilizado para a versão secundária do Kubernetes do seu cluster.
  3. Registre o cluster existente no canal de lançamento de destino.

Como alternativa, é possível criar um novo cluster no canal de destino e migrar as cargas de trabalho.

Mudar o cluster para o canal Extended

Para receber suporte de longo prazo, mantendo o cluster nessa versão pelo maior tempo possível, inscreva-o no canal estendido.

Confira os preços para inscrever seu cluster no canal estendido e as limitações do recurso. Não é possível registrar o cluster no canal Extended se ele estiver usando determinados recursos.

Mudar o cluster no canal estendido

Se um cluster for registrado no canal estendido durante o período de suporte estendido, ele poderá continuar executando uma versão secundária que não tem suporte em outros canais. Se você quiser mudar o cluster do canal estendido, em que a versão secundária não é compatível, siga estas etapas:

  1. Conclua estas duas etapas, que podem ser feitas em qualquer ordem:
    1. Faça upgrade manual do cluster para uma versão secundária no período de suporte padrão disponível no canal de lançamento de destino.
    2. Remova ou modifique qualquer exclusão de manutenção com uma data de término que exceda a data de fim do suporte padrão para essa versão secundária mais recente com suporte.
  2. Atualize o canal de lançamento do cluster.

Atualizar o canal de lançamento do cluster

É possível mudar o canal de lançamento do cluster usando o console do Google Cloud ou a CLI gcloud.

Console

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

    Acessar o Google Kubernetes Engine

  2. Clique no nome do cluster que você quer inspecionar.

  3. Em Conceitos básicos de cluster, no campo Canal de lançamento, clique em .

  4. No menu suspenso Canal de lançamento, selecione o canal de lançamento de destino.

  5. Leia e confirme o aviso selecionando Entendo que podem ocorrer inatividades durante os upgrades de versão.

  6. Clique em Salvar alterações.

gcloud

Altere a propriedade do canal de lançamento de um cluster existente:

gcloud container clusters update CLUSTER_NAME \
  --release-channel CHANNEL

Substitua:

  • CLUSTER_NAME: o nome do cluster.
  • CHANNEL: o canal de lançamento de destino, que pode ser rapid, regular, stable e, apenas para o padrão, extended ou None.

Cancelar a inscrição em um canal de lançamento

Embora seja possível cancelar a inscrição do cluster padrão em um canal de lançamento, recomendamos que você analise a comparação entre clusters inscritos e não inscritos em um canal de lançamento para entender as vantagens e desvantagens de inscrever seu cluster em um canal de lançamento.

É possível realizar essa ação com o console Google Cloud , a CLI gcloud ou a API Kubernetes Engine. Também é possível especificar que você não quer registrar o cluster padrão em um canal de lançamento durante a criação dele. Não é possível cancelar a inscrição de clusters do Autopilot em um canal de lançamento.

Console

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

    Acessar o Google Kubernetes Engine

  2. Clique no nome do cluster que você quer inspecionar.

  3. Em Conceitos básicos de cluster, no campo Canal de lançamento, clique em .

  4. Selecione Versão estática no menu suspenso.

  5. Leia e confirme o aviso selecionando Entendo que podem ocorrer inatividades durante os upgrades de versão.

  6. Clique em Salvar alterações.

gcloud

Atualize o canal de lançamento do cluster para um valor de None:

gcloud container clusters update CLUSTER_NAME \
  --release-channel None

API

Especifique "releaseChannel": { "channel": UNSPECIFIED} ao criar ou atualizar um cluster.

Identificar clusters não registrados em um canal de lançamento

Se você tiver um cluster do GKE Standard que não esteja inscrito em um canal de lançamento e todos os pools de nós tiverem o upgrade automático de nós ativado, recomendamos que você inscreva o cluster em um canal de lançamento. O GKE oferece essa orientação com um insight e uma recomendação pelo serviço Recommender. Essas orientações não se aplicam aos clusters do Autopilot, que são sempre registrados em um canal de lançamento.

Para encontrar clusters não inscritos em um canal de lançamento, use uma das seguintes opções:

  • Use o console Google Cloud .
  • Use a CLI gcloud ou a API Recommender especificando o subtipo de recomendador CLUSTER_RELEASE_CHANNEL_UNSPECIFIED.

Para mais instruções, consulte como ver insights e recomendações.

Para implementar essa recomendação, siga as instruções para inscrição de clusters existentes. Para saber se você quer implementar essa recomendação, consulte Sobre os canais de lançamento. Para comparar os recursos entre um cluster registrado ou não em um canal de lançamento, consulte a comparação entre clusters inscritos e não inscritos em um canal de lançamento.

A seguir