Cette page explique comment promouvoir une version Cloud Deploy existante vers la cible suivante dans un pipeline de livraison.
Avant de commencer
Dans 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 de Google Cloud SDK.
Console
Cliquez sur votre pipeline affiché dans la liste des pipelines de livraison.
La page d'informations du pipeline de livraison contient une représentation graphique de la progression de votre pipeline de livraison.
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 affiche les détails de la cible sur laquelle vous faites la promotion.
Cliquez sur Promouvoir.
Si le pipeline ou la cible de livraison a changé depuis la création de la version, Cloud Deploy renvoie un message indiquant une incohérence possible et vous invite à 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 quand même de promouvoir la version, la version est déployée conformément au pipeline de livraison tel qu'il a été défini lors de la création de la version. Consultez la section Instances de pipeline par version pour en savoir plus sur les incohérences au niveau des pipelines.
Cloud Deploy crée un rollout
pour la version dans la cible de destination, et celle-ci 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 pour un pipeline de livraison
Vous pouvez exiger une approbation pour n'importe quelle cible, et vous pouvez approuver ou refuser des versions pour cette cible.
Les approbations peuvent être gérées de manière automatisée en intégrant votre système de gestion de workflows (tel que ServiceNow) ou un autre système à Cloud Deploy à l'aide de Pub/Sub et de l'API Cloud Deploy.
Approbation requise
Pour exiger une approbation sur n'importe quelle cible, définissez requireApproval
sur true
dans la configuration de la cible:
apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
name:
description:
requireApproval: true
Pour en savoir plus, consultez Configuration du pipeline de livraison.
Lorsqu'un déploiement est en attente d'approbation, les utilisateurs ou les systèmes abonnés au sujet Pub/Sub clouddeploy-approvals
reçoivent une notification, puis peuvent approuver ou refuser le déploiement.
Lorsque vous utilisez un déploiement parallèle, vous pouvez configurer le groupe multicible pour qu'il exige une approbation.
Si la promotion sur la cible est refusée, le déploiement du contrôleur échoue avec l'é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 la 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 doté du rôle roles/clouddeploy.approver
peut approuver un déploiement Cloud Deploy sur une cible nécessitant une approbation.
Votre système de gestion de workflows intégré, après avoir reçu une notification de demande d'approbation 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 livraison de Cloud Deploy pour afficher la liste de vos pipelines de livraison disponibles.
Ouvrir la page Pipelines de diffusion
La liste des pipelines de livraison est affichée dans la console Google Cloud. Les pipelines de livraison configurés, mais non enregistrés auprès du service Cloud Deploy, ne s'affichent pas.
Cliquez sur le nom du pipeline de livraison.
La visualisation du pipeline s'affiche. Si l'approbation est en attente et que vous disposez du rôle
roles/clouddeploy.approver
ou d'autorisations équivalentes, la visualisation inclut un lien Examiner.Cliquez sur Vérifier.
La 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 Refuser.
Si vous acceptez, votre application sera déployée dans la cible. Si vous la refusez, l'application n'est pas déployée et ne pourra pas être approuvée ultérieurement, à moins qu'elle ne soit de nouveau promue.
gcloud
Un utilisateur doté du rôle roles/clouddeploy.approver
peut approuver ou refuser manuellement un déploiement. Pour l'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