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.

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

Screenshot della pagina di creazione dell'app contenitore.

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.

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

    Screenshot della barra di ricerca del portale di Azure con App contenitore tra i risultati.

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

    Screenshot della pagina di creazione revisione dell'app contenitore.

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

    Screenshot della pagina delle impostazioni dell'immagine del contenitore in Revisione app contenitore.

  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.

    Screenshot della sezione delle impostazioni ambiente dell'immagine del contenitore nella revisione app contenitore.

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

      Screenshot della sezione delle impostazioni ambiente dell'immagine del contenitore nella revisione app contenitore con l'origine di uno degli ambienti selezionata come Manuale.

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