Gérer les versions Skaffold

Cloud Deploy utilise Skaffold, via Cloud Build, pour déployer votre application en générant et en déployant des fichiers manifestes.

Cette page explique comment Cloud Deploy sélectionne la version de Skaffold à utiliser. Cette page contient également des informations sur les éléments suivants:

Quelle version de Skaffold utilise Cloud Deploy ?

Cloud Deploy exécute ses opérations à l'aide d'une image personnalisée, qui inclut une version LTS de Skaffold. Chaque version compatible de Skaffold est listée dans le tableau de ce document, associé au dépôt de toutes les images Cloud Deploy. Le numéro de version de chaque image Cloud Deploy correspond au numéro de version de Skaffold.

Avant le 30 août 2022, Cloud Deploy utilisait la version LTS des images Skaffold les plus récentes disponibles au public.

Versions compatibles

Version de Skaffold Version maximale du schéma À compter du Par défaut ?
2.13.x (notes de version) V4beta11 1er août 2024 ✓
2.11.x (notes de version) V4beta10 6 mai 2024
2.10.x (notes de version) v4beta9 2 février 2024
2.8.x (notes de version) v4beta7 27 octobre 2023

Chaque version de ce tableau est liée à un dépôt dans Artifact Registry. Dans ce recherchez la date la plus récente pour obtenir la version la plus récente, la version souhaitée. Le dépôt associé se trouve dans la région us-central1, mais ces images sont disponibles dans chaque région où Cloud Deploy disponibles. L'image utilisée se trouve dans la région où la livraison le pipeline a été créé.

Cloud Deploy utilise la dernière version corrective pour chaque version de Skaffold compatible. Nous annonçons la prise en charge de nouvelles versions, y compris des Correctifs de la version Skaffold, dans les notes de version

Version bêta

Vous pouvez utiliser l'image d'aperçu de Cloud Deploy. qui inclut des fonctionnalités en preview.

La version Skaffold de l'image d'aperçu peut être mise à jour à tout moment et ne suit pas de calendrier de publication régulier. Nous vous recommandons de ne pas utiliser l'aperçu pour les charges de travail de production.

La version preview se trouve dans le même dépôt que les versions compatibles. Regarder pour les images dont le tag commence par skaffold_preview.

Certaines fonctionnalités en version Preview nécessitent l'image Preview de Cloud Deploy. Pour ces fonctionnalités, Cloud Deploy utilise cette version preview sans que vous ayez à faire quoi que ce soit. Si vous essayez de sélectionner un autre élément Skaffold lorsque vous créez une version à l'aide d'une fonctionnalité en preview, la commande échoue.

Identifier la version Skaffold associée à une version

Pour connaître la version utilisée par Cloud Deploy, vous pouvez : en exécutant la commande suivante:

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

La version est indiquée dans l'attribut skaffoldVersion de la sortie.

Choisir la version de Skaffold à utiliser

Vous pouvez utiliser n'importe quelle version compatible de Skaffold. Pour sélectionner la version que vous souhaitez utiliser, ajoutez l'option --skaffold-version à la commande gcloud deploy releases create :

gcloud deploy releases create RELEASE_NAME \
       --delivery-pipeline=PIPELINE_NAME \
       --skaffold-version=SKAFFOLD_VERSION \
       --region=REGION

Où "SKAFFOLD_VERSION" correspond à la version (compatible) de Skaffold à utiliser pour cette version. La version doit se présenter sous la forme suivante : n.nn pour une version numérotée ou skaffold_preview pour utiliser la version preview.

Par exemple, la commande suivante sélectionne la version 2.8 de Skaffold:

gcloud deploy releases create release-001 \
                              --delivery-pipeline=my-pipeline \
                              --skaffold-version=2.8 \
                              --region=us-central1

Cette commande sélectionne ensuite la version preview de Skaffold:

gcloud deploy releases create release-001 \
                       --delivery-pipeline=my-pipeline \
                       --skaffold-version=skaffold_preview \
                       --region=us-central1

Sélection des nouvelles versions par Cloud Deploy

Une nouvelle version de Skaffold est sélectionnée tous les 90 jours. Au terme de cette période de 90 jours, Google Cloud prend en charge une nouvelle version de Skaffold. Vous pouvez désormais utiliser cette version avec Cloud Deploy. Il devient la version par défaut utilisée pour créer et gérer toutes les versions au cours du prochain cycle de 90 jours.

Les notes de version de Cloud Deploy sont mises à jour pour annoncer chaque nouvelle version prise en charge.

Règles d'abandon et de maintenance des versions Skaffold

Les versions de Skaffold sont compatibles pendant 12 mois, avec une période de maintenance de 60 jours. Ce délai de maintenance signifie que les versions associées à une version sont toujours prises en charge pendant 60 jours après l'expiration de la prise en charge de cette version. Vous pouvez toujours créer des déploiements à partir de ces versions, mais vous ne pouvez pas créer de versions à l'aide d'une version de Skaffold en période de maintenance.

Après la période de maintenance de 60 jours, la version Skaffold n'est plus prise en charge. Vous ne pouvez plus créer de déploiements à partir d'une version qui utilise le version non compatible. Toutefois, toutes les données associées à la version sont conservées.

Version de Skaffold À compter du Début de la maintenance Expiration
2.13.x (notes de version) 1er août 2024 14 août 2025 13 octobre 2025
2.11.x (notes de version) 6 mai 2024 6 mai 2025 5 juillet 2025
2.10.x (notes de version) 2 février 2024 2 février 2025 3 avril 2025
2.8.x (notes de version) 26 octobre 2023 26 octobre 2024 25 décembre 2024

Étape suivante