Cette page explique comment promouvoir une version Cloud Deploy existante vers la cible suivante dans une progression de pipeline de diffusion .
Avant de commencer
Cette page suppose 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 correspond au nom de la version que vous promouvez.
PIPELINE_NAME correspond au nom du pipeline de diffusion que vous utilisez pour gérer le déploiement de cette version.
REGION correspond au 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 le pipeline affiché 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. Elle affiche les détails de la cible vers laquelle vous effectuez la promotion.
Cliquez sur Promouvoir.
Si le pipeline de diffusion ou la cible a été modifié depuis la création de la version,
Cloud Deploy renvoie un message indiquant une éventuelle
incompatibilité 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 de promouvoir quand même, la version est déployée conformément au pipeline de diffusion tel qu'il était défini lors de la création de la version. Pour en savoir plus sur les incompatibilités de pipeline, consultez la section
Instances de pipeline par version.
Cloud Deploy crée un rollout pour la version dans la cible de destination, 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 pour un pipeline de diffusion
Vous pouvez exiger une approbation pour n'importe quelle cible, et vous pouvez approuver ou refuser des versions dans cette cible.
Les approbations peuvent être gérées par programmation en intégrant votre système de gestion des workflows (tel que ServiceNow) ou un autre système à Cloud Deploy à l'aide de Pub/Sub et de l'API Cloud Deploy.
Exiger une approbation
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 la section Configuration du pipeline de diffusion.
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 de ce sujet, puis peuvent approuver ou refuser le déploiement.clouddeploy-approvals
Lorsque vous utilisez un déploiement parallèle, vous pouvez configurer la
cible multiple pour exiger une approbation.
Si la promotion vers 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
Tout utilisateur ou compte de service disposant du rôle roles/clouddeploy.approver peut approuver un déploiement Cloud Deploy vers une cible nécessitant une approbation.
Votre système de gestion des workflows intégré, après avoir reçu une notification d'approbation requise à l'aide des notifications de service, peut approuver ou refuser le déploiement à l'aide de l'API Cloud Deploy.
Approuver ou refuser manuellement
Console
Dans la Google Cloud console, 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 diffusion s'affiche dans Google Cloud la console. Les pipelines de diffusion qui ont été configurés, mais qui ne sont pas 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 s'affiche. Si l'approbation est en attente et que vous disposez du rôle
roles/clouddeploy.approverou d'autorisations équivalentes, la visualisation inclut un lien Vérifier.
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 Refuser.
Si vous approuvez, votre application est déployée dans la cible. Si vous refusez, l'application n'est pas déployée et ne peut pas être approuvée ultérieurement, sauf si elle est promue à nouveau.
gcloud
Un utilisateur disposant du rôle roles/clouddeploy.approver peut approuver ou refuser manuellement un déploiement. Pour ce faire, procédez comme suit :
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