Quickstart: Azure-app-configuratie gebruiken in Azure Container Apps

Artikel
2025-04-10

In deze quickstart gebruikt u Azure App Configuration in een app die wordt uitgevoerd in Azure Container Apps. Op deze manier kunt u de opslag en het beheer van de configuratie van uw apps in Container Apps centraliseren. Deze quickstart maakt gebruik van de ASP.NET Core-app die is gemaakt in quickstart: Een ASP.NET Core-app maken met App Configuration. U implementeert de app in een container en implementeert deze in Azure Container Apps. Voltooi de quickstart voordat u doorgaat.

Tip

Tijdens het volgen van deze quickstart registreert u bij voorkeur alle nieuwe resources binnen één resourcegroep, zodat u ze allemaal op één plaats opnieuw kunt groeperen en ze later sneller kunt verwijderen als u ze niet meer nodig hebt.

Vereisten

Een toepassing die gebruikmaakt van een App Configuration-opslag. Als u nog geen exemplaar hebt, maakt u een exemplaar met behulp van de quickstart: Een ASP.NET Core-app maken met App Configuration.
Een Azure Container Apps-exemplaar. Als u nog geen exemplaar hebt, maakt u een exemplaar met behulp van Azure Portal of de CLI.
Docker Desktop
De Azure CLI

Maak verbinding van Azure App-configuratie met de container-app

Navigeer in Azure Portal naar uw container-app-exemplaar.
Volg de Service Connector-quickstart voor Azure Container Apps om een serviceverbinding te maken voor uw App Configuration-store met behulp van de volgende instellingen.
1. Op het tabblad Basis:
  - Selecteer App Configuration onder Servicetype
  - Selecteer onder App Configuration uw App Configuration-winkel.
2. Op het tabblad Verificatie :
  - Selecteer het door het systeem toegewezen verificatietype voor beheerde identiteit
  - Het menu Geavanceerd uitvouwen
  - Wijs uw identiteit toe aan de rol App Configuration Data Reader
  - Onder Configuratie-informatie vindt u een omgevingsvariabele met de naam AZURE_APPCONFIGURATION_ENDPOINT. Selecteer het potloodpictogram aan de rechterkant en bewerk de naam van de omgevingsvariabele zodat deze overeenkomt met de naam van de variabele in uw toepassing waaruit u uw App Configuration-eindpunt laadt. Als u uw toepassing hebt gemaakt na de ASP.NET Core-quickstart, is Endpoints:AppConfigurationde naam van uw variabele. Wanneer u de naam van de variabele bewerkt, vervangt u de dubbele punt door dubbele onderstrepingstekens, zodat het Endpoints__AppConfiguration wordt. Als u met een andere toepassing werkt, voert u de naam van de bijbehorende omgevingsvariabele in en selecteert u Gereed.
3. Gebruik standaardwaarden voor alles anders.
Wanneer de verbinding wordt gemaakt, wordt er een omgevingsvariabele met de naam Endpoints__AppConfiguration toegevoegd aan de container van uw Container App-resource. De waarde is een verwijzing naar het container-app-geheim, het eindpunt van uw App Configuration-archief.

Een container bouwen

Voer de opdracht dotnet publish uit om de app te bouwen in de releasemodus en maak de assets in de gepubliceerde map.
```
dotnet publish -c Release -o published
```
Maak een bestand met de naam Dockerfile in de map met uw .csproj-bestand, open het in een teksteditor en voer de volgende inhoud in. Een Dockerfile is een tekstbestand dat geen extensie heeft en wordt gebruikt om een containerimage te maken.
```
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS runtime
WORKDIR /app
COPY published/ ./
ENTRYPOINT ["dotnet", "TestAppConfig.dll"]
```
Bouw de container door de volgende opdracht uit te voeren.
```
docker build --tag aspnetapp .
```

Een Azure Container Registry-exemplaar maken

Een ACR (Azure Container Registry) maken. Met ACR kunt u containerinstallatiekopieën bouwen, opslaan en beheren.

Portal
Azure-CLI

Volg de quickstart voor Azure Container Registry om het containerregister te maken.
Zodra de implementatie is voltooid, opent u uw ACR-exemplaar en selecteert u in het linkermenu Instellingentoegangssleutels>.
Noteer de waarde van de aanmeldingsserver die op deze pagina wordt vermeld. U gebruikt deze informatie in een latere stap.
Schakel Admin gebruiker naar Ingeschakeld. Met deze optie kunt u de ACR verbinden met Azure Container Apps met beheerdersreferenties. U kunt deze ook uitgeschakeld laten en de container-app configureren om afbeeldingen uit de registry te trekken met een beheerde identiteit.

Maak een ACR-exemplaar met behulp van de volgende opdracht. Er wordt een basislaagregister gemaakt met de naam myregistry met beheerdersgebruiker ingeschakeld waarmee de container-app verbinding kan maken met het register met behulp van beheerdersreferenties. Voor meer informatie, zie Azure Container Registry-handleiding.
```
az acr create 
--resource-group AppConfigTestResources \
--name myregistry \
--admin-enabled true \
--sku Basic
```
Noteer in de uitvoer van de opdracht de ACR-aanmeldingsserverwaarde die hierna loginServerwordt vermeld.
Haal de ACR-gebruikersnaam en het wachtwoord op door uit te voeren az acr credential show --name myregistry. U hebt deze waarden later nodig.

De installatiekopie naar Azure Container Registry pushen

Duw het Docker-image naar de eerder aangemaakte ACR.

Voer de opdracht az acr login uit om u aan te melden bij het register.
```
az acr login --name myregistry
```
Het commando geeft Login Succeeded terug zodra de aanmelding is geslaagd.
Gebruik docker tag om de image van de juiste details te voorzien.
```
docker tag aspnetapp myregistry.azurecr.io/aspnetapp:v1
```
Tip

Als u de lijst met uw bestaande docker-images en -tags wilt bekijken, voert u docker image ls uit. In dit scenario ziet u ten minste twee afbeeldingen: aspnetapp en myregistry.azurecr.io/aspnetapp.
Gebruik docker push om de afbeelding naar de container registry te pushen. In dit voorbeeld wordt de repository aspnetapp in ACR aangemaakt, die de aspnetapp-afbeelding bevat. Vervang in het onderstaande voorbeeld de tijdelijke aanduidingen <login-server, <image-name> en <tag> door de waarde van de ACR-aanmeldingsserver, de naam van het image en de tag van het image.

Methode:
```
docker push <login-server>/<image-name>:<tag>
```
Voorbeeld:
```
docker push myregistry.azurecr.io/aspnetapp:v1
```
Open uw Azure Container Registry in Azure Portal en controleer of u onder Opslagplaatsen uw nieuwe opslagplaats kunt zien.

Uw containerinstallatiekopieën toevoegen aan Azure Container Apps

Werk uw container-app bij om de containerafbeelding uit uw ACR te laden.

Open uw Azure Container Apps-exemplaar in Azure Portal.
Selecteer Containers in het linkermenu onder Toepassing.
Selecteer Bewerken en implementeren.
Klik onder Containerafbeelding op de naam van de bestaande containerafbeelding.

Werk de volgende instellingen bij:

Instelling	Voorgestelde waarde	Beschrijving
Bron afbeelding	Azure Container Registry	Selecteer Azure Container Registry als de bron van uw installatiekopieën.
Verificatie	Beheerdersgegevens	Gebruik de optie voor admin-gebruikersreferenties die eerder in het containerregister is ingeschakeld. Als u de gebruiker met beheerdersrechten niet hebt ingeschakeld, maar geconfigureerd voor het gebruik van een beheerde identiteit, moet u de afbeelding en tag handmatig invoeren in het formulier.
Registratie	myregistry.azurecr.io	Selecteer het Azure Container Registry dat u eerder hebt gemaakt.
Afbeelding	aspnetapp	Selecteer de Docker-image die u eerder hebt gemaakt en naar ACR hebt gepusht.
Afbeeldingstag	v1	Selecteer uw afbeeldingslabel uit de lijst.

Selecteer Opslaan en vervolgens Maken om de update naar Azure Container App te implementeren.

Blader naar de URL van de Azure Container App

Ga in Azure Portal in het Azure Container Apps-exemplaar naar het tabblad Overzicht en open de toepassings-URL.

De webpagina ziet er als volgt uit:

Schermopname van een internetbrowser met de app die wordt uitgevoerd.

Middelen opruimen

Als u de resources die in dit artikel zijn gemaakt niet wilt blijven gebruiken, verwijdert u de resourcegroep die u hier hebt gemaakt om kosten te voorkomen.

Belangrijk

Het verwijderen van een resourcegroep kan niet ongedaan worden gemaakt. De resourcegroep en alle resources daarin worden permanent verwijderd. Zorg ervoor dat u niet per ongeluk de verkeerde resourcegroep of hulpbronnen verwijdert. Als u de resources voor dit artikel in een resourcegroep hebt gemaakt die andere resources bevat die u wilt behouden, moet u elke resource afzonderlijk verwijderen uit het deelvenster in plaats van dat u de resourcegroep verwijdert.

Meld u aan bij de Azure-portal en selecteer Resourcegroepen.
Voer de naam van de resourcegroep in het vak Filteren op naam in.
Selecteer in de resultatenlijst de resourcegroepnaam om een overzicht te bekijken.
Selecteer Resourcegroep verwijderen.
U wordt gevraagd om het verwijderen van de resourcegroep te bevestigen. Voer de naam van de resourcegroep in ter bevestiging en selecteer Verwijderen.

Na enkele ogenblikken worden de resourcegroep en alle bijbehorende resources verwijderd.

In deze snelstart, gaat u het volgende doen:

Verbonden Azure-app-configuratie met Azure Container Apps
Met App Configuration-instellingen is Docker gebruikt om een containerimage te maken van een ASP.NET Core-app.
Een Azure Container Registry-instantie gemaakt
De image naar de Azure Container Registry-instantie gepusht.
Containerimage toegevoegd aan Azure Container Apps
Gebladerd naar de URL van het Azure Container Apps-exemplaar dat is bijgewerkt met de instellingen die u hebt geconfigureerd in de App Configuration-opslag.

Met de beheerde identiteit kan één Azure-resource toegang krijgen tot een andere resource zonder dat u geheimen onderhoudt. U kunt de toegang van Container Apps naar andere Azure-resources stroomlijnen. Zie voor meer informatie hoe u toegang krijgen tot App Configuration met behulp van de beheerde identiteit en hoe u toegang krijgen tot Container Registry met behulp van de beheerde identiteit.

Als u wilt weten hoe u uw ASP.NET Core-web-app configureert om configuratie-instellingen dynamisch te vernieuwen, gaat u verder met de volgende zelfstudie.

Dynamische configuratie inschakelen

Delen via