Imposta le variabili di ambiente

Scopri come creare e utilizzare le variabili di ambiente in Cloud Run for Anthos.

Le variabili di ambiente impostate vengono inserite nel container e sono accessibili al codice. Le variabili di ambiente sono impostate come coppie chiave/valore. Supponi ad esempio di eseguire un servizio che abilita il logging aggiuntivo quando legge LOGGING_VERBOSE: true nell'ambiente. In questo scenario, imposti la coppia chiave/valore della variabile di ambiente su LOGGING_VERBOSE=true. I comandi esatti o la UI vengono mostrati nelle sezioni seguenti.

Attenzione: non devi utilizzare variabili di ambiente per archiviare e consumare informazioni sensibili perché le variabili di ambiente sono archiviate come testo e sono accessibili al cluster. Utilizza i secret per le informazioni sensibili.

Nomi riservati

Le variabili di ambiente definite nel contratto di runtime del container sono riservate e non possono essere impostate. In particolare, la variabile di ambiente PORT viene inserita nel container da Cloud Run for Anthos. Non devi configurarla da te.

Impostazione delle variabili di ambiente su un servizio

Qualsiasi modifica della configurazione determina la creazione di una nuova revisione. Anche le revisioni successive riceveranno automaticamente questa impostazione di configurazione, a meno che non apporti aggiornamenti espliciti per modificarla.

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

console

1. Vai a Cloud Run for Anthos in Google Cloud Console:

   Vai a Cloud Run for Anthos

2. Fai clic su Crea servizio se stai configurando un nuovo servizio in cui stai eseguendo il deployment. Se stai configurando un servizio esistente, fai clic sul servizio, quindi su Modifica e esegui il deployment di una nuova revisione.

3. In Impostazioni avanzate, fai clic su Variabili e secret.

   

4. Segui questi passaggi:

   • Se aggiungi una variabile, fai clic su Aggiungi variabile e specifica il nome che vuoi assegnare alla variabile e il suo valore nelle caselle di testo Nome e Valore.
   • Se vuoi modificare un valore per una variabile, sostituisci il valore corrente nella casella di testo Valore con quello che vuoi.
   • Se rimuovi una o più variabili di ambiente, passa il mouse a sinistra della casella di testo Valore della variabile che stai rimuovendo per visualizzare l'icona del Cestino.

5. Fai clic su Avanti per passare alla sezione successiva.

6. Nella sezione Configura il funzionamento del servizio, seleziona la connettività che vuoi utilizzare per richiamare il servizio.

7. Fai clic su Crea per eseguire il deployment dell'immagine in Cloud Run for Anthos e attendere il completamento del deployment.

Riga di comando

Puoi utilizzare l'interfaccia a riga di comando di Google Cloud per impostare le variabili di ambiente per i nuovi servizi o per aggiornare i servizi esistenti:

• Per i servizi esistenti, aggiorna le variabili di ambiente eseguendo il comando gcloud run services update con uno dei seguenti parametri:

  • --set-env-vars
  Attenzione: --set-env-vars riconfigura tutte le variabili di ambiente in modo che siano impostate solo le variabili di ambiente specificate. Tutte le altre variabili di ambiente esistenti verranno rimosse se non vengono specificate esplicitamente.
  
  Utilizza --update-env-vars per aggiungere o modificare semplicemente le variabili di ambiente esistenti ed evitare di rimuoverle tutte.
  • --update-env-vars
  • --remove-env-vars
  • --clear-env-vars

  Esempio:

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

  Sostituisci:

  • SERVICE con il nome del tuo servizio.
  • KEY1=VALUE1,KEY2=VALUE2 con un elenco separato da virgole di coppie nome/valore per ogni variabile di ambiente. Specifica il nome della variabile di ambiente per ogni elemento KEY e il valore di tale variabile per VALUE. Come specificare più parametri.

  Opzioni dei parametri di comando

  • Per specificare una variabile di ambiente che contiene una virgola (,), devi escape ogni KEY=VALUE con un delimitatore diverso. Ad esempio, se utilizzi @:

    --set-env-vars "^@^KEY1=value,with,commas@KEY2=anothervalue@KEY3..."
    

  • Per specificare diversi insiemi di coppie chiave-valore, puoi specificare più parametri per la leggibilità. Esempio:

    [...]
    --set-env-vars "KEY=VALUE1" \
    --set-env-vars "KEY=VALUE2" \
    --set-env-vars "KEY=VALUE3"
    

  OK

• Per i nuovi servizi, imposta le variabili di ambiente eseguendo il comando gcloud run deploy con il parametro --set-env-vars:

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

  Sostituisci:

  • IMAGE_URL con un riferimento all'immagine container, ad esempio gcr.io/myproject/my-image:latest.
  • SERVICE con il nome del tuo servizio.
  • KEY1=VALUE1,KEY2=VALUE2 con un elenco separato da virgole di coppie nome/valore per ogni variabile di ambiente. Specifica il nome della variabile di ambiente per ogni elemento KEY e il valore di tale variabile per VALUE. Come specificare più parametri.

  Opzioni dei parametri di comando

  • Per specificare una variabile di ambiente che contiene una virgola (,), devi escape ogni KEY=VALUE con un delimitatore diverso. Ad esempio, se utilizzi @:

    --set-env-vars "^@^KEY1=value,with,commas@KEY2=anothervalue@KEY3..."
    

  • Per specificare diversi insiemi di coppie chiave-valore, puoi specificare più parametri per la leggibilità. Esempio:

    [...]
    --set-env-vars "KEY=VALUE1" \
    --set-env-vars "KEY=VALUE2" \
    --set-env-vars "KEY=VALUE3"
    

  OK

YAML

Attenzione: il deployment delle modifiche alla configurazione utilizzando file YAML sostituisce la configurazione dei tuoi servizi esistenti. Poiché un file YAML sovrascrive completamente tutte le configurazioni, evita di utilizzare più metodi per modificare i servizi. Ad esempio, non utilizzare i file YAML insieme ai comandi di Google Cloud Console o gcloud.

Puoi scaricare la configurazione di un servizio esistente in un file YAML con il comando gcloud run services describe utilizzando il flag --format=export. Puoi quindi modificare il file YAML ed eseguire il deployment di queste modifiche con il comando gcloud beta run services replace. Devi assicurarti di modificare solo gli attributi specificati.

1. Scarica la configurazione del tuo servizio in un file denominato service.yaml nell'area di lavoro locale:

   gcloud run services describe SERVICE --format export > service.yaml

   Sostituisci SERVICE con il nome del tuo servizio Cloud Run for Anthos.

2. Nel tuo file locale, aggiorna gli attributi name e value sotto l'attributo env in containers::

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       spec:
         containers:
         - env:
           - name: KEY-1
             value: VALUE-1
           - name: KEY-N
             value: VALUE-N

   Sostituisci

   • SERVICE il nome del tuo servizio Cloud Run for Anthos
   • KEY-1, VALUE-1 con la variabile di ambiente e il valore. Se vuoi, aggiungi altre variabili e valori come preferisci.

3. Sostituisci il servizio con la nuova configurazione utilizzando il seguente comando:

   gcloud beta run services replace service.yaml

Impostazione delle variabili di ambiente predefinite nel container

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

ENV KEY1=VALUE1,KEY2=VALUE2

Ordine di precedenza: container e variabili di servizio

Se imposti una variabile di ambiente predefinita nel container e imposti una variabile di ambiente con lo stesso nome nel servizio Cloud Run for Anthos, il valore impostato sul servizio ha la precedenza.

Attivazione dei link di servizio Kubernetes

Per utilizzare i link di servizio Kubernetes, devi abilitare manualmente il supporto. A causa dei problemi di prestazioni riscontrati negli spazi dei nomi con migliaia di servizi e revisioni, i link di servizio Kubernetes sono stati disattivati per impostazione predefinita a partire da gennaio 2021.

Importante: le informazioni su ciascuno dei tuoi servizi vengono inserite nelle variabili di ambiente del pod quando attivi i collegamenti ai servizi Kubernetes. Negli spazi dei nomi che contengono oltre 1000 revisioni o servizi Cloud Run for Anthos, potresti riscontrare problemi di prestazioni o anche errori di servizio.

Per abilitare i collegamenti ai servizi Kubernetes, esegui il comando seguente per impostare data.enable-service-links su true nel knative-serving/config-defaults ConfigMap:

kubectl patch cm -n knative-serving config-defaults -p '{"data":{"enable-service-links":"true"}}