Imposta le variabili di ambiente

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

Quando imposti le variabili di ambiente, 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 attiva 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 la UI esatti sono mostrati nelle sezioni seguenti.

Attenzione: non 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 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 impostarlo personalmente.

Impostare le variabili di ambiente su un servizio

Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche le revisioni successive riceveranno automaticamente questa impostazione di configurazione, a meno che tu 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 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 console Google Cloud :

   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 un valore per una variabile, sostituisci il valore corrente nella casella di testo Valore con quello che preferisci.
   • Se rimuovi 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 Cestino e fai clic su di essa.

5. Fai clic su Avanti per continuare con la 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 quelli 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 vengano impostate e rimangano solo le variabili di ambiente specificate. Tutte le altre variabili di ambiente esistenti in precedenza vengono rimosse se non sono specificamente indicate.
  
  Utilizza --update-env-vars per aggiungere o modificare semplicemente le variabili di ambiente esistenti ed evitare di rimuovere tutte le variabili di ambiente esistenti.
  • --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 di quella variabile di ambiente per VALUE. Come specificare più parametri.

  Opzioni dei parametri del comando

  • 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 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/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 di quella variabile di ambiente per VALUE. Come specificare più parametri.

  Opzioni dei parametri del comando

  • 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 ai comandi della consoleGoogle Cloud 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 e implementare le 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 nello spazio di lavoro locale:

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

   Sostituisci SERVICE con il nome del tuo servizio Knative.

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 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 sua nuova configurazione utilizzando il seguente comando:

   gcloud run services replace service.yaml

Impostazione delle 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 e 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.

Abilitazione dei service link Kubernetes

Per utilizzare i collegamenti di servizio Kubernetes, devi attivare manualmente il supporto. A causa dei problemi di rendimento riscontrati negli spazi dei nomi con migliaia di servizi e revisioni, i service link 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 abiliti i service link di Kubernetes. Negli spazi dei nomi che contengono più di 1000 servizi o revisioni Knative, potresti riscontrare problemi di prestazioni o persino guasti del servizio.

Per abilitare i service link Kubernetes, esegui questo 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"}}