Imposta le variabili di ambiente

Scopri come creare e utilizzare le variabili di ambiente in Knative serving.

Quando imposti le variabili di ambiente, queste vengono inserite nel container e sono accessibili al tuo codice. Le variabili di ambiente sono impostate come coppie chiave-valore. Ad esempio, supponiamo che tu stia eseguendo un servizio che abilita la registrazione aggiuntiva quando legge LOGGING_VERBOSE: true nell'ambiente. In questo scenario, imposti la coppia chiave-valore della variabile di ambiente come LOGGING_VERBOSE=true. I comandi o l'interfaccia utente esatti sono mostrati nelle sezioni seguenti.

Attenzione: non devi utilizzare le variabili di ambiente per archiviare e utilizzare informazioni sensibili perché le variabili di ambiente vengono 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 Knative serving. Non devi impostarla tu.

Impostare le variabili di ambiente su un servizio

Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Le revisioni successive riceveranno automaticamente anche questa impostazione di configurazione, a meno che tu non apporti aggiornamenti espliciti per modificarla.

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

Console

1. Vai a Knative serving nella Google Cloud console:

   Vai a Knative serving

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

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

4. Segui questi passaggi:

   • Se stai aggiungendo una variabile, fai clic su Aggiungi variabile e specifica il nome che vuoi assegnare alla variabile e il relativo valore nelle caselle di testo Nome e Valore.
   • Se stai modificando il valore di una variabile, sostituisci il valore corrente nella casella di testo Valore con quello che vuoi.
   • Se stai rimuovendo una o più variabili di ambiente, passa il cursore a sinistra della casella di testo Valore della variabile che stai rimuovendo per visualizzare l'icona del cestino e fai clic su di essa.

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

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

7. Fai clic su Crea per eseguire il deployment dell'immagine in Knative serving e attendi il completamento del deployment.

Riga di comando

Puoi utilizzare Google Cloud CLI 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 gcloud run services update comando con uno dei seguenti parametri:

  • --set-env-vars
  Attenzione: --set-env-vars riconfigura tutte le variabili di ambiente, quindi vengono impostate e rimangono solo le variabili di ambiente specificate. Tutte le altre variabili di ambiente esistenti in precedenza vengono rimosse se non sono specificate in modo esplicito.
  
  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 KEY e il valore della variabile di ambiente per VALUE. Come specificare più parametri.

  Opzioni dei parametri dei comandi

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

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

  • Per specificare più insiemi di coppie chiave-valore, puoi specificare più parametri per una maggiore 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 gcloud run deploy comando con il --set-env-vars parametro:

  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/cloudrun/hello.
  • 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 KEY e il valore della variabile di ambiente per VALUE. Come specificare più parametri.

  Opzioni dei parametri dei comandi

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

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

  • Per specificare più insiemi di coppie chiave-valore, puoi specificare più parametri per una maggiore 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 i file YAML sostituisce la configurazione dei servizi esistenti. Poiché un file YAML sovrascrive completamente tutte le configurazioni, devi evitare di utilizzare più metodi per modificare i servizi. Ad esempio, non utilizzare i file YAML insieme alla Google Cloud console o ai comandi.

gcloud

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

1. Scarica la configurazione del 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 Knative serving.

2. Nel file locale, aggiorna gli attributi name e value nell'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 con il nome del tuo servizio Knative serving
   • KEY-1, VALUE-1 con la variabile di ambiente e il valore. Se vuoi, aggiungi altre variabili e valori.

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

   gcloud run services replace service.yaml

Impostare le variabili di ambiente predefinite nel container

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 container rispetto a quelle del servizio

Se imposti una variabile di ambiente predefinita nel container e anche imposti una variabile di ambiente con lo stesso nome nel servizio Knative serving, il valore impostato nel servizio ha la precedenza.

Attivare i link di servizio Kubernetes

Per utilizzare i link di servizio Kubernetes, devi attivare 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: quando attivi i link di servizio Kubernetes, le informazioni su ciascuno dei tuoi servizi vengono inserite nelle variabili di ambiente del pod. Negli spazi dei nomi che contengono più di 1000 servizi o revisioni di Knative serving, potresti riscontrare problemi di prestazioni o persino errori del servizio.

Per attivare i link di servizio Kubernetes, esegui il seguente comando per impostare data.enable-service-links su true in knative-serving/config-defaults ConfigMap:

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