O Cloud Deploy usa o Skaffold, por meio do Cloud Build, para implantar o aplicativo renderizando e implantando manifestos.
Nesta página, descrevemos como o Cloud Deploy seleciona qual versão do Skaffold usar. Essa página também inclui informações sobre o seguinte:
- Com que frequência a versão do Skaffold muda
- Como descobrir a versão atual
- Por quanto tempo cada versão é compatível
Qual versão do Skaffold é usada pelo Cloud Deploy?
O Cloud Deploy executa as operações usando uma imagem personalizada, que inclui uma versão LTS do Skaffold. Cada versão do Skaffold com suporte está listada na tabela deste documento, vinculada ao repositório de todas as imagens do Cloud Deploy. O número da versão de cada Cloud Deploy imagem corresponde ao número da versão do Skaffold.
Antes de 30 de agosto de 2022, o Cloud Deploy usava a versão LTS do imagens do Skaffold disponíveis publicamente mais recentes.
Versões compatíveis
| Versão Skaffold | Versão máxima do esquema | A partir de | Padrão? |
|---|---|---|---|
| 2.13.x (notas da versão) | v4beta11 | 1o de agosto de 2024 | ✓ |
| 2.11.x (notas da versão) | v4beta10 | 6 de maio de 2024 | |
| 2.10.x (notas da versão) | v4beta9 | 2 de fevereiro de 2024 | |
| 2.8.x (notas da versão) | v4beta7 | 27 de outubro de 2023 |
Cada versão nesta tabela está vinculada a um repositório no Artifact Registry. Nesse
repositório, procure a data mais recente da versão mais recente ou da
versão que você quer. O repositório vinculado está na região us-central1, mas
essas imagens estão disponíveis em cada região em que o Cloud Deploy está
disponível. A imagem usada está na região em que o pipeline de
entrega foi criado.
O Cloud Deploy usa a versão de patch mais recente para cada versão do Skaffold com suporte. Anunciamos o suporte para novas versões, incluindo Patches da versão do Skaffold, nas notas da versão.
Versão para visualização
É possível usar a imagem de visualização do Cloud Deploy, que inclui recursos de pré-lançamento.
A versão do Skaffold na imagem de visualização pode ser atualizada a qualquer momento e não segue uma programação de lançamento regular. Recomendamos que você não use a visualização para cargas de trabalho de produção.
A versão de pré-lançamento está no mesmo repositório que as versões compatíveis. Olhe
para imagens com uma tag que começa com skaffold_preview.
Alguns recursos de visualização exigem a imagem de visualização do Cloud Deploy. Para esses recursos, o Cloud Deploy usa essa versão de pré-lançamento sem que você precise fazer nada. Se você tentar selecionar outro Skaffold quando você cria uma versão usando um recurso em fase de pré-lançamento, o comando falha.
Descubra a versão do Skaffold associada a uma versão.
Para encontrar a versão que o Cloud Deploy está usando a qualquer momento, execute o seguinte comando:
gcloud deploy releases describe RELEASE \
--delivery-pipeline=DELIVERY_PIPELINE \
--region=REGION
A versão é mostrada no atributo skaffoldVersion na saída.
Escolha qual versão do Skaffold usar
É possível usar qualquer versão compatível do Skaffold.
Para selecionar a versão que você quer usar, inclua o
--skaffold-version
no comando gcloud deploy releases create:
gcloud deploy releases create RELEASE_NAME \
--delivery-pipeline=PIPELINE_NAME \
--skaffold-version=SKAFFOLD_VERSION \
--region=REGION
Em que "SKAFFOLD_VERSION" é a versão (compatível)
do Skaffold para usar nesta versão. A versão deve estar no formato de
n.nn para uma versão numerada ou skaffold_preview para usar a versão de pré-lançamento.
Por exemplo, o comando a seguir seleciona a versão 2.8 do Skaffold:
gcloud deploy releases create release-001 \
--delivery-pipeline=my-pipeline \
--skaffold-version=2.8 \
--region=us-central1
E este comando seleciona a versão de visualização do Skaffold:
gcloud deploy releases create release-001 \
--delivery-pipeline=my-pipeline \
--skaffold-version=skaffold_preview \
--region=us-central1
Como o Cloud Deploy seleciona novas versões
Uma nova versão do Skaffold é selecionada a cada 90 dias. No final desse ciclo de 90 dias, o Google Cloud adiciona compatibilidade com uma nova versão do Skaffold. Agora é possível usar essa versão com o Cloud Deploy. Ela se torna a versão padrão usada para criar e gerenciar todas as versões para o próximo ciclo de 90 dias.
As Notas de lançamento do Cloud Deploy foram atualizadas para e anunciar cada versão com suporte.
Política de suspensão de uso e manutenção da versão do Skaffold
As versões do Skaffold recebem suporte por 12 meses, com um período de manutenção de 60 dias. Esse período de manutenção significa que as versões vinculadas a uma versão ainda suporte por 60 dias após a expiração do suporte para a versão em questão. Ainda é possível criar lançamentos dessas versões, mas não é possível criar versões usando uma versão do Skaffold que esteja no período de manutenção.
Após o período de manutenção de 60 dias, a versão do Skaffold não será mais compatível. Não é mais possível criar lançamentos de uma versão que usa a versão sem suporte. No entanto, todos os dados associados à versão permanecem.
| Versão Skaffold | A partir de | Início da manutenção | Expiração |
|---|---|---|---|
| 2.13.x (notas da versão) | 1o de agosto de 2024 | 14 de agosto de 2025 | 13 de outubro de 2025 |
| 2.11.x (notas da versão) | 6 de maio de 2024 | 6 de maio de 2025 | 5 de julho de 2025 |
| 2.10.x (notas da versão) | 2 de fevereiro de 2024 | 2 de fevereiro de 2025 | 3 de abril de 2025 |
| 2.8.x (notas da versão) | 26 de outubro de 2023 | 26 de outubro de 2024 | 25 de dezembro de 2024 |
A seguir
Saiba mais sobre como integrar o Cloud Deploy a outros sistemas.
Saiba mais sobre como o Skaffold funciona com o Cloud Deploy e como fazer com que ele funcione bem para você.
No documento Como gerenciar manifestos no Cloud Deploy, você encontra mais informações sobre como usar o Skaffold, inclusive com outras ferramentas de gerenciamento de manifestos de terceiros.