Creare una pipeline e una release nella Google Cloud console

Creare una pipeline e una release nella Google Cloud console

Questa pagina mostra come utilizzare la Google Cloud console per creare una pipeline di distribuzione di Cloud Deploy e poi creare una release per quella pipeline.

In questa guida rapida imparerai a:

1. Creare due cluster GKE o configurare due servizi Cloud Run.

2. Creare una pipeline di distribuzione e due target utilizzando la Google Cloud console.

3. Creare un'istanza della pipeline di distribuzione creando una release utilizzando la Google Cloud console.

   Dopo aver creato questa release, l'applicazione viene sottoposta automaticamente a deployment nel target.

4. Visualizzare i risultati nella Google Cloud console.

Prima di iniziare

Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the APIs
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
Per inizializzare gcloud CLI, esegui questo comando:
gcloud init
Nota: puoi eseguire gcloud CLI nella console senza installare Google Cloud CLI. Google Cloud Per eseguire la gcloud CLI nella Google Cloud console, utilizza Cloud Shell.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Deploy, Cloud Build, GKE, Artifact Registry, Cloud Run, and Cloud Storage APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Nota: puoi eseguire gcloud CLI nella console senza installare Google Cloud CLI. Google Cloud Per eseguire la gcloud CLI nella Google Cloud console, utilizza Cloud Shell.

Se hai già installato l'interfaccia a riga di comando, assicurati di eseguire l'ultima versione:

gcloud components update

Crea l'ambiente di runtime

Se esegui il deployment in Cloud Run, puoi saltare questo comando.

Per GKE, crea due cluster: quickstart-cluster-for-console-staging e quickstart-cluster-for-console-prod, con le impostazioni predefinite. Gli endpoint API Kubernetes dei cluster devono essere raggiungibili dalla rete internet pubblica. Per impostazione predefinita, i cluster GKE sono accessibili esternamente.

gcloud container clusters create-auto quickstart-cluster-for-console-staging \
                 --project=PROJECT_ID \
                 --region=us-central1 && \
gcloud container clusters create-auto quickstart-cluster-for-console-prod \
                 --project=PROJECT_ID \
                 --region=us-central1

Crea una pipeline di distribuzione e due target

Puoi utilizzare Cloud Deploy per creare una pipeline di distribuzione e i target in base alla configurazione specificata in uno o più file YAML. Tuttavia, puoi anche creare una pipeline di distribuzione utilizzando la Google Cloud console.

In questa sezione utilizzerai la Google Cloud console per creare una pipeline di distribuzione e due target. Quando utilizzi la Google Cloud console, non devi creare file YAML; Cloud Deploy crea automaticamente skaffold.yaml e il manifest.

1. Nella Google Cloud console, vai alla pagina principale di Cloud Deploy.

   Apri la pagina Pipeline di distribuzione

2. Fai clic su Crea.

   

   Viene visualizzato il modulo Crea una pipeline di distribuzione.

3. Nel campo Nome pipeline, sostituisci il testo predefinito con in-console-quickstart-pipeline.

4. (Facoltativo) Inserisci una descrizione per questa pipeline di distribuzione.

5. Nel menu a discesa Regione, seleziona us-central1.

6. Seleziona il runtime.

   Se esegui il deployment in GKE, seleziona Google Kubernetes Engine. In caso contrario, seleziona Cloud Run.

7. Crea i target:

   GKE

   1. In Nuovo target, nel campo Nome target, sostituisci il testo predefinito con console-staging.

   2. Nel menu a discesa Cluster Kubernetes Engine, seleziona quickstart-cluster-for-console-staging.

   3. Fai clic su Fine.

   4. Fai clic su Aggiungi target.

      Sostituisci il testo predefinito per Nome target con console-prod.

   5. Seleziona quickstart-cluster-for-console-prod dal menu a discesa Cluster Kubernetes Engine.

   6. Seleziona Richiedi l'approvazione per le implementazioni.

      Per questa guida rapida, richiediamo l'approvazione per il secondo target , ma non per il primo.

   7. Fai clic su Crea per creare questa pipeline di distribuzione.

      

   Cloud Run

   1. In Nuovo target, nel campo Nome target, sostituisci il testo predefinito con console-staging.

   2. Nel menu a discesa Regione, seleziona us-central1.

   3. Fai clic su Fine.

   4. Fai clic su Aggiungi target.

   5. Sostituisci il testo predefinito per Nome target con console-prod.

   6. Attiva la casella di controllo Richiedi l'approvazione per le implementazioni per questo target.

      Per questa guida rapida, richiediamo l'approvazione per il secondo target , ma non per il primo.

   7. Fai clic su Crea per creare questa pipeline di distribuzione.

      

   Nota: se il account di servizio Compute Engine predefinito non dispone delle autorizzazioni necessarie, puoi fare clic sul pulsante Concedi per aggiungerle, quando richiesto.

   Ora hai una pipeline di distribuzione con due target, pronta per creare una release.
   Viene visualizzata la pagina della pipeline, che mostra entrambi i target, senza implementazioni.

   

Crea una release

Ora che hai una pipeline di distribuzione, con due target, che puntano a due cluster GKE o due servizi Cloud Run, puoi creare una release per eseguire il deployment dell'applicazione nel primo target.

1. Se non hai ancora aperto la pagina della pipeline di distribuzione, che mostra la nuova pipeline di distribuzione in-console-quickstart-pipeline, aprila ora.

   Viene visualizzata la visualizzazione della pipeline, senza implementazioni.

2. Fai clic sul pulsante Crea release.

   Viene visualizzata la finestra di dialogo Crea una release. La maggior parte dei campi è precompilata. Mantieni questi valori predefiniti.

   

   Puoi fare clic sul pulsante Visualizza manifest per visualizzare il manifest generato automaticamente per uno dei due target e puoi fare clic su Visualizza file Skaffold per visualizzare il file skaffold.yaml generato. Puoi anche modificarli, ma per questa guida rapida lasciali così come sono.

3. (Facoltativo) Aggiungi una descrizione per questa release nel campo Descrizione.

4. Fai clic su Crea per avviare la release.

   Viene visualizzata la pagina dei dettagli dell'implementazione per l'implementazione nel primo target e puoi monitorare l'avanzamento di questa implementazione. Il completamento richiede alcuni minuti. L'avvio dell'implementazione potrebbe richiedere alcuni secondi.

5. Al termine della prima implementazione, fai clic sul nome della pipeline di distribuzione per accedere alla pagina della pipeline di distribuzione.

   

   Viene visualizzata la visualizzazione della pipeline, con l'implementazione completata nel primo target.

   

6. Fai clic su Promuovi per avviare l'implementazione nel target successivo.

   Viene visualizzata la finestra di dialogo Promuovi.

7. Mantieni i valori predefiniti, aggiungi una Descrizione dell'implementazione se vuoi, quindi fai clic su Promuovi.

   Poiché abbiamo selezionato Richiedi l'approvazione per le implementazioni quando abbiamo creato il secondo target, questa promozione è in attesa di approvazione.

8. Fai clic su Esamina nella visualizzazione della pipeline di distribuzione.

   Viene visualizzata la pagina di approvazione.

   

9. Fai di nuovo clic su Esamina e, nella finestra di dialogo di approvazione, fai clic su Approva.

   L'implementazione viene avviata per il secondo target. Puoi fare di nuovo clic sul nome della pipeline di distribuzione per monitorare l'avanzamento nella visualizzazione della pipeline.

Al termine della seconda implementazione, l'applicazione viene sottoposta a deployment nel secondo target e la pipeline di distribuzione è stata completata.

Libera spazio

Per evitare che al tuo Google Cloud account vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

1. Elimina i cluster GKE o i servizi Cloud Run:

   GKE

   gcloud container clusters delete quickstart-cluster-for-console-staging --region=us-central1 --project=PROJECT_ID \
   && gcloud container clusters delete quickstart-cluster-for-console-prod --region=us-central1 --project=PROJECT_ID
   

   Cloud Run

   gcloud run services delete in-console-quickstart-pipeline-target-1 --region=us-central1 --project=PROJECT_ID \
   && gcloud run services delete in-console-quickstart-pipeline-target-2 --region=us-central1 --project=PROJECT_ID
   

2. Nella pagina della pipeline di distribuzione, fai clic su Elimina per eliminare la pipeline di distribuzione, la release e le implementazioni.

   Digita il nome della pipeline nel campo fornito e fai clic su Conferma per completare l'eliminazione delle risorse.

   

3. Elimina entrambi i target:

   gcloud deploy targets delete console-staging --region=us-central1  && \
   gcloud deploy targets delete console-prod --region=us-central1
   

4. Elimina i bucket Cloud Storage creati da Cloud Deploy.

   Uno termina con _clouddeploy e l'altro è [region].deploy-artifacts.[project].appspot.com.

   Apri la pagina del browser Cloud Storage

Ecco fatto, hai completato questa guida rapida.

Passaggi successivi

• Scopri di più su Cloud Deploy.

• Scopri le nozioni di base sul deployment delle applicazioni.

• Prova la procedura dettagliata di Cloud Deploy.

• Scopri come gestire i manifest.

• Scopri come combinare Google Cloud gli strumenti CI/CD per sviluppare e distribuire software in modo efficace in GKE.