Canais de lançamento do Cloud Build

Este documento descreve como controlar a frequência com que os workers de build são atualizados com novas versões do sistema operacional de base e do Docker. Ao selecionar um canal de lançamento, você pode alcançar um equilíbrio entre processos de build resilientes e segurança e funcionalidade atualizadas.

Você também pode escolher versões específicas de worker em vez de canais.

Observação: os canais de lançamento gerenciam apenas o ambiente de host da VM de worker subjacente. Você mantém o controle total das versões de software nos contêineres da etapa de build.

Canais disponíveis

Estes são os canais de lançamento disponíveis:

Canal	Frequência de atualização	Usos
regular	Em até quatro semanas após a disponibilização de cada versão	O canal padrão e recomendado para compliance de segurança. Atualizações frequentes exigem que seus processos de CI sejam mantidos atualizados com novas versões.
rapid	Sempre a versão mais recente disponível	Receba os recursos e atualizações de segurança mais recentes assim que eles estiverem disponíveis. Novas versões do SO base e do Docker podem interromper o processo de CI e causar outros problemas.
stable	Uma vez por ano, geralmente em fevereiro	Esse canal prioriza a estabilidade em vez de novos recursos, ajudando seu processo de CI a ser mais resiliente. No entanto, há um risco maior de exposição a vulnerabilidades. As versões do Docker subjacentes podem não receber patches do Docker.

Consulte Versões disponíveis para saber qual versão está em cada canal.

Importante: até 28/03/2027, você vai usar a versão legacy por padrão. Depois dessa data, você vai usar o canal de lançamento regular por padrão. Você ainda pode especificar um canal de lançamento ou uma versão diferente na configuração de build ou ao invocar um build (no pool padrão) ou na configuração do pool particular.

Especificar um canal de lançamento ou uma versão

Ao escolher um dos três canais de lançamento, você define a frequência com que a versão do Docker e o sistema operacional da imagem do worker são atualizados. Ao escolher uma versão de lançamento, você seleciona as versões específicas do Docker e do Debian para a imagem do worker.

Você pode especificar o canal ou a versão de lançamento. Há três lugares em que você pode especificar essas opções:

• No pool privado

  Se você estiver usando um pool particular, especifique o canal ou a versão de lançamento no pool particular. Para isso, atualize a configuração do pool particular ou selecione um canal ou uma versão ao criar ou atualizar o pool no console do Google Cloud . Se você fizer isso, o canal ou a versão será usado em todos os builds que usam esse pool, e não será possível substituir na configuração de build ou na linha de comando.

• Na configuração do build

  Se você estiver usando o pool padrão, especifique o canal ou a versão no arquivo de configuração da build. Esse canal ou versão é usado para todos os builds invocados usando essa configuração de build.

• Na linha de comando ao invocar um build

  Ao invocar um build usando gcloud builds submit, inclua a flag --worker-release. O valor fornecido para essa flag substitui o que você configura no arquivo de configuração de build. Não é possível usar essa flag se o build estiver sendo executado em um pool particular, porque o pool decide qual versão usar.

Cloud Deploy

Para especificar uma versão de lançamento ou um canal para seu pool particular:

Atualize a configuração do pool particular usando o seguinte comando:

gcloud builds worker-pools update PRIVATEPOOL_ID \
       --worker-release=CHANNEL_OR_VERSION \
       --region=REGION \
       --project=PROJECT_ID

Substitua:

PRIVATEPOOL_ID com o ID do pool particular que você vai usar para executar builds usando este canal.

CHANNEL_OR_VERSION com o nome do canal que você quer usar: regular, rapid ou stable, ou com um número de versão específico.

REGION com a região em que o pool particular está localizado.

PROJECT_ID com o ID do projeto que contém seu pool particular.

configuração do build

Para especificar uma versão de lançamento ou um canal no arquivo de configuração do build:

Adicione a seguinte propriedade abaixo da estrofe options:

steps:
  # ...
options:
  workerRelease: CHANNEL_OR_VERSION

Substitua CHANNEL_OR_VERSION pelo nome do canal que você quer usar: regular, rapid ou stable, ou por um número de versão específico.

Observação: se você estiver usando um pool particular, não será possível definir o canal de lançamento no arquivo de configuração de build. Só é possível especificar o canal de lançamento na configuração de build se você estiver usando o pool padrão.

invocação de build

Para especificar um canal de lançamento na invocação de build:

Adicione a seguinte flag ao comando gcloud builds submit:

--worker-release=CHANNEL_OR_VERSION

Substitua CHANNEL_OR_VERSION pelo nome do canal que você quer usar: regular, rapid ou stable, ou com um número de versão específico.

Observação: se você estiver usando um pool particular, não será possível definir o canal de lançamento na linha de comando ao invocar um build. Só é possível especificar o canal de lançamento ou a versão na linha de comando se você estiver usando o pool padrão.

Versões disponíveis

A tabela a seguir lista as versões de worker disponíveis, os canais que são compatíveis com cada versão e as versões subjacentes do Docker e do Debian para cada uma delas:

Versão de lançamento	Canais	Compatível até	Versões subjacentes
2026.09	rapid, regular, stable	2029-09-30	Docker Engine 29 Debian 13
legacy		2028-03-31	Docker Engine 20.10 Debian 11

A seguir

• Saiba mais sobre o arquivo de configuração do build.
• Saiba mais sobre o arquivo de configuração do pool particular.
• Saiba mais sobre o modelo de responsabilidade compartilhada do Cloud Build.