Gerenciar versões do Skaffold

O Cloud Deploy usa o Skaffold, por meio do Cloud Build, para implantar seu aplicativo renderizando e implantando manifestos.

Nesta página, descrevemos como o Cloud Deploy seleciona qual versão do Skaffold usar. Esta página também inclui informações sobre o seguinte:

Qual versão do Skaffold o Cloud Deploy usa?

O Cloud Deploy executa as operações usando uma imagem personalizada, que inclui uma versão LTS do Skaffold. Cada versão compatível do Skaffold 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 imagem do Cloud Deploy corresponde ao número da versão do Skaffold.

Antes de 30 de agosto de 2022, o Cloud Deploy usava a versão LTS das imagens mais recentes do Skaffold disponíveis publicamente.

Versões compatíveis

Versão Skaffold Versão máxima do esquema A partir de Padrão?
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
2.6.x (notas da versão) v4beta6 6 de julho de 2023
2.3.x (notas da versão) v4beta4 24 de abril de 2023
2.0.x (notas da versão) v4beta1 9 de janeiro de 2023

Cada versão nesta tabela está vinculada a um repositório no Artifact Registry. Nesse repositório, procure a data mais recente para a versão mais recente ou para a 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 compatível do Skaffold. Anunciamos o suporte para novas versões, incluindo patches específicos 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 visualização.

A versão do Skaffold na imagem de visualização pode ser atualizada a qualquer momento e não segue uma programação regular de lançamentos. Recomendamos que você não use a versão de pré-lançamento 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. Procure imagens com uma tag que comece com skaffold_preview.

Alguns recursos de pré-lançamento exigem a imagem de visualização do Cloud Deploy. Para esses recursos, o Cloud Deploy usa a versão de pré-lançamento sem que você precise fazer nada. Se você tentar selecionar uma versão diferente do Skaffold ao criar uma versão usando um recurso de pré-lançamento, o comando falhará.

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.

Escolher qual versão do Skaffold usar

Use qualquer versão compatível do Skaffold. Para selecionar a versão que você quer usar, inclua a sinalizaçã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

"SKAFFOLD_VERSION" é a versão (com suporte) do Skaffold a ser usada nesta versão. A versão precisa 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 você pode 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 no próximo ciclo de 90 dias.

As Notas de lançamento do Cloud Deploy são atualizadas para anunciar cada versão recém-compatível.

Política de suspensão de uso e manutenção da versão do Skaffold

As versões do Skaffold têm 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 serão compatíveis por 60 dias após a expiração. Ainda é possível criar lançamentos com base nessas versões, mas não é possível criar versões usando uma versão do Skaffold que esteja em período de manutenção.

Após o período de manutenção de 60 dias, não haverá mais suporte para a versão do Skaffold. Não é mais possível criar lançamentos de uma versão que usa a versão sem suporte. No entanto, os dados associados à versão vão ser mantidos.

Versão Skaffold A partir de Início da manutenção Validade
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
2.6.x (notas da versão) 6 de julho de 2023 6 de julho de 2024 4 de setembro de 2024
2.3.x (notas da versão) 24 de abril de 2023 1o de maio de 2024 1 de julho de 2024
2.0.x (notas da versão) 9 de janeiro de 2023 9 de janeiro de 2024 10 de março de 2024

A seguir