Imposta le variabili di ambiente

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

Quando imposti le variabili di ambiente, vengono inseriti nel container e sono accessibili al codice. Le variabili di ambiente vengono impostate come coppie chiave/valore. Ad esempio, supponiamo che tu eseguire un servizio che abilita log aggiuntivi durante LOGGING_VERBOSE: true nell'ambiente. In questo scenario, imposti la coppia chiave/valore della variabile di ambiente come LOGGING_VERBOSE=true. La i comandi esatti o l'interfaccia utente vengono mostrati nelle sezioni seguenti.

Attenzione: non devi utilizzare le variabili di ambiente per archiviare e utilizzare informazioni sensibili in quanto le variabili di ambiente sono archiviate come testo accessibile al cluster. Utilizza le funzionalità di Secret per le informazioni sensibili.

Nomi riservati

Le variabili di ambiente definite nel contratto di runtime del container sono riservati e non possono essere impostati. In particolare, la variabile di ambiente PORT viene inserito all'interno del container da Knative serving. Non impostare da te.

Impostazione delle variabili di ambiente su un servizio

Qualsiasi modifica alla configurazione porta la creazione di una nuova revisione. Anche le revisioni successive ricevono automaticamente di questa 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 il deployment di service o aggiornare un servizio esistente 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 in cui stai eseguendo il deployment. Se stai configurando un'istanza servizio esistente, fai clic sul servizio e poi su Modifica e Esegui il deployment della 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 la il nome che preferisci per la variabile e il relativo valore nelle caselle di testo Nome e Valore.
   • Se modifichi il valore di una variabile, sostituisci il valore corrente nella casella di testo Valore con quello desiderato.
   • 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 sulla variabile.

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

6. Nella sezione Configura il modo in cui viene attivato questo servizio, seleziona la connettività da utilizzare per richiamare il servizio.

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

Riga di comando

Puoi utilizzare Google Cloud CLI per impostare l'ambiente variabili per nuovi servizi o per aggiornare 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 vengono impostate e rimangono solo le variabili di ambiente specificate. Tutti gli altri le variabili di ambiente esistenti in precedenza vengono rimosse esplicitamente specificate.
  
  Utilizza --update-env-vars per aggiungere o modificare semplicemente variabili di ambiente esistenti ed evitare di rimuovere tutte quelle esistenti variabili di ambiente.
  • --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 separati da una virgola elenco di coppie di nomi e valori 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 del comando

  • Per specificare una variabile di ambiente che contiene una virgola (,), devono essere sottoposti a escape per 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, è possibile 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 --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, per ad esempio gcr.io/cloudrun/hello.
  • SERVICE con il nome del tuo servizio.
  • KEY1=VALUE1,KEY2=VALUE2 separati da una virgola elenco di coppie di nomi e valori 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 del comando

  • Per specificare una variabile di ambiente che contiene una virgola (,), devono essere sottoposti a escape per 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, è possibile 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 le la configurazione dei servizi esistenti. Poiché un file YAML sovrascrive completamente tutte le configurazioni, è consigliabile evitare di utilizzare più metodi per modificare i servizi di machine learning. Ad esempio, non utilizzare i file YAML insieme Console Google Cloud o i comandi gcloud.

Puoi scaricare la configurazione di un servizio esistente in un YAML con il comando gcloud run services describe utilizzando --format=export. Puoi quindi modificare il file YAML ed eseguire il deployment queste modifiche con il comando gcloud run services replace. Assicurarsi 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 Knative serving.

2. Nel file locale, aggiorna gli attributi name e value sotto la 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

Impostazione delle variabili di ambiente predefinite nel container

Puoi utilizzare la 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 di servizio

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

Abilitazione dei link ai servizi Kubernetes in corso...

Per utilizzare Collegamenti ai servizi Kubernetes, devi abilitare manualmente il supporto. A causa dei problemi di prestazioni rilevati in spazi dei nomi con migliaia di servizi e revisioni, i link ai servizi Kubernetes sono state disattivate per impostazione predefinita a partire da gennaio 2021.

Importante: le informazioni su ciascuno dei tuoi servizi vengono inserite nella cartella le variabili di ambiente quando abiliti i link ai servizi Kubernetes. Negli spazi dei nomi che contengono più di 1000 servizi o revisioni di Knative serving, potrebbero verificarsi problemi di prestazioni o persino guasti del servizio.

Per abilitare i link ai servizi Kubernetes, esegui questo comando per impostare Da data.enable-service-links a true nel tuo knative-serving/config-defaults ConfigMap:

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