Utilizzo degli ambienti di esecuzione di Cloud Deploy

Un ambiente di esecuzione di Cloud Deploy è l'ambiente in cui Cloud Deploy esegue le operazioni di rendering, pre-deployment, deployment, verifica e post-deployment. L'ambiente di esecuzione è costituito dai seguenti componenti:

  • Il pool di worker di Cloud Build (predefinito o privato) in cui Cloud Deploy esegue le operazioni di rendering, pre-deployment, deployment, verifica e post-deployment

  • Il account di servizio (predefinito o alternativo) che chiama Cloud Deploy per eseguire queste azioni

  • La posizione di archiviazione (predefinita o alternativa) per i manifest sottoposti a rendering in Cloud Storage

  • Il timeout di Cloud Build per le operazioni (predefinito o personalizzato)

Questo documento descrive l'ambiente di esecuzione, i service account e lo spazio di archiviazione predefiniti per Cloud Deploy, nonché il motivo e la procedura per modificare questi valori predefiniti.

Predefiniti

Di seguito sono riportate le impostazioni predefinite utilizzate da Cloud Deploy per l'esecuzione, per l'esecuzione del rendering e del deployment e per l'archiviazione di asset come i manifest sottoposti a rendering:

  • Pool di worker predefinito

    Per impostazione predefinita, Cloud Deploy viene eseguito nel pool di worker di Cloud Build predefinito. Tuttavia, puoi configurare Cloud Deploy in modo che utilizzi un pool di worker privato di Cloud Build.

    Per ulteriori dettagli sui pool di worker, consulta la panoramica dei pool predefiniti e privati di Cloud Build.

  • Account di servizio di esecuzione predefinito

    Per impostazione predefinita, Cloud Deploy utilizza l'account di servizio predefinito di Compute Engine.

  • Percorso di archiviazione predefinito di Cloud Deploy

    Questo valore è il bucket Cloud Storage in cui Cloud Deploy memorizza i manifest sottoposti a rendering. Per impostazione predefinita, Cloud Deploy crea un bucket Cloud Storage nella stessa regione delle risorse Cloud Deploy, con il seguente formato:

    <location>.deploy-artifacts.<project ID>.appspot.com

  • Timeout predefinito di Cloud Build

    Per impostazione predefinita, Cloud Build ha un timeout di 1 ora per le operazioni che esegue per Cloud Deploy. Puoi modificare questo timeout nella specifica dell'ambiente di esecuzione nella configurazione di destinazione.

  • Livello di verbosità predefinito per Skaffold, gcloud CLI e kubectl

    Per impostazione predefinita, i livelli di log per questi strumenti sono impostati sui rispettivi valori predefiniti, in genere warn o l'equivalente. Puoi modificare questa impostazione impostandola su debug o un valore equivalente.

Le sezioni seguenti descrivono le circostanze in cui devi modificare uno di questi valori e i link alle istruzioni per farlo.

Informazioni sui pool di worker Cloud Build

L'ambiente di esecuzione di Cloud Deploy può utilizzare uno dei seguenti elementi:

  • Il pool predefinito di Cloud Build

    Il pool di worker predefinito è un ambiente ospitato sicuro con accesso alla rete internet pubblica. Le operazioni di rendering, deployment, pre-deployment, post-deployment e verifica vengono eseguite in questo pool, isolato dagli altri workload.

  • Un pool privato

    I pool di worker privati sono pool privati e dedicati che possono essere personalizzati più del pool di worker predefinito. Questa personalizzazione può includere la possibilità di accedere alle risorse in una rete privata. Come il pool di worker predefinito, i pool di worker privati sono ospitati e completamente gestiti da Cloud Build. Questi pool possono essere scalati verso l'alto o fare lo scale down fino a zero, senza infrastrutture da configurare, aggiornare o scalare.

    La panoramica dei pool privati di Cloud Build descrive in modo più approfondito i pool di worker predefiniti e privati, inclusa una tabella che confronta le loro funzionalità.

Modifica dell'ambiente di esecuzione di Cloud Deploy

Potresti modificare l'ambiente di esecuzione di Cloud Deploy nelle seguenti circostanze:

  • Vuoi eseguire il deployment in un cluster Google Kubernetes Engine privato

  • Vuoi che le operazioni di rendering, deployment, pre-deployment, post-deployment o verifica, o una combinazione delle cinque, vengano eseguite in un ambiente isolato da altre organizzazioni.

  • Vuoi che queste operazioni vengano eseguite in un ambiente non connesso a internet pubblico.

  • Vuoi ambienti separati per il rendering e il deployment.

  • Vuoi utilizzare un account di servizio dedicato con autorizzazioni più specifiche per il tuo utilizzo rispetto a quelle disponibili nel service account predefinito.

  • Vuoi archiviare i manifest sottoposti a rendering in una posizione diversa dal bucket Cloud Storage predefinito.

La configurazione di tutte e tre le parti dell'ambiente di esecuzione (pool di worker, service account e spazio di archiviazione) viene eseguita per destinazione nella configurazione YAML di ogni destinazione.

Passaggio dal pool predefinito a un pool privato

Configuri i pool di worker per target, in modo che il pool venga utilizzato per RENDER, DEPLOY, PREDEPLOY, POSTDEPLOY o VERIFY (o una combinazione dei cinque) solo per quel target.

Per utilizzare il pool di worker predefinito per le operazioni di rendering e deployment, non devi fare nulla.

Di seguito è riportata una configurazione di destinazione di esempio che specifica un pool di worker privato per DEPLOY e il pool di worker predefinito per RENDER, PREDEPLOY, POSTDEPLOY e VERIFY:

executionConfigs:
- usages:
  - DEPLOY
  privatePool:
    workerPool: "projects/p123/locations/us-central1/workerPools/wp123"
- usages:
  - RENDER
  - PREDEPLOY
  - VERIFY
  - POSTDEPLOY

Per ulteriori informazioni su come configurare i pool privati per le destinazioni, consulta la documentazione sulla configurazione della pipeline di distribuzione.

Passaggio dal account di servizio di esecuzione predefinito a quello personalizzato

Come per il pool di worker, puoi specificare un account di servizio alternativo da utilizzare per il rendering o il deployment (o entrambi) per ogni destinazione. A tal fine, aggiungi la seguente riga alla configurazione della destinazione, dopo l'elemento workerPool:

serviceAccount: "[name]@[project_name].iam.gserviceaccount.com"

Il account di servizio specificato deve includere il ruolo clouddeploy.jobRunner, come descritto nel documento Service account Cloud Deploy.

Per maggiori dettagli su questa configurazione, consulta Definizioni dei target.

Modificare la posizione di archiviazione

Per modificare il bucket di archiviazione rispetto a quello predefinito di Cloud Deploy, aggiungi la seguente riga alla definizione della destinazione nella sezione workerPool:

artifactStorage: "gs://[bucket_name]/[dir]"

Questa configurazione modifica la posizione in cui vengono archiviati i manifest renderizzati, ma non influisce sulla posizione in cui viene archiviata l'origine del rendering.

Modificare il livello di log per Skaffold, gcloud CLI e kubectl

Per modificare il livello di log per Skaffold, gcloud CLI e kubectl, dai rispettivi valori predefiniti a debug (o l'equivalente), imposta verbose su true nelle configurazioni di esecuzione. Ecco un esempio:

executionConfigs:
- usages:
  - [RENDER | PREDEPLOY|  DEPLOY | VERIFY | POSTDEPLOY]
  workerPool:
  serviceAccount:
  artifactStorage:
  executionTimeout:
  verbose: true

Utilizzo di Cloud Deploy in un perimetro dei Controlli di servizio VPC

Cloud Deploy supporta i controlli di servizio VPC.

Per configurare un perimetro di servizio, puoi seguire la guida rapida ai Controlli di servizio VPC.

Limitazioni

  • Devi utilizzare un pool di worker privato di Cloud Build per l'ambiente di esecuzione della destinazione, non il pool di worker predefinito.

  • Il progetto che contiene il pool di worker e quello che contiene le risorse Cloud Deploy devono rimanere nello stesso perimetro di sicurezza dei Controlli di servizio VPC.

  • Qualsiasi cluster GKE di cui esegui il deployment nel perimetro dei Controlli di servizio VPC deve essere un cluster privato.

    Per configurare un pool privato per un cluster privato, consulta questo tutorial.

Passaggi successivi