Gerenciar versões do Skaffold

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

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

• 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 o Cloud Deploy usa?

O Cloud Deploy realiza 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.

Versões compatíveis

Cada versão nesta tabela é 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 todas as regiões 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 compatível. 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 prévia do Cloud Deploy, que inclui recursos de prévia.

A versão do Skaffold na imagem de pré-lançamento pode ser atualizada a qualquer momento e não segue uma programação de lançamento regular. Não recomendamos o uso da versão de prévia para cargas de trabalho de produção.

A versão de prévia está no mesmo repositório das versões compatíveis. Procure imagens com uma tag que comece com skaffold_preview.

Alguns recursos de prévia exigem a imagem de prévia do Cloud Deploy. Para esses recursos, o Cloud Deploy usa essa versão de prévia sem que você precise fazer nada. Se você tentar selecionar uma versão diferente do Skaffold ao criar um lançamento usando um recurso de prévia, o comando vai 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

É possível usar qualquer versão compatível do Skaffold. Para selecionar a versão que você 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 (compatível) do Skaffold a ser usada para esta versão. A versão precisa estar no formato n.nn para uma versão numerada ou skaffold_preview para usar a versão de prévia.

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

Este comando seleciona a versão de pré-lançamento 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 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 são compatíveis com 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 progressivos com essas versões, mas não é possível criar versões usando uma versão do Skaffold que está 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 incompatível. No entanto, todos os dados associados à versão permanecem.

A seguir

• Leia mais sobre como integrar o Cloud Deploy com 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ê verá mais informações sobre como usar o Skaffold, inclusive com outras ferramentas de gerenciamento de manifestos de terceiros.