Impostare le variabili di ambiente di compilazione (deployment dell'origine)

Le variabili di ambiente di build sono coppie chiave-valore che consentono di passare le informazioni di configurazione ai buildpack durante il deployment dal codice sorgente. Ad esempio, in fase di build, potresti voler personalizzare le opzioni del compilatore, specificare i certificati di build, configurare i parametri e così via.

Questa pagina mostra come impostare le variabili di ambiente di build disponibili al momento della build ed è pertinente per gli sviluppatori di piattaforme che eseguono il deployment di servizi o funzioni Cloud Run dall'origine. I flag dell'interfaccia a riga della gcloud CLI della variabile dell'ambiente di build sono supportati per i deployment delle origini (--source) e non per i deployment delle immagini container (--image).

Puoi utilizzare le variabili di ambiente per la configurazione di servizi o funzioni, ma non le consigliamo come metodo per archiviare secret come le credenziali del database o le chiavi API. Memorizza i valori sensibili al di fuori del codice sorgente e delle variabili di ambiente. Per archiviare i secret, ti consigliamo di utilizzare Secret Manager. Per configurare i servizi che accedono ai secret archiviati in Secret Manager, vedi Configurare i secret.

Prima di iniziare

• Enable the Cloud Run Admin API and Cloud Build 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

  Dopo aver abilitato l'API Cloud Run Admin, viene creato automaticamente l'account di servizio predefinito di Compute Engine.

Ruoli obbligatori

Tu o il tuo amministratore dovete concedere all'account di deployment e al account di servizio Cloud Build i seguenti ruoli IAM.

  gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \
      --role=roles/run.builder
  

Per un elenco di ruoli e autorizzazioni IAM associati a Cloud Run, consulta Ruoli IAM di Cloud Run e Autorizzazioni IAM di Cloud Run. Se il tuo servizio Cloud Run interagisce con le APIGoogle Cloud , come le librerie client Cloud, consulta la guida alla configurazione dell'identità del servizio. Per ulteriori informazioni sulla concessione dei ruoli, consulta Autorizzazioni di deployment e Gestire l'accesso.

Numero massimo di variabili di ambiente di build e limiti

Puoi definire fino a 100 variabili dell'ambiente di build, con un limite totale di 64 KiB per chiave e valore.

Imposta le variabili di ambiente di build

Puoi impostare le variabili di ambiente di build per stabilire nuove variabili o sostituire completamente le variabili di build esistenti.

gcloud run deploy SERVICE \
    --source . \
    --set-build-env-vars KEY1=VALUE1,KEY2=VALUE2

Aggiorna le variabili di ambiente di build

Puoi aggiornare le variabili di ambiente di build per i servizi esistenti. Si tratta di un approccio non distruttivo che modifica o aggiunge variabili di ambiente di build, ma non le elimina.

gcloud run deploy SERVICE \
    --source . \
    --update-build-env-vars KEY1=VALUE1,KEY2=VALUE2

Elimina le variabili di ambiente di build

Puoi eliminare le variabili di ambiente di build per i servizi esistenti.

gcloud run deploy SERVICE \
    --source . \
    --remove-build-env-vars KEY1=VALUE1,KEY2=VALUE2

gcloud run deploy SERVICE \
    --source . \
    --clear-build-env-vars KEY1=VALUE1,KEY2=VALUE2

Utilizzare un file di variabili di ambiente di build

Puoi utilizzare un file di variabili di ambiente di build per le funzioni esistenti.

gcloud run deploy SERVICE \
    --source . \
    --build-env-vars-file FILE_NAME.yaml

 KEY1: VALUE1
 KEY2: VALUE2