Imposta le variabili di ambiente di build (deployment origine)

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

Questa pagina mostra come impostare le variabili di ambiente di compilazione disponibili al momento della compilazione ed è pertinente per gli sviluppatori di piattaforme che eseguono il deployment di funzioni in Cloud Run.

Prima di iniziare

Abilita l'API Cloud Build:

gcloud services enable cloudbuild.googleapis.com

Ruoli obbligatori

Per ottenere le autorizzazioni di cui hai bisogno di eseguire il deployment dall'origine, chiedi all'amministratore di concederti i seguenti ruoli IAM sul tuo progetto:

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

Imposta le variabili di ambiente di compilazione

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

gcloud

Puoi impostare una variabile di ambiente di build quando esegui il deployment di una funzione dal codice sorgente:

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

Sostituisci:

  • SERVICE con il nome del tuo Cloud Run personalizzata.
  • FUNCTION_ENTRY_POINT con il punto di ingresso della funzione nel codice sorgente.
  • KEY1=VALUE1,KEY2=VALUE2 con l'elenco separato da virgole di i nomi delle variabili e i relativi valori distribuiti insieme a una funzione che ti consentono di passare le informazioni di configurazione ai buildpack.

Aggiorna le variabili di ambiente di build

Puoi aggiornare le variabili di ambiente di compilazione per le funzioni esistenti. Si tratta di un approccio non distruttivo che modifica o aggiunge l'ambiente di build ma non elimina le variabili di ambiente di build.

gcloud

Per aggiornare una variabile di ambiente di build per le funzioni esistenti:

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

Eliminare le variabili di ambiente di build

Puoi eliminare le variabili di ambiente di compilazione per le funzioni esistenti.

gcloud

Per rimuovere le variabili di ambiente di build, utilizza --remove-build-env-vars per le funzioni esistenti:

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

In alternativa, puoi cancellare le variabili di ambiente di build utilizzando il metodo --clear-build-env-vars per le funzioni esistenti:

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

File delle variabili di ambiente di build

Utilizzi un file di variabili di ambiente di compilazione per le funzioni esistenti.

gcloud

Per impostare le variabili di ambiente di compilazione da un file:

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

Sostituisci FILE_NAME.yaml se i contenuti del file sono come segue:

 KEY1: VALUE1
 KEY2: VALUE2