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 località 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 l'archiviazione predefiniti per Cloud Deploy, nonché il motivo e la procedura per modificare questi valori predefiniti.

Predefiniti

Di seguito sono riportati i valori predefiniti utilizzati da Cloud Deploy per l'esecuzione, il rendering e il deployment, nonché 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 dei pool privati di Cloud Build .

  • Account di servizio di esecuzione predefinito

    Per impostazione predefinita, Cloud Deploy utilizza il service account predefinito di Compute Engine.

  • Località di archiviazione predefinita di Cloud Deploy

    Questo valore è il bucket Cloud Storage in cui Cloud Deploy archivia 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 eseguite per Cloud Deploy. Puoi modificare questo timeout nella specifica dell'ambiente di esecuzione nella configurazione della destinazione.

  • Livello di dettaglio 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 in debug o l'equivalente.

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

Informazioni sui pool di worker di Cloud Build

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

  • 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 da 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 eseguire lo scale up o fare lo scale down a zero, senza infrastrutture per configurazione, upgrade o scalabilità.

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

Modificare l'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 alla rete internet pubblica.

  • 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 alle autorizzazioni disponibili nel service account predefinito.

  • Vuoi archiviare i manifest sottoposti a rendering in una località 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 ogni destinazione, in ogni configurazione YAML della destinazione.

Passare dal pool predefinito a un pool privato

Configura i pool di worker per destinazione, in modo che il pool venga utilizzato per RENDER, DEPLOY, PREDEPLOY, POSTDEPLOY, o VERIFY (o una combinazione delle cinque) solo per quella destinazione.

Per utilizzare il pool di worker predefinito sia per le operazioni di rendering che di 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.

Passare dal account di servizio di esecuzione predefinito a uno 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. Per farlo, 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 di Cloud Deploy.

Per ulteriori dettagli su questa configurazione, consulta Definizioni delle destinazioni.

Modificare la località di archiviazione

Per modificare il bucket di archiviazione dal valore 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 sottoposti a rendering, 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

Utilizzare Cloud Deploy in un perimetro dei Controlli di servizio VPC

Cloud Deploy supporta i Controlli di servizio VPC.

Puoi seguire la guida rapida dei Controlli di servizio VPC per configurare un perimetro di servizio.

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 il progetto 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