Cette page explique comment promouvoir une version Cloud Deploy existante sur le cible suivante dans la progression du pipeline de livraison.
Avant de commencer
Sur cette page, nous partons du principe que vous avez déjà créé une version.
Promouvoir la version
Lorsque votre version est déployée dans une cible définie dans votre pipeline de diffusion, vous pouvez la promouvoir dans la cible suivante:
gcloud
gcloud deploy releases promote --release=RELEASE_NAME \
--delivery-pipeline=PIPELINE_NAME \
--region=REGION
Où :
RELEASE_NAME est le nom de la version que vous promouvez.
PIPELINE_NAME est le nom du pipeline de livraison.
que vous utilisez pour gérer le déploiement de cette version.
REGION est le nom de la région dans laquelle la version a été créée, par exemple us-central1. Ce champ est obligatoire.
Pour en savoir plus sur la commande gcloud deploy releases promote, consultez la documentation de référence du SDK Google Cloud.
Console
Cliquez sur votre pipeline dans la liste des pipelines de diffusion.
La page "Détails du pipeline de diffusion" affiche une représentation graphique de la progression de votre pipeline de diffusion.
Sur la première cible de la visualisation du pipeline de diffusion, cliquez sur Promouvoir.
La boîte de dialogue Promouvoir la version s'affiche. Il indique les détails cible de la promotion.
Cliquez sur Promouvoir.
Si le pipeline de livraison ou la cible a changé
depuis la création de la version,
Cloud Deploy renvoie un message indiquant
mismatch (correspondance) et les invites
pour confirmer la promotion. Vous pouvez répondre n à l'invite et examiner les différences entre les versions du pipeline avant de continuer. Si vous choisissez
promouvoir quand même, la version est déployée selon le pipeline de livraison,
a été défini lors de la création de la version. Pour en savoir plus sur les différences de pipeline, consultez la section Instances de pipeline par version.
Cloud Deploy crée un rollout pour la version dans le
et la version est mise en file d'attente pour le déploiement. Lors du déploiement, la visualisation du pipeline de livraison le prouve:
Gérer les approbations d'un pipeline de livraison
Vous pouvez exiger une approbation pour n'importe quelle cible, et vous pouvez approuver ou refuser les versions dans cette cible.
Les approbations peuvent être gérées de manière automatisée en intégrant votre workflow Google Cloud (tel que ServiceNow) ou un autre système, avec Cloud Deploy avec Pub/Sub et Cloud Deploy API.
Approbation requise
Pour exiger une approbation pour n'importe quelle cible, définissez requireApproval sur true dans la cible
configuration:
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
name:
description:
requireApproval: true
Pour en savoir plus, consultez la section Configuration du pipeline de diffusion.
Lorsqu'un déploiement est en attente d'approbation, les utilisateurs ou les systèmes qui s'abonnent au sujet Pub/Sub clouddeploy-approvals reçoivent une notification et peuvent ensuite approuver ou refuser le déploiement.
Lorsque vous utilisez le déploiement en parallèle, vous pouvez configurer le
un ciblage multiple pour nécessiter une approbation.
Si la promotion vers la cible est refusée, le déploiement du contrôleur échoue, avec un état APPROVAL_REJECTED, et les déploiements enfants ne sont pas créés.
Approuver ou refuser un déploiement
Chaque cible peut exiger une approbation avant le déploiement d'une version vers elle. Lorsque vous effectuez une promotion vers une cible nécessitant une approbation, Cloud Deploy publie un message Pub/Sub dans le sujet clouddeploy-approvals.
Tout utilisateur ou compte de service disposant du rôle roles/clouddeploy.approver peut
approuver un déploiement Cloud Deploy sur une cible qui nécessite une approbation.
Votre système intégré de gestion des flux de travail, ayant reçu une approbation requise via les notifications de service, peut approuver ou refuser le déploiement à l'aide de l'API Cloud Deploy.
Approuver ou refuser manuellement
Console
Dans la console Google Cloud, accédez à la page Pipelines de diffusion de Cloud Deploy pour afficher la liste de vos pipelines de diffusion disponibles.
Ouvrir la page Pipelines de diffusion
La liste des pipelines de livraison s'affiche dans la console Google Cloud. Les pipelines de diffusion configurés, mais non enregistrés auprès du service Cloud Deploy ne sont pas affichés.
Cliquez sur le nom du pipeline de diffusion.
La visualisation du pipeline est affichée. Si l'approbation est en attente et si vous disposer du rôle
roles/clouddeploy.approverou d'autorisations équivalentes ; la visualisation comprend un lien Examen.
Cliquez sur Vérifier.
Une liste des déploiements en attente d'approbation s'affiche.
Cliquez sur Vérifier.
L'écran "Approuver le déploiement" s'affiche.
L'onglet Manifest diff (Diff fichier manifeste) affiche les modifications apportées au fichier manifeste affiché depuis la version actuellement déployée (le cas échéant) vers celle que vous approuvez (ou refusez).
Cliquez sur Approuver ou sur Refuser.
Si vous acceptez, votre application est déployée dans la cible. Si vous refuser, l'application n'est pas déployée et ne peut pas être approuvée ultérieurement à moins qu'il ne soit promu à nouveau.
gcloud
Un utilisateur doté du rôle roles/clouddeploy.approver peut approuver ou
refuser un déploiement. Pour approuver :
gcloud deploy rollouts approve rollout-name --delivery-pipeline=pipeline-name \
--region=region \
--release=release-name
Pour refuser :
gcloud deploy rollouts reject rollout-name --delivery-pipeline=pipeline-name \
--region=region \
--release=release-name