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 table de ce document, qui est associée au dépôt de toutes Images Cloud Deploy Le numéro de version de chaque déploiement Cloud Deploy correspond au numéro de version de Skaffold.

Avant le 30 août 2022, Cloud Deploy utilisait la version LTS du les 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 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 de correctif pour chaque Version de Skaffold. 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. ne respecte pas un calendrier de mise en ligne 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 preview nécessitent l'image d'aperçu 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.

Déterminer la version de 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 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 le paramètre --skaffold-version sur 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 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 à l'aide de 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 remplacées par 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 pris en charge pendant 60 jours après l'expiration de la prise en charge de cette version. Vous pouvez créer des déploiements à partir de ces versions, mais vous ne pouvez pas créer de versions à l'aide de 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 compatibles. Vous ne pouvez plus créer de déploiements à partir d'une version qui utilise le 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

Étape suivante