Gestire le variabili di ambiente in App contenitore di Azure

In App contenitore di Azure è possibile impostare variabili di ambiente di runtime. Queste variabili possono essere impostate manualmente come voci o come riferimenti a segreti. Queste variabili di ambiente vengono caricate nell'app contenitore in fase di runtime.

Configurare le variabili di ambiente

È possibile configurare le variabili di ambiente al momento della creazione dell'app contenitore o successivamente, creando una nuova revisione.

Nota

Per evitare confusione, non è consigliabile duplicare le variabili di ambiente. Quando più variabili di ambiente hanno lo stesso nome, l'ultima nell'elenco diventa effettiva.

Azure portal

Se si sta creando una nuova app contenitore tramite il portale di Azure, è possibile configurare le variabili di ambiente nella sezione Contenitore:

Interfaccia della riga di comando di Azure

È possibile creare l'app contenitore con le variabili di ambiente mediante il comando az containerapp create, passando le variabili di ambiente come voci "key=value" separate da spazi usando il parametro --env-vars.

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" \
    --env-vars GREETING="Hello, world" ANOTHERENV=anotherenv

Per fare riferimento a un segreto, è necessario assicurarsi che il segreto sia già stato creato. Vedere Gestire i segreti. È possibile usare il nome del segreto e passarlo al campo del valore, ma iniziando con secretref:

az containerapp update \
    -n <APP NAME> 
    -g <RESOURCE_GROUP_NAME> 
    --set-env-vars <VAR_NAME>=secretref:<SECRET_NAME>

PowerShell

Se si vuole usare PowerShell, creare prima di tutto un oggetto in memoria denominato EnvironmentVar usando il cmdlet di PowerShell New-AzContainerAppEnvironmentVarObject.

Per usare questo cmdlet, è necessario passare rispettivamente il nome della variabile di ambiente usando il parametro -Name e il valore usando il parametro -Value.

$envVar = New-AzContainerAppEnvironmentVarObject -Name "envVarName" -Value "envVarvalue"

Per fare riferimento a un segreto, è necessario assicurarsi che il segreto sia già stato creato. Vedere Gestire i segreti. È possibile usare il nome del segreto e passarlo al parametro -SecretRef:

$envVar = New-AzContainerAppEnvironmentVarObject -Name "envVarName" -SecretRef "secretName"

È quindi necessario creare un altro oggetto in memoria denominato Container usando il cmdlet di PowerShell New-AzContainerAppTemplateObject.

In questo cmdlet occorre passare il nome dell'immagine del contenitore (non l'app contenitore) desiderato usando il parametro -Name, il nome completo dell'immagine usando il parametro -Image e fare riferimento all'oggetto ambiente definito in precedenza nella variabile $envVar.

$containerTemplate = New-AzContainerAppTemplateObject -Name "container-app-name" -Image "repo/imagename:tag" -Env $envVar

Nota

Si noti che può essere necessario definire altre impostazioni all'interno dell'oggetto modello per evitare di eseguirne l'override, ad esempio risorse, montaggi di volumi e così via. Consultare la documentazione completa su questo modello in New-AzContainerAppTemplateObject.

Infine, è possibile aggiornare l'app contenitore in base al nuovo oggetto modello creato usando il cmdlet di PowerShell Update-AzContainerApp.

In questo ultimo cmdlet è sufficiente passare l'oggetto modello definito nella variabile $containerTemplate nel passaggio precedente usando il parametro -TemplateContainer.

Update-AzContainerApp -TemplateContainer $containerTemplate

Aggiungere variabili di ambiente in app contenitore esistenti

Dopo aver creato l'app contenitore, l'unico modo per aggiornare le variabili di ambiente dell'app contenitore consiste nel creare una nuova revisione con le modifiche necessarie.

Azure portal

1. Nel portale di Azure cercare App contenitore e quindi selezionare l'app.

   

2. Nel menu a sinistra dell'app selezionare Revisioni e repliche > Creare nuova revisione

   

3. È quindi necessario modificare l'immagine del contenitore esistente:

   

4. Nella sezione Variabili di ambiente è possibile aggiungere nuove variabili di ambiente facendo clic su Aggiungi.

5. Impostare quindi il nome della variabile di ambiente e l'origine, che può essere un riferimento a un segreto.

   

   1. Se si seleziona Origine come manuale, è possibile immettere manualmente il valore della variabile di ambiente.

      

Interfaccia della riga di comando di Azure

È possibile aggiornare l'app contenitore con il comando az containerapp update.

Questo esempio crea una variabile di ambiente con un valore manuale (che non fa riferimento a un segreto). Sostituire i <SEGNAPOSTO> con i valori.

az containerapp update \
    -n <APP NAME> 
    -g <RESOURCE_GROUP_NAME> 
    --set-env-vars <VAR_NAME>=<VAR_VALUE>

Se si vogliono creare più variabili di ambiente, è possibile inserire valori separati da spazi nel formato "key=value".

Per fare riferimento a un segreto, è necessario assicurarsi che il segreto sia già stato creato. Vedere Gestire i segreti. È possibile usare il nome del segreto e passarlo al campo del valore, ma a partire da secretref:, vedere l'esempio seguente:

az containerapp update \
    -n <APP NAME> 
    -g <RESOURCE_GROUP_NAME> 
    --set-env-vars <VAR_NAME>=secretref:<SECRET_NAME>

PowerShell

Analogamente alle operazioni da eseguire durante la creazione di una nuova app contenitore, è necessario creare un oggetto denominato EnvironmentVar, contenuto all'interno di un oggetto Container. Questo Container viene quindi usato con il cmdlet di PowerShell New-AzContainerApp.

In questo cmdlet è sufficiente passare l'oggetto modello definito in precedenza come descritto nella sezione Configurare le variabili di ambiente.

Update-AzContainerApp -TemplateContainer $containerTemplate

Variabili di ambiente predefinite

App contenitore di Azure aggiunge automaticamente variabili di ambiente che le app e i processi possono usare per ottenere i metadati della piattaforma in fase di esecuzione.

App

Per le app contenitore sono disponibili le variabili seguenti:

Nome variabile	Descrizione	Valore di esempio
CONTAINER_APP_NAME	Nome dell’app contenitore.	my-containerapp
CONTAINER_APP_REVISION	Nome della revisione dell'app contenitore.	my-containerapp--20mh1s9
CONTAINER_APP_HOSTNAME	Nome host specifico della revisione dell'app contenitore.	my-containerapp--20mh1s9.<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_ENV_DNS_SUFFIX	Suffisso DNS per l'ambiente di App contenitore. Per ottenere il nome di dominio completo (FQDN) dell'app, aggiungere il nome dell'app al suffisso DNS nel formato $CONTAINER_APP_NAME.$CONTAINER_APP_ENV_DNS_SUFFIX.	<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_PORT	Porta di destinazione dell'app contenitore.	8080
CONTAINER_APP_REPLICA_NAME	Nome della replica dell'app contenitore.	my-containerapp--20mh1s9-86c8c4b497-zx9bq

Processi

Per i processi di App contenitore sono disponibili le variabili seguenti:

Nome variabile	Descrizione	Valore di esempio
CONTAINER_APP_JOB_NAME	Il nome del processo.	my-job
CONTAINER_APP_JOB_EXECUTION_NAME	Nome dell'esecuzione del processo.	my-job-iwpi4il

Passaggi successivi

• Gestione revisioni