Promuovi la tua release e gestisci le approvazioni

Questa pagina descrive come promuovere una release Cloud Deploy esistente al successivo target in una progressione della pipeline di distribuzione.

Prima di iniziare

Questa pagina presuppone che tu abbia già creato una release.

Promuovi la release

Quando la release viene implementata in un target definito nella pipeline di distribuzione, puoi promuoverla al target successivo:

gcloud deploy releases promote --release=RELEASE_NAME \
                               --delivery-pipeline=PIPELINE_NAME \
                               --region=REGION

Se la pipeline di distribuzione o il target è cambiato dalla creazione della release, Cloud Deploy restituisce un messaggio che indica una possibile mancata corrispondenza e ti chiede di confermare la promozione. Prima di procedere, puoi rispondere n al prompt ed esaminare le differenze tra le versioni della pipeline. Se scegli di eseguire comunque la promozione, la release viene implementata in base alla pipeline di distribuzione come definita al momento della sua creazione. Per ulteriori informazioni sulle mancate corrispondenze della pipeline, consulta Istanze pipeline per release.

Cloud Deploy crea un rollout per la release nel target di destinazione e la release viene messa in coda per il deployment. Una volta eseguito il deployment, la visualizzazione della pipeline di distribuzione mostra quanto segue:

Gestire le approvazioni per una pipeline di distribuzione

Puoi richiedere l'approvazione per qualsiasi target e approvare o rifiutare le release in quel target.

Le approvazioni possono essere gestite in modo programmatico integrando il sistema di gestione dei flussi di lavoro (ad esempio ServiceNow) o un altro sistema con Cloud Deploy utilizzando Pub/Sub e l'API Cloud Deploy.

Richiedere l'approvazione

Per richiedere l'approvazione per qualsiasi target, imposta requireApproval su true nella configurazione del target:

     apiVersion: deploy.cloud.google.com/v1
     kind: Target
     metadata:
      name:
     description:
     requireApproval: true

Per ulteriori dettagli, consulta la sezione Configurazione della pipeline di distribuzione.

Quando l'implementazione è in attesa di approvazione, gli utenti o i sistemi che si iscrivono all'argomento Pub/Sub clouddeploy-approvals ricevono una notifica e possono approvare o rifiutare l'implementazione.

Quando utilizzi il deployment parallelo, puoi configurare il multitarget in modo da richiedere l'approvazione. Se la promozione al target viene rifiutata, l'implementazione del controller non va a buon fine, con stato APPROVAL_REJECTED, e le implementazioni secondarie non vengono create.

Approvare o rifiutare un'implementazione

Ogni target può richiedere l'approvazione prima che venga eseguito il deployment di una release. Quando esegui la promozione a un target che richiede l'approvazione, Cloud Deploy pubblica un messaggio Pub/Sub nell'argomento clouddeploy-approvals.

Qualsiasi utente o account di servizio con il ruolo roles/clouddeploy.approver può approvare l'implementazione di Cloud Deploy in un target che richiede l'approvazione.

Il sistema di gestione dei flussi di lavoro integrato, dopo aver ricevuto una notifica che richiede l'approvazione tramite le notifiche del servizio, può approvare o rifiutare l'implementazione utilizzando l'API Cloud Deploy.

Approvare o rifiutare manualmente

gcloud deploy rollouts approve rollout-name --delivery-pipeline=pipeline-name \
                                                                   --region=region \
                                                                   --release=release-name

gcloud deploy rollouts reject rollout-name --delivery-pipeline=pipeline-name \
                                                                  --region=region \
                                                                  --release=release-name