Definire e utilizzare un tipo di target personalizzato

Definire e utilizzare un tipo di target personalizzato

Questa guida rapida mostra come utilizzare Cloud Deploy per creare un tipo di target personalizzato, quindi eseguire il deployment in un target personalizzato di quel tipo.

In questa guida rapida imparerai a:

1. Definisci un tipo di target personalizzato, in cui configurerai il comportamento del target. Questa configurazione fa riferimento alle immagini container e ai comandi shell da eseguire su queste immagini, che sono le azioni per le operazioni di rendering e deployment.

2. Definisci un target che faccia riferimento al tipo di target personalizzato.

3. Definisci la pipeline di distribuzione di Cloud Deploy.

   Questa pipeline include una sola fase e utilizza un solo target. In questa fase, farai riferimento al target che hai configurato.

4. Crea una configurazione Skaffold, necessaria per la release.

5. Crea una release, che crea automaticamente un'implementazione, con conseguente esecuzione delle operazioni di rendering e deployment personalizzati.

   Nell'ambito di questa release e di questo rollout, vengono eseguite sia le operazioni di rendering che di deployment definite nella configurazione del tipo di target personalizzato.

6. Visualizza i risultati delle operazioni personalizzate. Sono inclusi un file di configurazione sottoposto a rendering caricato in Cloud Storage e una stringa scritta in questo file, nonché un file dei risultati che include lo stato dell'operazione.

Prima di iniziare

Accedi al tuo account Google Cloud . 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.
Abilita le API Cloud Deploy, Cloud Build, GKE, Cloud Run e Cloud Storage.
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.
Abilita le API
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 Google Cloud senza installare Google Cloud CLI. Per eseguire gcloud CLI nella console Google Cloud , 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.

Abilita le API Cloud Deploy, Cloud Build, GKE, Cloud Run e Cloud Storage.

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

Abilita le API

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 Google Cloud senza installare Google Cloud CLI. Per eseguire gcloud CLI nella console Google Cloud , utilizza Cloud Shell.

Se hai già installato Google Cloud CLI, assicurati di utilizzare l'ultima versione:

gcloud components update

1. Assicurati che l'account di servizio Compute Engine predefinito disponga delle autorizzazioni necessarie.

   Il account di servizio potrebbe già disporre delle autorizzazioni necessarie. Questi passaggi sono inclusi per i progetti che disattivano la concessione automatica dei ruoli per i service account predefiniti.

1. Per prima cosa, aggiungi il ruolo clouddeploy.jobRunner:

   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role="roles/clouddeploy.jobRunner"
   

2. Aggiungi il ruolo di sviluppatore per il runtime specifico.
3. Aggiungi il ruolo iam.serviceAccountUser, che include l'autorizzazione actAs per eseguire il deployment nel runtime:

   gcloud iam service-accounts add-iam-policy-binding $(gcloud projects describe PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --member=serviceAccount:$(gcloud projects describe PROJECT_ID \
       --format="value(projectNumber)")[e-mail] \
       --role="roles/iam.serviceAccountUser" \
       --project=PROJECT_ID
   

Crea la pipeline di distribuzione, il tipo di target personalizzato e il target

Puoi definire la pipeline di pubblicazione, il tipo di target personalizzato e il target in un unico file o in file separati. In questa guida rapida, creerai un singolo file con tutti e tre.

1. Apri una finestra del terminale.

2. Crea una nuova directory e accedi.

   mkdir custom-target-quickstart
   cd custom-target-quickstart
   

3. Nella directory custom-target-quickstart, crea un nuovo file, clouddeploy.yaml, con il seguente contenuto:

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: custom-targets-pipeline
   serialPipeline:
     stages:
     - targetId: sample-env
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: sample-env
   customTarget:
     customTargetType: basic-custom-target
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: CustomTargetType
   metadata:
     name: basic-custom-target
   tasks:
     render:
       type: 'container'
       image: gcr.io/google.com/cloudsdktool/google-cloud-cli@sha256:484e8266c1cfc84b283bc6d4eec1f6b61223115178cce76fb59f77b223f26e8e
       command: ['/bin/bash']
       args:
         - '-c'
         - |-
           echo "Sample manifest rendered content" > manifest.txt
           gcloud storage cp manifest.txt $CLOUD_DEPLOY_OUTPUT_GCS_PATH/manifest.txt
           echo {\"resultStatus\": \"SUCCEEDED\", \"manifestFile\": \"$CLOUD_DEPLOY_OUTPUT_GCS_PATH/manifest.txt\"} > results.json
           gcloud storage cp results.json $CLOUD_DEPLOY_OUTPUT_GCS_PATH/results.json
     deploy:
       type: 'container'
       image: gcr.io/google.com/cloudsdktool/google-cloud-cli@sha256:484e8266c1cfc84b283bc6d4eec1f6b61223115178cce76fb59f77b223f26e8e
       command: ['/bin/bash']
       args:
         - '-c'
         - |-
           echo {\"resultStatus\": \"SUCCEEDED\"} > results.json
           gcloud storage cp results.json $CLOUD_DEPLOY_OUTPUT_GCS_PATH/results.json
   

   La definizione del tipo di target personalizzato include la tasks stanza, che definisce un'attività di rendering e un'attività di deployment. Ognuna di queste attività fa riferimento a un'immagine container da eseguire e ai comandi da eseguire sul container.

   Nota :il tipo di target personalizzato e il target sono inclusi nella pipeline di pubblicazione in questo file, ma puoi definirli in un file separato o in più file separati.

4. Registra la pipeline e i target con il servizio Cloud Deploy:

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

   Ora hai una pipeline di distribuzione con una destinazione. Questo è il tuo target che utilizza il tipo di target personalizzato e questa pipeline non esegue il deployment di un'applicazione in un runtime.

5. Conferma la pipeline e i target:

   Nella console Google Cloud , vai alla pagina Pipeline di distribuzione di Cloud Deploy per visualizzare un elenco delle pipeline di distribuzione disponibili.

   Apri la pagina Pipeline di distribuzione

   Viene visualizzata la pipeline di distribuzione appena creata, con un target elencato nella colonna Target.

   

Crea il file di configurazione Skaffold

La release in questa guida rapida richiede un file di configurazione Skaffold, ma questo file non richiede una configurazione significativa.

1. Crea un file denominato skaffold.yaml con il seguente contenuto:

   apiVersion: skaffold/v4beta7
   kind: Config
   

Crea una release

Una release è la risorsa Cloud Deploy centrale che rappresenta le modifiche di cui viene eseguito il deployment. La pipeline di distribuzione definisce il ciclo di vita di questa release. Per informazioni dettagliate su questo ciclo di vita, consulta Architettura del servizio Cloud Deploy.

Esegui questo comando dalla directory custom-target-quickstart per creare una risorsa release che rappresenta l'azione personalizzata da eseguire il deployment:

gcloud deploy releases create test-release-001 \
  --project=PROJECT_ID \
  --region=us-central1 \
  --delivery-pipeline=custom-targets-pipeline

Come per tutte le release (a meno che non includano --disable-initial-rollout), Cloud Deploy crea automaticamente anche una risorsa rollout. e tutte le fasi di questo rollout vengono eseguite, inclusi il rendering e il deployment.

Visualizza i risultati nella console Google Cloud

Dopo alcuni minuti, il deployment è completato. In questo caso, poiché le due azioni personalizzate sono comandi per inserire stringhe in un file e caricare il file su Cloud Storage, non viene eseguito il deployment in alcun runtime di destinazione.

Tuttavia, puoi visualizzare il file e le stringhe al suo interno:

1. Nella console Google Cloud , vai alla pagina Pipeline di distribuzione di Cloud Deploy per visualizzare la pipeline di distribuzione (custom-targets-pipeline).

   Apri la pagina Pipeline di distribuzione

2. Fai clic sul nome della pipeline di distribuzione (custom-targets-pipeline).

   La visualizzazione della pipeline mostra lo stato del deployment dell'app. Poiché la pipeline contiene una sola fase, la visualizzazione mostra un solo nodo.

   

   La tua uscita è elencata nella scheda Uscite in Dettagli della pipeline di distribuzione.

3. Fai clic sul nome della release.

   Viene visualizzata la pagina Dettagli uscita.

4. Fai clic sulla scheda Artefatti.

5. In Artefatti di destinazione, fai clic sul link VISUALIZZA ARTEFATTI.

   Viene visualizzato il file manifest sottoposto a rendering. In questo caso, il file è l'output dell'azione di rendering personalizzata definita nella configurazione del tipo di destinazione personalizzata e contiene la stringa "Sample manifest rendered content".

   

6. Trova i bucket Cloud Storage creati da questa release.

   Apri la pagina del browser Cloud Storage

   Viene visualizzata la pagina Bucket, che mostra due bucket creati per questa release. Un bucket contiene il file di configurazione della pipeline di distribuzione e il skaffold.yaml sottoposto a rendering. L'altro include il file di output che la nostra azione personalizzata è configurata per creare.

7. Fai clic sul bucket il cui nome inizia con us-central1.deploy-artifacts…

   

8. Fai clic sulla cartella il cui nome inizia con custom-targets-pipeline-, poi fai clic sulla cartella test-release-001.

9. Fai clic sulla cartella il cui nome è il nome del lancio, che dovrebbe essere test-release-001-to-sample-env-0001.

10. Fai clic sulla cartella visualizzata, che è un UUID, quindi fai clic sulla cartella custom-output.

11. Fai clic su results.json, poi sull'URL con link ipertestuale nel campo URL di autenticazione.

    Questo file contiene la stringa che hai configurato come output dell'azione custom-deploy nella definizione del tipo di target personalizzato:

    

Nota: puoi anche visualizzare i risultati del rendering nel bucket Cloud Storage, ma è più rapido utilizzare lo strumento di analisi delle release, come mostrato nei primi passaggi di questa procedura.

Esegui la pulizia

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

1. Elimina la pipeline di distribuzione, la destinazione, la release e l'implementazione:

   gcloud deploy delete --file=clouddeploy.yaml --force --region=us-central1 --project=PROJECT_ID
   

2. Elimina entrambi i bucket Cloud Storage creati da Cloud Deploy.

   Apri la pagina del browser Cloud Storage

Ecco fatto, hai completato questa guida rapida.

Passaggi successivi

• Scopri di più sui target personalizzati.

• Consulta gli esempi di tipi di target personalizzati disponibili.

• Scopri di più su Cloud Deploy.

• Scopri le nozioni di base sul deployment delle applicazioni.

• Prova la procedura dettagliata per Cloud Deploy.