Questa pagina è stata tradotta dall'API Cloud Translation.

Configura le variabili di ambiente

Questa pagina descrive come configurare le variabili di ambiente per il servizio Cloud Run. Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche le revisioni successive acquisiranno automaticamente questa impostazione di configurazione, a meno che non apporti aggiornamenti espliciti per modificarla.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare ed eseguire il deployment dei servizi Cloud Run, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Cloud Run Developer (roles/run.developer) nel servizio Cloud Run
Utente account di servizio (roles/iam.serviceAccountUser) nell'identità di servizio

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

Puoi impostare le variabili di ambiente utilizzando la console Google Cloud, la gcloud CLI o un file YAML quando crei un nuovo servizio o esegui il deployment di una nuova revisione:

Console

Nella console Google Cloud, vai a Cloud Run:

Vai a Cloud Run
Fai clic su Esegui il deployment del contenitore e seleziona Servizio per configurare un nuovo servizio. Se stai configurando un servizio esistente, fai clic sul servizio, poi su Modifica ed esegui il deployment di una nuova revisione.
Se stai configurando un nuovo servizio, compila la pagina iniziale delle impostazioni del servizio, quindi fai clic su Container, volumi, networking, sicurezza per espandere la pagina di configurazione del servizio.
Fai clic sulla scheda Contenitore.
- Fai clic su Aggiungi variabile per aggiungere una nuova variabile e specifica il nome che vuoi assegnare alla variabile e il relativo valore nei campi Nome e Valore.
Fai clic su Crea o Esegui il deployment.

gcloud

Nota: se utilizzi gcloud CLI per eseguire il deployment di una funzione, devi utilizzare gcloud beta run deploy, specificare i flag richiesti e disporre dei ruoli richiesti.

Puoi specificare le variabili di ambiente durante il deployment di un servizio o aggiornarle dopo la creazione del servizio:

Per specificare le variabili di ambiente durante il deployment del servizio, utilizza il flag --set-env-vars:

gcloud run deploy SERVICE --image IMAGE_URL --set-env-vars KEY1=VALUE1,KEY2=VALUE2

Sostituisci:

SERVICE con il nome del servizio.
KEY1=VALUE1,KEY2=VALUE2, con l'elenco separato da virgola dei nomi e dei valori delle variabili.
IMAGE_URL con un riferimento all'immagine del container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la forma LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .

YAML

Se stai creando un nuovo servizio, salta questo passaggio. Se stai aggiornando un servizio esistente, scarica la relativa configurazione YAML:
```
gcloud run services describe SERVICE --format export > service.yaml
```
Aggiorna gli attributi name e value nell'attributo env in containers::
```
apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    metadata:
      name: REVISION
    spec:
      containers:
      - image: IMAGE
        env:
        - name: KEY-1
          value: VALUE-1
        - name: KEY-N
          value: VALUE-N
```
Sostituisci
- SERVICE con il nome del servizio Cloud Run
- IMAGE_URL con un riferimento all'immagine del container, ad esempio us-docker.pkg.dev/cloudrun/container/hello:latest. Se utilizzi Artifact Registry, il repository REPO_NAME deve essere già stato creato. L'URL ha la forma LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- KEY-1, VALUE-1 con la variabile di ambiente e il valore. Se vuoi, aggiungi altre variabili e valori.
- REVISION con un nuovo nome della revisione o eliminarla (se presente). Se fornisci un nuovo nome di revisione, questo deve soddisfare i seguenti criteri:
  - Inizia con SERVICE-
  - Deve contenere solo lettere minuscole, numeri e -
  - Non termina con -
  - Non deve superare i 63 caratteri
Crea o aggiorna il servizio utilizzando il seguente comando:
```
gcloud run services replace service.yaml
```

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

La seguente risorsa google_cloud_run_v2_service specifica che la variabile di ambiente foo viene impostata su bar e la variabile di ambiente baz su quux. Aggiorna le variabili di ambiente in base alle tue esigenze specifiche:

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-env-var"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"

      # Environment variables
      env {
        name  = "foo"
        value = "bar"
      }
      env {
        name  = "baz"
        value = "quux"
      }
    }
  }
}

Impostare molte variabili di ambiente

Se hai troppe variabili di ambiente che non possono essere facilmente elencate in formato KEY1=VALUE1,KEY2=VALUE2, in alternativa puoi ripetere più volte i flag elencati sopra:

   [...]
   --set-env-vars "KEY1=VALUE1" \
   --set-env-vars "KEY2=VALUE2" \
   --set-env-vars "KEY3=VALUE3"

Caratteri di escape per le virgole

Poiché il carattere virgola , viene utilizzato per suddividere le variabili di ambiente, se la variabile di ambiente contiene caratteri virgola come valori, devi eseguire l'escapismo di questi delimitatori specificando un carattere delimitatore diverso, ad esempio @:

--set-env-vars "^@^KEY1=value1,value2,value3@KEY2=..."

Imposta le variabili di ambiente predefinite nel contenitore

Puoi utilizzare l'istruzione ENV in un Dockerfile per impostare i valori predefiniti per le variabili di ambiente:

ENV KEY1=VALUE1,KEY2=VALUE2

Ordine di precedenza: variabili del contenitore rispetto a quelle del servizio o del job

Se imposti una variabile di ambiente predefinita nel contenitore e anche imposti una variabile di ambiente con lo stesso nome sul servizio o sul job Cloud Run, il valore impostato sul servizio ha prioritaria.

Visualizzare le impostazioni delle variabili di ambiente

Per visualizzare le impostazioni correnti delle variabili di ambiente per il servizio Cloud Run:

Console

Nella console Google Cloud, vai a Cloud Run:

Vai a Cloud Run
Fai clic sul servizio che ti interessa per aprire la pagina Dettagli servizio.
Fai clic sulla scheda Revisioni.
Nel riquadro dei dettagli a destra, l'impostazione delle variabili di ambiente è elencata nella scheda Contenitore.

gcloud

Utilizza il seguente comando:
```
gcloud run services describe SERVICE
```
Individua l'impostazione delle variabili di ambiente nella configurazione restituita.

Aggiorna le variabili di ambiente

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

Console

Per aggiornare le variabili di ambiente di runtime utilizzando la console Google Cloud:

Nella console Google Cloud, vai a Cloud Run:

Vai a Cloud Run
Seleziona il servizio dall'elenco e fai clic su Modifica ed esegui il deployment della nuova revisione.
Fai clic sulla scheda Contenitore.
Nella scheda Variabili e secret, modifica i campi Nome o Valore e fai clic su Fine.
Fai clic su Esegui il deployment.

gcloud

Nota: se utilizzi gcloud CLI per eseguire il deployment di una funzione, devi utilizzare gcloud beta run deploy, specificare i flag richiesti e disporre dei ruoli richiesti.

Per aggiornare le variabili di ambiente di un servizio esistente, utilizza il parametro --update-env-vars:

gcloud run services update SERVICE --update-env-vars KEY1=VALUE1,KEY2=VALUE2

Sostituisci:

SERVICE con il nome del servizio.
KEY1=VALUE1,KEY2=VALUE2, con l'elenco separato da virgola dei nomi e dei valori delle variabili.

Per aggiornare le variabili di ambiente di un servizio multiregionale esistente, utilizza il comando gcloud beta run multi-region-services update.

Eliminare le variabili di ambiente

Console

Per eliminare le variabili di ambiente di runtime utilizzando la console Google Cloud:

Nella console Google Cloud, vai a Cloud Run:

Vai a Cloud Run
Seleziona il servizio dall'elenco e fai clic su Modifica ed esegui il deployment della nuova revisione.
Fai clic sulla scheda Contenitore.
Nella scheda Variabili e secret, sposta il cursore a sinistra del campo Valore della variabile di ambiente che stai rimuovendo per visualizzare l'icona Elimina e fai clic su di essa.
Fai clic su Fine.
Fai clic su Esegui il deployment.

gcloud

Nota: se utilizzi gcloud CLI per eseguire il deployment di una funzione, devi utilizzare gcloud beta run deploy, specificare i flag richiesti e disporre dei ruoli richiesti.

Per rimuovere in modo selettivo le variabili di ambiente di un servizio esistente,utilizza il flag --remove-env-vars:

gcloud run services update SERVICE --remove-env-vars KEY1,KEY2

Sostituisci:

SERVICE con il nome del servizio.
KEY1,KEY2, con l'elenco dei nomi delle variabili separati da virgole.

In alternativa, cancella tutte le variabili di ambiente impostate in precedenza con il flag --clear-env-vars:

gcloud run services update SERVICE --clear-env-vars

Sostituisci:

SERVICE con il nome del servizio.

Codice di esempio

Per un esempio di codice che mostra come accedere alle variabili di ambiente nel codice, consulta Gestione della configurazione sensibile con Secret Manager nel tutorial sull'autenticazione utente finale.

Passaggi successivi

Puoi utilizzare le variabili di ambiente per impostare la configurazione dei buildpacks. Per dettagli specifici per ciascun linguaggio, consulta la documentazione dei buildpack per: