Faça a gestão das versões do Skaffold

O Cloud Deploy usa o Skaffold, através do Cloud Build, para implementar a sua aplicação através da renderização e implementação de manifestos.

A página descreve como o Cloud Deploy seleciona a versão do Skaffold a usar. Esta página também inclui informações sobre o seguinte:

Que versão do Skaffold usa o Cloud Deploy?

O Cloud Deploy executa as respetivas operações através de uma imagem personalizada, que inclui uma versão LTS do Skaffold. Cada versão suportada do Skaffold está listada na tabela neste documento, com um link para o repositório de todas as imagens do Cloud Deploy. O número de versão de cada imagem do Cloud Deploy corresponde ao número de versão do Skaffold.

Versões suportadas

Versão do Skaffold Versão máxima do esquema Data de referência Predefinição?
2.16.x (notas de lançamento) v4beta13 16 de maio de 2025 ✓
2.14.x (notas de lançamento) v4beta12 17 de fevereiro de 2025
2.13.x (notas de lançamento) v4beta11 1 de agosto de 2024

Cada versão nesta tabela tem um link para um repositório no Artifact Registry. Nesse repositório, procure a data mais recente da versão mais recente ou a versão que quer. O repositório associado está na região us-central1, mas estas imagens estão disponíveis em cada região onde o Cloud Deploy está disponível. A imagem usada está na região onde o pipeline de entrega foi criado.

O Cloud Deploy usa o lançamento de patch mais recente para cada versão do Skaffold suportada. Anunciamos o apoio técnico para novas versões, incluindo patches de versões específicas do Skaffold, nas notas de lançamento.

Versão de pré-visualização

Pode usar a imagem de pré-visualização da implementação na nuvem, que inclui funcionalidades de pré-visualização.

A versão do Skaffold na imagem de pré-visualização pode ser atualizada em qualquer altura e não segue uma programação de lançamento regular. Recomendamos que não use a versão de pré-visualização para cargas de trabalho de produção.

A versão de pré-visualização está no mesmo repositório que as versões suportadas. Procure imagens com uma etiqueta que comece por skaffold_preview.

Algumas funcionalidades de pré-visualização requerem a imagem de pré-visualização do Cloud Deploy. Para estas funcionalidades, o Cloud Deploy usa essa versão de pré-visualização sem que tenha de fazer nada. Se tentar selecionar uma versão diferente do Skaffold quando cria uma versão usando uma funcionalidade de pré-visualização, o comando falha.

Descubra a versão do Skaffold associada a um lançamento

Pode encontrar a versão que o Cloud Deploy está a usar em qualquer altura executando o seguinte comando:

gcloud deploy releases describe RELEASE \
       --delivery-pipeline=DELIVERY_PIPELINE \
       --region=REGION

A versão é apresentada no atributo skaffoldVersion na saída.

Escolha a versão do Skaffold a usar

Pode usar qualquer versão suportada do Skaffold. Para selecionar a versão que quer usar, inclua a flag --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 (suportada) do Skaffold a usar para este lançamento. A versão deve estar no formato n.nn para uma versão numerada ou skaffold_preview para usar a versão de pré-visualização.

Por exemplo, o seguinte comando 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

Este comando seleciona a versão de pré-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

É selecionada uma nova versão do Skaffold a cada 90 dias. No final desse ciclo de 90 dias,o Google Cloud CLI Google Cloud adiciona suporte para uma nova versão do Skaffold. Agora, pode usar essa versão com o Cloud Deploy. Torna-se a versão predefinida usada para criar e gerir todos os lançamentos para o ciclo de 90 dias seguinte.

As notas de lançamento do Cloud Deploy são atualizadas para anunciar cada lançamento suportado recentemente.

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

As versões do Skaffold são suportadas durante 12 meses, com um período de manutenção de 60 dias. Este período de manutenção significa que os lançamentos associados a uma versão continuam a ser suportados durante 60 dias após a expiração do suporte técnico dessa versão. Ainda pode criar implementações a partir desses lançamentos, mas não pode criar lançamentos com 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 deixa de ser suportada. Já não pode criar implementações a partir de um lançamento que use a versão não suportada. No entanto, todos os dados associados ao lançamento permanecem.

Versão do Skaffold Data de referência Início da manutenção Expiração
2.16.x (notas de lançamento) 12 de maio de 2025 14 de maio de 2026 13 de julho de 2026
2.14.x (notas de lançamento) 17 de fevereiro de 2025 25 de fevereiro de 2026 26 de abril de 2026
2.13.x (notas de lançamento) 1 de agosto de 2024 14 de agosto de 2025 13 de outubro de 2025

O que se segue?