Gérer les versions de Skaffold

Cloud Deploy utilise Skaffold, via Cloud Build, pour déployer votre application en affichant 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 répertoriée dans le tableau de ce document, qui est lié 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 publiques les plus récentes.

Versions compatibles

Version de Skaffold Version maximale du schéma À compter du Par défaut ?
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
2.6.x (notes de version) V4beta6 6 juillet 2023
2.3.x (notes de version) V4beta4 24 avril 2023
2.0.x (notes de version) v4beta1 9 janvier 2023

Chaque version de ce tableau est liée à un dépôt dans Artifact Registry. Dans ce dépôt, recherchez la date la plus récente de la dernière version ou celle de votre choix. 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 est disponible. L'image utilisée se trouve dans la région où le pipeline de livraison a été créé.

Cloud Deploy utilise la dernière version de correctif pour chaque version de Skaffold compatible. Nous annonçons la compatibilité de nouvelles versions, y compris des correctifs spécifiques de 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 de Skaffold figurant dans l'image d'aperçu peut être mise à jour à tout moment et ne suit pas un calendrier de publication standard. Nous vous recommandons de ne pas utiliser la version preview pour les charges de travail de production.

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

Certaines fonctionnalités en preview nécessitent l'image d'aperçu Cloud Deploy. Pour ces fonctionnalités, Cloud Deploy utilise cette version preview sans que vous ayez à intervenir. Si vous essayez de sélectionner une autre version de Skaffold lorsque vous créez une version à l'aide d'une fonctionnalité en preview, la commande échoue.

Déterminer la version de Skaffold associée à une version

Vous pouvez identifier à tout moment la version utilisée par Cloud Deploy 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 du résultat.

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, incluez l'option --skaffold-version dans 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" est la version (compatible) de Skaffold à utiliser pour cette version. La version doit se présenter au format 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. À l'issue de ce cycle de 90 jours, Google Cloud prend en charge une nouvelle version de Skaffold. Vous pouvez maintenant utiliser cette version avec Cloud Deploy. Elle devient la version par défaut utilisée pour créer et gérer toutes les versions pendant le cycle de 90 jours suivant.

Les notes de version de Cloud Deploy sont mises à jour pour annoncer chaque nouvelle version compatible.

Stratégie d'abandon et de maintenance des versions Skaffold

Les versions de Skaffold sont disponibles pendant 12 mois, avec une période de maintenance de 60 jours. Cette période de maintenance signifie que les versions liées à une version sont toujours compatibles 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 de Skaffold n'est plus compatible. Vous ne pouvez plus créer de déploiements à partir d'une version qui utilise cette version non compatible. Cependant, toutes les données associées à la version sont conservées.

Version de Skaffold À compter du Début de la maintenance Expiration
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
2.6.x (notes de version) 6 juillet 2023 6 juillet 2024 4 septembre 2024
2.3.x (notes de version) 24 avril 2023 1er mai 2024 1er juillet 2024

Étapes suivantes