Scopri come creare e utilizzare le variabili di ambiente nella pubblicazione con Knative.
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, supponi di eseguire un servizio che consente il logging aggiuntivo quando legge LOGGING_VERBOSE: true
nell'ambiente. In questo scenario, devi impostare
la coppia chiave/valore della variabile di ambiente come LOGGING_VERBOSE=true
. La UI o i comandi esatti sono mostrati nelle sezioni seguenti.
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 dalla pubblicazione con Knative. Non devi eseguire l'impostazione da solo.
Impostazione delle variabili di ambiente su un servizio
Qualsiasi modifica alla configurazione comporta la creazione di una nuova revisione. Anche per le revisioni successive verrà applicata 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 il deployment di un nuovo servizio o aggiorni un servizio esistente ed esegui il deployment di una revisione:
Console
Vai alla gestione di Knative nella console Google Cloud:
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 e poi su Edit & Deploy nuova revisione.
In Impostazioni avanzate, fai clic su Variabili e secret.
Segui questi passaggi:
- Se aggiungi una variabile, fai clic su Aggiungi variabile e specifica il nome della variabile e il relativo valore nelle caselle di testo Nome e Valore.
- Se modifichi un valore per una variabile, sostituisci il valore corrente nella casella di testo Valore con il valore che ti interessa.
- Se vuoi rimuovere 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.
Fai clic su Avanti per passare alla sezione successiva.
Nella sezione Configura come viene attivato questo servizio, seleziona la connettività che vuoi utilizzare per richiamare il servizio.
Fai clic su Crea per eseguire il deployment dell'immagine nella pubblicazione Knative e attendere 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 comando
gcloud run services update
con uno dei seguenti parametri:Esempio:
gcloud run services update SERVICE --update-env-vars KEY1=VALUE1,KEY2=VALUE2
Sostituisci:
- SERVICE con il nome del servizio.
- KEY1=VALUE1,KEY2=VALUE2 con un elenco separato da virgole di coppie di nomi e valori per ogni variabile di ambiente. Specifica il nome della variabile di ambiente per ogni KEY e il valore di questa variabile di ambiente per VALUE. Come specificare più parametri.
-
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 usi@
:--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"
Opzioni dei parametri del comando
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 servizio.
- KEY1=VALUE1,KEY2=VALUE2 con un elenco separato da virgole di coppie di nomi e valori per ogni variabile di ambiente. Specifica il nome della variabile di ambiente per ogni KEY e il valore di questa variabile di ambiente per VALUE. Come specificare più parametri.
-
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 usi@
:--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"
Opzioni dei parametri del comando
- IMAGE_URL con un riferimento all'immagine container,
ad esempio
YAML
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 delle modifiche con il comando gcloud run services replace
.
Devi assicurarti di modificare solo gli attributi specificati.
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 di pubblicazione Knative.
Nel file locale, aggiorna gli attributi
name
evalue
inenv
incontainers:
: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 di pubblicazione Knative
- KEY-1, VALUE-1 con la variabile di ambiente e il valore. Se vuoi, puoi aggiungere altre variabili e valori.
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 e di servizio
Se imposti una variabile di ambiente predefinita nel container e anche una variabile di ambiente con lo stesso nome sul servizio di gestione Knative, il valore impostato sul servizio ha la precedenza.
Abilitazione dei collegamenti ai servizi Kubernetes
Per utilizzare i link ai servizi Kubernetes, devi abilitare manualmente l'assistenza. A causa dei problemi di prestazioni riscontrati negli spazi dei nomi con migliaia di servizi e revisioni, i link ai servizi Kubernetes sono stati disabilitati per impostazione predefinita a partire da gennaio 2021.
Per abilitare i collegamenti ai servizi 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"}}