Scopri come creare un ConfigMap e quindi configurare i tuoi servizi e le tue revisioni Knative serving per l'utilizzo di quel ConfigMap.
Un caso d'uso comune per un servizio è l'utilizzo di ConfigMap per separare il codice dell'applicazione dalla configurazione. ConfigMap è simile a Secret, ad eccezione del fatto che utilizzi un Secret per le informazioni sensibili e un ConfigMap utilizzi un ConfigMap per archiviare dati non sensibili come stringhe di connessione, credenziali pubbliche, nomi host e URL. Per scoprire di più sull'utilizzo di ConfigMap, consulta la documentazione di Google Kubernetes Engine.
Quando abiliti i container per l'accesso a ConfigMap, puoi scegliere una di queste opzioni:
- Monta il ConfigMap come volume, con le voci ConfigMap disponibili come file nel volume montato. Questa opzione è consigliata perché garantisce di ricevere la versione più recente del ConfigMap durante la lettura.
- Passa il ConfigMap utilizzando le variabili di ambiente.
Creazione di un oggetto ConfigMap
Esistono diversi modi per creare un ConfigMap, come descritto nella pagina ConfigMaps della documentazione di GKE. Per praticità, i passaggi seguenti mostrano un modo semplice per creare un ConfigMap.
Quando crei un ConfigMap, assicurati di crearlo nello stesso spazio dei nomi del cluster che esegue il tuo servizio Knative serving. Queste
istruzioni utilizzano lo spazio dei nomi default
.
Puoi creare un ConfigMap dalla riga di comando:
kubectl create configmap NAME DATA
Sostituisci:
- NAME è il nome dell'oggetto ConfigMap.
DATA può essere:
- Il flag
--from-file
e il percorso per ogni directory contenente uno o più file di configurazione. - Il flag
--from-literal
e la coppia chiave-valore per ognuno che vuoi aggiungere all'oggetto ConfigMap.
- Il flag
Ad esempio:
kubectl create configmap special-config --from-literal=special.how=very --from-literal=special.type=charm
Il ConfigMap viene creato e caricato dove è disponibile per i cluster nello spazio dei nomi default
.
Rendere disponibile un ConfigMap a un servizio
Dopo aver creato un ConfigMap, puoi renderlo disponibile per il tuo servizio Knative serving come volume o come variabili di ambiente utilizzando la console Google Cloud o Google Cloud CLI quando esegui il deployment di un nuovo servizio o aggiorni un servizio esistente ed 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 servizio esistente, fai clic sul servizio e poi su Modifica ed esegui il deployment della nuova revisione.
In Impostazioni avanzate, fai clic su Variabili e secret.
In Fai riferimento a un ConfigMap, seleziona il ConfigMap desiderato dal menu a discesa.
- Nel menu a discesa Metodo di riferimento, seleziona il modo in cui vuoi utilizzare il ConfigMap, montato come volume o esposto come variabili di ambiente.
- Se utilizzi il montaggio come volume, specifica il percorso e fai clic su Fine.
- Se l'esposizione avviene come variabili di ambiente:
- Specifica il nome della variabile e seleziona il valore ConfigMap corrispondente dal menu a discesa Chiave.
- Fai clic su Aggiungi per aggiungere un altro valore ConfigMap.
- Specifica il nome della variabile e seleziona il valore ConfigMap corrispondente dal menu a discesa Chiave.
- Fai clic su Fine.
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 il completamento del deployment.
Riga di comando
Puoi utilizzare Google Cloud CLI per impostare gli oggetti ConfigMap per nuovi servizi o per aggiornare un servizio esistente:
Per i servizi esistenti, aggiorna un ConfigMap eseguendo il comando
gcloud run services update
con uno dei seguenti parametri:Esempio:
gcloud run services update SERVICE --update-config-maps KEY1=VALUE1,KEY2=VALUE2
Sostituisci:
- SERVICE con il nome del tuo servizio.
- KEY1=VALUE1,KEY2=VALUE2 con un elenco separato da virgole di coppie di nomi e valori per ogni ConfigMap.
Per ogni KEY puoi
specificare un percorso di montaggio o fornire una variabile di ambiente. Specifica un percorso di montaggio iniziando con una barra
/
. Tutte le altre chiavi corrispondono alle variabili di ambiente. Per ogni VALUE, specifica il nome ConfigMap. Come specificare più parametri.
Opzioni dei parametri del comando
Per specificare diversi set di coppie chiave/valore, puoi specificare più parametri di leggibilità. Esempio:[...] --update-config-maps "KEY=VALUE1" \ --update-config-maps "KEY=VALUE2" \ --update-config-maps "KEY=VALUE3"
Per i nuovi servizi, imposta il ConfigMap eseguendo il comando
gcloud run deploy
con il parametro--set-config-maps
:gcloud run deploy SERVICE --image=IMAGE_URL --set-config-maps 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 di nomi e valori per ogni ConfigMap.
Per ogni KEY puoi
specificare un percorso di montaggio o fornire una variabile di ambiente. Specifica un percorso di montaggio iniziando con una barra
/
. Tutte le altre chiavi corrispondono alle variabili di ambiente. Per ogni VALUE, specifica il nome ConfigMap. Come specificare più parametri.
Opzioni dei parametri del comando
Per specificare diversi set di coppie chiave/valore, puoi specificare più parametri di leggibilità. Esempio:[...] --update-config-maps "KEY=VALUE1" \ --update-config-maps "KEY=VALUE2" \ --update-config-maps "KEY=VALUE3"
- IMAGE_URL con un riferimento all'immagine container,
ad esempio