Crea pipeline di distribuzione e target

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa pagina descrive come creare la pipeline di distribuzione e i target che descrivono dove e come Google Cloud Deploy eseguirà il deployment della tua applicazione. Consulta lo schema dei file di configurazione per una descrizione della struttura di file YAML per le pipeline di distribuzione e le destinazioni.

Informazioni sulla pipeline di distribuzione e sui target

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

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

Definisci la pipeline di distribuzione e i target

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

Puoi chiamare questo file come preferisci. Per convenzione, una configurazione della pipeline di distribuzione che include le definizioni di target è denominata clouddeploy.yaml, mentre una che fa riferimento ai target definiti in uno o più file distinti è denominata delivery-pipeline.yaml.

La destinazione può indirizzare a un cluster GKE o a un cluster Anthos.

Registrare la pipeline di distribuzione e i target

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

Il comando seguente registra una pipeline di distribuzione con le destinazioni definite nello stesso file.

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

Ora hai una pipeline di distribuzione in grado di gestire il deployment delle release e di scegliere come target le risorse che possono essere utilizzate da qualsiasi pipeline di distribuzione nello stesso progetto e nella stessa area geografica.

Esempio di un file singolo

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

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

Un esempio nell'utilizzo di file separati

Per questo esempio, sono presenti tre destinazioni definite in tre file separati, quindi 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 pipeline di distribuzione e per tutti i target a cui fa riferimento la pipeline.

Crea la pipeline di distribuzione e i target utilizzando Terraform

Puoi anche utilizzare il provider Terraform di Google Cloud per creare risorse di pipeline di distribuzione e target.

Modifica pipeline e target esistenti

Puoi modificare qualsiasi configurazione di destinazione o pipeline di distribuzione ed eseguire gcloud deploy apply per aggiornare la risorsa di destinazione o della pipeline. Tuttavia, tali modifiche non influiscono sulle release esistenti, poiché sono gestite dalla pipeline di distribuzione originale.

Richiedi l'approvazione manuale per un deployment

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

requireApproval: true

Il valore predefinito è false. Se ometti questa proprietà dalla configurazione delivery-pipeline o non fornisci alcun valore per questa, il deployment in questa destinazione non richiede l'approvazione. Il chiamante che tenta di promuovere al target deve comunque disporre dell'autorizzazione IAM clouddeploy.rollouts.create.

Puoi anche richiedere l'approvazione manuale per il primo target. Quando viene creata una release, utilizzando l'interfaccia a riga di comando, per il primo target, viene creato automaticamente il rollout. Se è necessaria l'approvazione, Google Cloud Deploy crea il rollout, ma nello stato di rilascio in attesa fino all'approvazione.

Passaggi successivi