Gérer les versions 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 est la version de Skaffold utilisée par Cloud Deploy ?

Cloud Deploy effectue ses opérations à l'aide d'une image personnalisée, qui inclut une version LTS Skaffold. Chaque version compatible de Skaffold est répertoriée dans le tableau de ce document et 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 Skaffold.

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

Versions compatibles

Version de Skaffold Version maximale du schéma À compter du Par défaut ?
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 associée à un dépôt dans Artifact Registry. Dans ce dépôt, recherchez la date la plus récente pour obtenir la dernière version ou la version souhaitée. Le dépôt associé se trouve dans la région us-central1, mais ces images sont disponibles dans toutes les régions où Cloud Deploy est disponible. L'image utilisée se trouve dans la région dans laquelle 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 prise en charge des nouvelles versions, y compris des correctifs de version Skaffold spécifiques, dans les notes de version.

Version bêta

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

La version Skaffold dans l'image d'aperçu peut être mise à jour à tout moment et ne suit pas un calendrier de publication standard. Nous vous déconseillons d'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 intervention de votre part. Si vous essayez de sélectionner une autre version Skaffold lorsque vous créez une version à l'aide d'une fonctionnalité d'aperçu, la commande échoue.

Identifier la version Skaffold associée à une version

Vous pouvez identifier la version utilisée par Cloud Deploy à tout moment 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, 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 sous la forme 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 de Skaffold 2.8:

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

Et cette commande sélectionne la version preview de Skaffold:

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

Comment Cloud Deploy sélectionne les nouvelles versions

Une nouvelle version de Skaffold est sélectionnée tous les 90 jours. À la fin de ce cycle de 90 jours, Google Cloud est compatible avec une nouvelle version de Skaffold. Vous pouvez maintenant utiliser cette version avec Cloud Deploy. Il devient la version par défaut utilisée pour créer et gérer toutes les versions pour le cycle de 90 jours suivant.

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

Règle d'obsolescence et de maintenance de la version Skaffold

Les versions Skaffold sont compatibles pendant 12 mois, avec une période de maintenance de 60 jours. Cette période de maintenance signifie que les versions associées à une version restent compatibles pendant 60 jours après l'expiration de la compatibilité 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 Skaffold en période de maintenance.

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

Version de Skaffold À compter du Démarrage de la maintenance Expiration
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
2.0.x (notes de version) 9 janvier 2023 9 janvier 2024 10 mars 2024

Étapes suivantes