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:

• Fréquence de modification de la version de Skaffold
• Déterminer la version actuelle
• Durée de compatibilité de chaque version

Quelle version de Skaffold Cloud Deploy utilise-t-il ?

Cloud Deploy effectue 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

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 la dernière version ou pour la version 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 diffusion a été créé.

Cloud Deploy utilise la dernière version corrective 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 Preview de Cloud Deploy, qui inclut des fonctionnalités d'aperçu.

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 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 des images dont le tag commence par skaffold_preview.

Certaines fonctionnalités 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 une autre version de Skaffold lorsque vous créez une version à l'aide d'une fonctionnalité Preview, la commande échoue.

Identifier la version Skaffold associée à une version

Vous pouvez trouver 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 affichée dans l'attribut skaffoldVersion dans 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 être 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 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-t-il 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 ajoute la prise en charge d'une nouvelle version de Skaffold. Vous pouvez désormais utiliser cette version avec Cloud Deploy. Elle devient la version par défaut utilisée pour créer et gérer toutes les versions du cycle de 90 jours suivant.

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

Règle relative à l'abandon et à la 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 la version non prise en charge. Toutefois, toutes les données associées à la version sont conservées.

Étape suivante

• Découvrez comment intégrer Cloud Deploy à d'autres systèmes.

• En savoir plus sur le fonctionnement de Skaffold avec Cloud Deploy et sur la façon de l'utiliser

• Le document Gérer les fichiers manifestes dans Cloud Deploy explique plus en détail comment utiliser Skaffold, y compris avec d'autres outils de gestion de fichiers manifestes tiers.