Crea la pipeline di distribuzione e i target

Questa pagina descrive come creare la pipeline di distribuzione e i target descrivere dove e come Cloud Deploy eseguirà il deployment della tua applicazione. Consulta Schema del file di configurazione per una descrizione della struttura del file YAML per le pipeline di importazione e i target.

Informazioni sulla pipeline di distribuzione e sui target

La pipeline di distribuzione descrive un percorso di target di deployment. Puoi definire questi target nello stesso file della pipeline di distribuzione o in uno o più .

Dopo aver creato la pipeline di distribuzione e il file o i file di definizione della destinazione, esegui gcloud deploy apply su ciascuno di questi file per registrarli come delle risorse Cloud Deploy.

Definisci la pipeline di distribuzione e i target

La struttura della pipeline di distribuzione e dei file di configurazione di destinazione descritti qui.

Puoi chiamare questo file come preferisci. Per convenzione, una pipeline di distribuzione che include definizioni di target è chiamato clouddeploy.yaml e che invece fa riferimento ai target definiti in uno o più file separati sono denominati delivery-pipeline.yaml.

La destinazione può puntare a GKE, GKE Enterprise o Cloud Run. All'interno di un oggetto di distribuzione dei dati, tutte le destinazioni devono fare riferimento allo stesso tipo di runtime (tutte GKE o GKE Enterprise, ad esempio).

Creare una pipeline di distribuzione e i target utilizzando la console Google Cloud

Puoi utilizzare la console Google Cloud per creare una nuova pipeline di importazione e uno o più target. È utile per provare Cloud Deploy, non è adatta ai carichi di lavoro di produzione. Puoi anche utilizzare la console Google Cloud per creare una release.

Per creare la pipeline di distribuzione:

  1. Nella pagina Pipeline di importazione, fai clic su Crea.

  2. Fornisci un nome (o mantieni quello predefinito) e, facoltativamente, una descrizione.

  3. Seleziona la tua area.

  4. Scegli l'ambiente di runtime.

    Per GKE, scegli Google Kubernetes Engine oppure seleziona Cloud Run, se questo è il runtime in cui stai eseguendo il deployment.

  5. In Nuovo target, fornisci un nome (o mantieni quello predefinito).

  6. Se vuoi richiedere approvazione in questo target, seleziona la casella di controllo Richiedi l'approvazione per le implementazioni.

  7. Se intendi utilizzare una strategia di deployment canary su questo target, seleziona la casella di controllo Attiva canary.

  8. Fai clic su Fine.

  9. Fai clic su Aggiungi target e segui questi passaggi per ciascun target aggiuntivo che vuoi creare.

  10. Una volta individuati tutti i target, fai clic su Crea per creare la pipeline di distribuzione e le risorse target.

Registra la pipeline di distribuzione e i target

Se hai creato la pipeline e i target utilizzando la console Google Cloud, senza bisogno di farlo.

Per registrare la pipeline di distribuzione con Cloud Deploy, esegui gcloud deploy apply una volta per ogni file di definizione separato. In altre parole, se definisci tre target in tre file, esegui il comando quattro volte: una per la pipeline di distribuzione e una per ogni target.

Il comando seguente registra una pipeline di distribuzione con le sue destinazioni definite in lo stesso file.

gcloud deploy apply --file=PIPELINE_CONFIG \
                    --region=LOCATION \
                    --project=PROJECT

Ora hai una pipeline di distribuzione che può gestire il deployment delle tue release, e le risorse di destinazione che possono essere utilizzate da qualsiasi pipeline di distribuzione progetto e regione.

Esempio di un solo file

Il comando in questo esempio registra una pipeline di distribuzione e le destinazioni tutte definite nello stesso file:

gcloud deploy apply --file=clouddeploy.yaml --region=us-central1

Un esempio che utilizza file separati

Per questo esempio, ci sono tre destinazioni definite in tre file separati, esegui quattro comandi:

gcloud deploy apply --file=delivery-pipeline.yaml --region=us-central1 && \
gcloud deploy apply --file=target_dev.yaml --region=us-central1 && \
gcloud deploy apply --file=target_staging.yaml --region=us-central1 && \
gcloud deploy apply --file=target_prod.yaml --region=us-central1

Il flag --region è obbligatorio, a meno che tu non abbia impostato un valore predefinito (utilizzando gcloud config set deploy/region [REGION]). La regione deve essere la stessa per la consegna pipeline e tutti i target a cui fa riferimento la pipeline.

Crea la pipeline di distribuzione e i target utilizzando Terraform

Puoi utilizzare anche Provider Terraform Google Cloud per creare una pipeline di distribuzione e target Google Cloud.

Il provider Terraform per Google Cloud beta può includere il supporto delle funzionalità di Cloud Deploy Anteprima.

Modificare pipeline e target esistenti

In un secondo momento, puoi modificare qualsiasi pipeline di importazione o configurazione di destinazione ed eseguire gcloud deploy apply per aggiornare la pipeline o la risorsa di destinazione. Tuttavia, queste modifiche non influiscono sulle release esistenti, in quanto sono gestite dalla pipeline di caricamento originale.

Richiedere l'approvazione manuale per un deployment

Per richiedere l'approvazione manuale per un determinato target, includi la seguente proprietà su la definizione del target:

requireApproval: true

Il valore predefinito è false. Se ometti questa proprietà dalla pipeline di distribuzione config o non specificarne alcun valore, il deployment in questa destinazione non richiede approvazione. Tuttavia, l'utente che tenta di eseguire la promozione al target deve disporre dell'autorizzazione IAM clouddeploy.rollouts.create.

Puoi anche richiedere l'approvazione manuale per il primo target. Quando un'uscita viene creato utilizzando l'interfaccia a riga di comando, per il primo target, viene creato rollout automaticamente. Se è necessaria l'approvazione, Cloud Deploy crea rollout, ma in stato di rilascio in attesa fino a quando non viene fornita l'approvazione.

Passaggi successivi