Delen via

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

  • Artikel

In deze quickstart gebruikt u Azure-app Configuratie 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

Verbinding maken Azure-app Configuratie met de container-app

  1. Navigeer in Azure Portal naar uw container-app-exemplaar.

  2. Volg de quickstart serviceconnector voor Azure Container Apps om een serviceverbinding te maken voor uw App Configuration-archief met behulp van de volgende instellingen.

    1. Op het tabblad Basis:

      • Selecteer App Configuration onder Servicetype

      • Selecteer onder App Configuration uw App Configuration-archief.

        Schermopname van het Azure-platform met een formulier in het menu Service Connector in een container-app.

    2. Op het tabblad Verificatie :

      • Selecteer het door het systeem toegewezen verificatietype voor beheerde identiteit
      • Het menu Geavanceerd uitvouwen
      • Uw identiteit toewijzen 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 deze wordt Endpoints__AppConfiguration. 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

  1. 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

  2. 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 die wordt gebruikt om een containerinstallatiekopieën te maken.

    FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS runtime
WORKDIR /app
COPY published/ ./
ENTRYPOINT ["dotnet", "TestAppConfig.dll"]

  3. 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.

  1. Volg de quickstart voor Azure Container Registry om het containerregister te maken.
  2. Zodra de implementatie is voltooid, opent u uw ACR-exemplaar en selecteert u in het linkermenu Instellingentoegangssleutels>.
  3. Noteer de waarde van de aanmeldingsserver die op deze pagina wordt vermeld. U gebruikt deze informatie in een latere stap.
  4. Schakel over naar Gebruiker met beheerdersrechten in 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 installatiekopieën uit het register op te halen met een beheerde identiteit.

De installatiekopie naar Azure Container Registry pushen

Push de Docker-installatiekopieën naar de eerder gemaakte ACR.

  1. Voer de opdracht az acr login uit om u aan te melden bij het register.

    az acr login --name myregistry

    De opdracht wordt geretourneerd Login Succeeded zodra de aanmelding is geslaagd.

  2. Gebruik docker-tag om de juiste details van de installatiekopieën te taggen.

    docker tag aspnetapp myregistry.azurecr.io/aspnetapp:v1

    Tip

    Als u de lijst met uw bestaande Docker-installatiekopieën en -tags wilt bekijken, voert u uit docker image ls. In dit scenario ziet u ten minste twee afbeeldingen: aspnetapp en myregistry.azurecr.io/aspnetapp.

  3. Gebruik docker-push om de installatiekopieën naar het containerregister te pushen. In dit voorbeeld wordt de aspnetapp-opslagplaats gemaakt in ACR die de aspnetapp installatiekopie bevat. Vervang in het onderstaande voorbeeld de tijdelijke aanduidingen en <tag> door de waarde van de aanmeldingsserver <login-server<image-name> van ACR, de naam van de installatiekopieën en de tag van de installatiekopieën.

    Methode:

    docker push <login-server>/<image-name>:<tag>

    Voorbeeld:

    docker push myregistry.azurecr.io/aspnetapp:v1

  4. Open uw Azure Container Registry in Azure Portal en controleer of u onder Opslagplaatsen uw nieuwe opslagplaats kunt zien.

    Schermopname van het Azure-platform met een opslagplaats in Azure Container-registers.

Uw containerinstallatiekopieën toevoegen aan Azure Container Apps

Werk uw container-app bij om de containerinstallatiekopieën van uw ACR te laden.

  1. Open uw Azure Container Apps-exemplaar in Azure Portal.

  2. Selecteer Containers in het linkermenu onder Toepassing.

  3. Selecteer Bewerken en implementeren.

  4. Klik onder Containerinstallatiekopieën op de naam van de bestaande containerinstallatiekopieën.

  5. 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 Beheerdersreferenties Gebruik de optie gebruikersreferenties voor beheerders die eerder in het containerregister zijn 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.
    Register myregistry.azurecr.io Selecteer het Azure Container Registry dat u eerder hebt gemaakt.
    Afbeelding aspnetapp Selecteer de docker-installatiekopieën die u eerder hebt gemaakt en naar ACR gepusht.
    Afbeeldingstag v1 Selecteer uw afbeeldingstag in de lijst.

  6. 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.

Resources opschonen

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 resources 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.

  1. Meld u aan bij de Azure-portal en selecteer Resourcegroepen.
  2. Voer de naam van de resourcegroep in het vak Filteren op naam in.
  3. Selecteer in de resultatenlijst de resourcegroepnaam om een overzicht te bekijken.
  4. Selecteer Resourcegroep verwijderen.
  5. 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.

Gerelateerde inhoud

In deze snelstart, gaat u het volgende doen:

  • Verbonden Azure-app-configuratie met Azure Container Apps
  • Docker gebruikt om een containerinstallatiekopieën te bouwen vanuit een ASP.NET Core-app met App Configuration-instellingen
  • Een Azure Container Registry-exemplaar gemaakt
  • De installatiekopieën naar de Azure Container Registry-instantie gepusht
  • De containerinstallatiekopieën toegevoegd aan Azure Container Apps
  • Bladerde naar de URL van het Azure Container Apps-exemplaar dat is bijgewerkt met de instellingen die u hebt geconfigureerd in uw App Configuration-archief.

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