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 sono 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.
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
Vai a Knative serving 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'istanza servizio esistente, fai clic sul servizio e poi su Modifica e Esegui il deployment della 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 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.
Fai clic su Avanti per passare alla sezione successiva.
Nella sezione Configura il modo in cui viene attivato questo servizio, seleziona la connettività da utilizzare per richiamare il servizio.
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: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.
-
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"
Opzioni dei parametri del comando
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.
-
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"
Opzioni dei parametri del comando
- IMAGE_URL con un riferimento all'immagine container, per
ad esempio
YAML
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.
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.
Nel file locale, aggiorna gli attributi
name
evalue
sotto la Attributoenv
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 Knative serving
- KEY-1, VALUE-1 con la variabile di ambiente e il valore. Se vuoi, aggiungi altre variabili e valori.
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.
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"}}