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 choisit la version de Skaffold à utiliser. Cette page contient également des informations sur les éléments suivants :

• Fréquence de changement de la version Skaffold
• Comment connaître 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 de Skaffold compatible est listée dans le tableau de ce document, avec un lien vers le 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.

Versions compatibles

Chaque version de ce tableau renvoie à 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 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 est disponible. L'image utilisée se trouve dans la région où le pipeline de déploiement a été créé.

Cloud Deploy utilise la dernière version corrective pour chaque version Skaffold compatible. Nous annonçons la compatibilité avec de nouvelles versions, y compris des correctifs spécifiques pour les versions Skaffold, dans les notes de version.

Version bêta

Vous pouvez utiliser l'image d'aperçu Cloud Deploy, qui inclut des fonctionnalités en version bêta.

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

Certaines fonctionnalités en version Preview nécessitent l'image Preview 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é en avant-première, la commande échoue.

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

Pour connaître la version de Cloud Deploy utilisée à un moment donné, exécutez 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" 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 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 compatibilité avec 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 pour le prochain cycle de 90 jours.

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

Obsolescence de version et règles de maintenance de Skaffold

Les versions de 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 sont toujours prises en charge pendant 60 jours après l'expiration de la compatibilité avec 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 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 restent disponibles.

Étapes suivantes

• En savoir plus sur l'intégration de 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 efficacement

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