Zarządzanie zmiennymi środowiskowymi w usłudze Azure Container Apps

W usłudze Azure Container Apps możesz ustawić zmienne środowiskowe środowiska uruchomieniowego. Te zmienne można ustawić jako wpisy ręczne lub odwołania do wpisów tajnych. Te zmienne środowiskowe są ładowane do aplikacji kontenera podczas wykonywania.

Skonfiguruj zmienne środowiskowe

Zmienne środowiskowe można skonfigurować podczas tworzenia aplikacji kontenera lub nowszej, tworząc nową poprawkę.

Uwaga

Aby uniknąć nieporozumień, nie zaleca się duplikowania zmiennych środowiskowych. Jeśli wiele zmiennych środowiskowych ma taką samą nazwę, ostatnia z listy ma zastosowanie.

Witryna Azure Portal

Jeśli tworzysz nową aplikację kontenera za pośrednictwem witryny Azure Portal, możesz skonfigurować zmienne środowiskowe w sekcji Kontener:

Interfejs wiersza polecenia platformy Azure

Aplikację kontenera można utworzyć przy użyciu zmiennych środowiskowych za pomocą polecenia az containerapp create , przekazując zmienne środowiskowe jako wpisy rozdzielone spacją "key=value" przy użyciu parametru --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

Jeśli chcesz odwołać się do wpisu tajnego, musisz upewnić się, że wpis tajny, do którego chcesz się odwołać, został już utworzony, zobacz Zarządzanie wpisami tajnymi. Możesz użyć nazwy wpisu tajnego i przekazać ją do pola wartości, ale zaczynając od secretref:

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

Program PowerShell

Jeśli chcesz użyć programu PowerShell, najpierw utwórz obiekt w pamięci o nazwie EnvironmentVar przy użyciu polecenia cmdlet New-AzContainerAppEnvironmentVarObject programu PowerShell.

Aby użyć tego polecenia cmdlet, należy przekazać nazwę zmiennej środowiskowej przy użyciu parametru i wartości, odpowiednio przy użyciu -Name parametru -Value .

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

Jeśli chcesz odwołać się do wpisu tajnego, musisz upewnić się, że wpis tajny, do którego chcesz się odwołać, został już utworzony, zobacz Zarządzanie wpisami tajnymi. Możesz użyć nazwy wpisu tajnego i przekazać ją do parametru -SecretRef :

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

Następnie należy utworzyć inny obiekt w pamięci o nazwie Container przy użyciu polecenia cmdlet New-AzContainerAppTemplateObject programu PowerShell.

W tym poleceniu cmdlet należy przekazać nazwę obrazu kontenera (a nie aplikację kontenera!) przy użyciu parametru -Name , w pełni kwalifikowaną nazwę obrazu przy użyciu -Image parametru i odwołać się do obiektu środowiskowego zdefiniowanego wcześniej w zmiennej $envVar.

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

Uwaga

Należy pamiętać, że istnieją inne ustawienia, które mogą być konieczne do zdefiniowania wewnątrz obiektu szablonu, aby uniknąć zastępowania ich, takich jak zasoby, instalacja woluminów itp. Zapoznaj się z pełną dokumentacją dotyczącą tego szablonu w obszarze New-AzContainerAppTemplateObject.

Na koniec możesz zaktualizować aplikację kontenera na podstawie nowego obiektu szablonu utworzonego przy użyciu polecenia cmdlet Programu PowerShell Update-AzContainerApp .

W tym ostatnim poleceniu cmdlet wystarczy przekazać obiekt szablonu zdefiniowany w $containerTemplate zmiennej w poprzednim kroku przy użyciu parametru -TemplateContainer .

Update-AzContainerApp -TemplateContainer $containerTemplate

Dodawanie zmiennych środowiskowych w istniejących aplikacjach kontenerów

Po utworzeniu aplikacji kontenera jedynym sposobem zaktualizowania zmiennych środowiskowych aplikacji kontenera jest utworzenie nowej poprawki z wymaganymi zmianami.

Witryna Azure Portal

1. W witrynie Azure Portal wyszukaj pozycję Container Apps, a następnie wybierz aplikację.

   

2. W menu po lewej stronie aplikacji wybierz pozycję Poprawki i repliki > Utwórz nową poprawkę

   

3. Następnie musisz edytować bieżący istniejący obraz kontenera:

   

4. W sekcji Zmienne środowiskowe możesz dodać nowe zmienne środowiskowe, klikając pozycję Dodaj.

5. Następnie ustaw nazwę zmiennej środowiskowej i źródło (może to być odwołanie do wpisu tajnego).

   

   1. Jeśli wybierzesz opcję Źródło jako ręczne, możesz ręcznie wprowadzić wartość zmiennej środowiskowej.

      

Interfejs wiersza polecenia platformy Azure

Aplikację kontenera można zaktualizować za pomocą polecenia az containerapp update .

W tym przykładzie jest tworzona zmienna środowiskowa z wartością ręczną (nie odwołującą się do wpisu tajnego). Zastąp <symbole> ZASTĘPCZE wartościami.

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

Jeśli chcesz utworzyć wiele zmiennych środowiskowych, możesz wstawić wartości rozdzielane spacjami w formacie "key=value".

Jeśli chcesz odwołać się do wpisu tajnego, musisz upewnić się, że wpis tajny, do którego chcesz się odwołać, został już utworzony, zobacz Zarządzanie wpisami tajnymi. Możesz użyć nazwy wpisu tajnego i przekazać ją do pola wartości, ale zaczynając od secretref:, zobacz następujący przykład:

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

Program PowerShell

Podobnie jak w przypadku tworzenia nowej aplikacji kontenera, należy utworzyć obiekt o nazwie EnvironmentVar, który znajduje się w kontenerze. Ten kontener jest następnie używany z poleceniem cmdlet Programu PowerShell New-AzContainerApp .

W tym poleceniu cmdlet wystarczy przekazać wcześniej zdefiniowany obiekt szablonu zgodnie z opisem w sekcji Konfigurowanie zmiennych środowiskowych.

Update-AzContainerApp -TemplateContainer $containerTemplate

Wbudowane zmienne środowiskowe

Usługa Azure Container Apps automatycznie dodaje zmienne środowiskowe, których aplikacje i zadania mogą używać do uzyskiwania metadanych platformy w czasie wykonywania.

Aplikacje

Następujące zmienne są dostępne dla aplikacji kontenerów:

Nazwa zmiennej	opis	Przykładowa wartość
CONTAINER_APP_NAME	Nazwa aplikacji kontenera.	my-containerapp
CONTAINER_APP_REVISION	Nazwa poprawki aplikacji kontenera.	my-containerapp--20mh1s9
CONTAINER_APP_HOSTNAME	Nazwa hosta specyficzna dla wersji aplikacji kontenera.	my-containerapp--20mh1s9.<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_ENV_DNS_SUFFIX	Sufiks DNS dla środowiska Container Apps. Aby uzyskać w pełni kwalifikowaną nazwę domeny (FQDN) aplikacji, dołącz nazwę aplikacji do sufiksu DNS w formacie $CONTAINER_APP_NAME.$CONTAINER_APP_ENV_DNS_SUFFIX.	<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_PORT	Docelowy port aplikacji kontenera.	8080
CONTAINER_APP_REPLICA_NAME	Nazwa repliki aplikacji kontenera.	my-containerapp--20mh1s9-86c8c4b497-zx9bq

Stanowiska

Następujące zmienne są dostępne dla zadań usługi Container Apps:

Nazwa zmiennej	opis	Przykładowa wartość
CONTAINER_APP_JOB_NAME	Nazwa zadania.	my-job
CONTAINER_APP_JOB_EXECUTION_NAME	Nazwa wykonania zadania.	my-job-iwpi4il

Następne kroki

• Zarządzanie poprawkami