Usar canais de lançamento

Como administrador da plataforma, é possível escolher um canal de lançamento específico para o cluster para garantir que o GKE faça upgrade automático do cluster 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, inscreve os clusters do Standard em um canal de lançamento. Para todos os modos de cluster, é possível escolher um canal de lançamento específico. Com os clusters padrão, é possível optar por não registrar o cluster em um canal de lançamento. No entanto, essa opção de configuração foi descontinuada e será removida em 14 de junho de 2027.

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

• Registrar um cluster em um canal de lançamento específico.
• Encontrar o canal de lançamento de um cluster.
• Ver as versões padrão e disponíveis para canais de lançamento.
• Mudar o canal de lançamento de um cluster.
• Cancele a inscrição do cluster nos canais de lançamento.

Antes de começar

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

• Ative a API Google Kubernetes Engine.
Ativar a API Google Kubernetes Engine
• Para usar a Google Cloud CLI nesta tarefa, instale e inicialize a CLI gcloud. Se você instalou a CLI gcloud anteriormente, instale a versão mais recente executando o comando gcloud components update. Talvez as versões anteriores da CLI gcloud não sejam compatíveis com a execução dos comandos neste documento.

• Se você quiser registrar um cluster no canal Extended, confira os preços do suporte estendido. Para clusters do GKE, 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

Nesta seção, mostramos 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 registrados no canal de lançamento Regular. É possível escolher um canal de lançamento específico para um cluster ao criá-lo ou alterar 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 registrados ou não 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 registrar um novo cluster em um canal de lançamento específico usando o console doCloud de Confiance ou a CLI gcloud.

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

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

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

As instruções a seguir explicam como registrar um cluster que não está registrado em um canal de lançamento. Se o cluster tiver o upgrade automático de nós desativado, consulte Registrar um cluster que não está inscrito em um canal de lançamento com o upgrade automático de nós desativado.

Registre o cluster em um canal de lançamento seguindo estas etapas:

1. Escolha um canal de lançamento: escolha o Canal estável ou outro que atenda melhor às suas necessidades. O canal estável é o mais maduro e tem todas as versões secundárias disponíveis para clusters não inscritos em um canal. Se você quiser novos recursos mais cedo ou precisar de suporte estendido para uma versão secundária, faça o seguinte:
   1. Escolha o melhor canal de lançamento para seu cluster.
   2. Verifique se a versão secundária do plano de controle do cluster está disponível no canal de lançamento de destino visualizando as versões padrão e disponíveis para os canais de lançamento. É possível registrar um cluster atual, desde que a versão secundária do plano de controle do cluster esteja disponível no canal de lançamento de destino. 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 Alterar o canal de lançamento do cluster.
2. Considere usar janelas de manutenção e exclusões: o GKE não exige inatividade para mudar o registro 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 fazer upgrade automático do cluster. Recomendamos usar janelas de manutenção e exclusões para controlar o tempo dos upgrades.
3. Atualize o canal de lançamento do cluster para o CHANNEL de destino: selecione o canal de lançamento de destino, que pode ser qualquer opção diferente de None.

O GKE não faz upgrade imediato do plano de controle do cluster e dos nós para o destino de upgrade automático da versão secundária 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 receber destinos de upgrade automático para um cluster específico, consulte Receber informações sobre os upgrades de um cluster.

Registrar um cluster atual que tenha o upgrade automático de nós desativado

Siga as instruções abaixo se você tiver um cluster Standard que não esteja inscrito em um canal de lançamento e tiver desativado os upgrades automáticos de nós em um ou mais pools de nós do cluster. Se você quiser acessar os recursos adicionais dos canais de lançamento e migrar dessa opção de configuração descontinuada, é possível inscrever o cluster em um canal de lançamento sem outras mudanças.

O GKE não ativa automaticamente a configuração de upgrade automático de nós para os pools de nós ao registrar o cluster em um canal. No entanto, essa configuração é legada. Ao registrar o cluster em um canal, também recomendamos o uso de exclusões de manutenção do pool de nós para evitar upgrades no nível do pool de nós da mesma maneira.

Siga estas etapas para registrar um cluster em um canal de lançamento:

1. Registre o cluster atual no canal de lançamento de destino atualizando o canal, especificando stable. O Canal estável é o mais maduro e tem todas as versões secundárias disponíveis para clusters não inscritos em um canal.
2. Opcional: siga as etapas adicionais abaixo para migrar para o uso de exclusões de manutenção em vez da configuração legada de desativação de upgrades automáticos de nós com a configuração. É possível realizar essas etapas a qualquer momento depois de registrar o cluster em um canal de lançamento:
   1. Evite upgrades automáticos de nós de uma das seguintes maneiras:
      1. Somente para alguns pools de nós: configure uma exclusão de manutenção de pool de nós para todos os pools de nós em que os upgrades automáticos de nós estão desativados. Desativar os upgrades automáticos de nós com essa exclusão impede todos os upgrades automáticos de pools de nós, exceto os upgrades automáticos no fim do suporte, que acontecem independentemente da inscrição no canal de lançamento e de como você desativou os upgrades automáticos de nós.
      2. Para todos os pools de nós: configure uma exclusão de manutenção com o escopo "Sem upgrades secundários ou de nós". Essa exclusão impede todos os upgrades, exceto os de patch para o plano de controle. Agora que o cluster está inscrito em um canal de lançamento, é possível usar esse escopo de exclusão de manutenção, que pode durar até a data de fim do suporte para a versão secundária no canal de lançamento do cluster.
   2. Remova o uso do campo legado para desativar os upgrades automáticos de nós, porque as exclusões de manutenção que você configurou na etapa anterior agora executam essa função. Para cada pool de nós, siga as instruções para ativar upgrades automáticos de nós para um pool de nós atual.

Encontrar o canal de lançamento do cluster

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

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

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 Cloud de Confiance console 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, crie um novo cluster no canal de destino e migre suas 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, registre o cluster no canal estendido.

Confira os preços para registrar o cluster no canal estendido e as limitações de recursos. Não será possível registrar o cluster no canal Extended se ele estiver usando determinados recursos.

Mudar o cluster no canal Extended

Se um cluster estiver inscrito no canal estendido durante o período de suporte estendido, ele poderá continuar executando uma versão secundária que não é compatível com 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. Siga 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 término do suporte padrão para essa versão secundária mais recente e compatível.
2. Atualize o canal de lançamento do cluster.

Atualizar o canal de lançamento do cluster

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

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

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 até 14 de junho de 2027, essa é uma opção de configuração descontinuada e recomendamos que você analise a comparação entre clusters inscritos e não inscritos em um canal de lançamento. Entenda as vantagens e desvantagens de registrar ou não o cluster em um canal de lançamento.

É possível realizar essa ação com o console do Cloud de Confiance , a CLI gcloud ou a API GKE. 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.

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

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, o GKE vai recomendar que você inscreva o cluster em um canal de lançamento, fornecendo essa orientação com um insight e uma recomendação por meio do serviço Recomendador. Essas orientações não se aplicam aos clusters do Autopilot, que estão sempre registrados em um canal de lançamento.

Para encontrar clusters que não estão registrados em um canal de lançamento, use uma das seguintes maneiras:

• Use o console do Cloud de Confiance .
• 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 registrar clusters existentes. Para saber mais sobre como implementar essa recomendação, consulte Sobre os canais de lançamento. Para comparar os recursos de um cluster inscrito 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.

Usar upgrades automáticos de patch acelerados

É possível usar upgrades automáticos de patch acelerados para que o GKE faça upgrade automático do cluster para versões de patch assim que elas estiverem disponíveis em um canal de lançamento, em vez de quando o GKE definir as versões como um destino de upgrade automático pelo menos uma semana depois.

Para usar os upgrades automáticos de patch acelerados, defina a flag --patch-update=accelerated com a CLI gcloud ao criar o cluster ou atualizar o cluster.

Essa configuração está disponível apenas para clusters inscritos em um canal de lançamento e não afeta os upgrades de versão secundária.

Desativar upgrades automáticos de patch acelerados

É possível atualizar o cluster para desativar os upgrades automáticos de patch acelerados, para que o cluster receba versões de patch somente depois que o GKE definir a versão de patch como um destino de upgrade automático. Essa ação reverte o cluster para a configuração padrão e não desativa os upgrades automáticos.

Para atualizar o cluster, defina a flag --patch-update=default.

A seguir

• Sobre os canais de lançamento