Freigeben über

Schnellstart: Verwenden von Azure App Configuration in Azure Container Apps

  • Artikel

In diesem Schnellstart verwenden Sie Azure App Configuration in einer App, die in Azure Container Apps ausgeführt wird. Auf diese Weise können Sie den Speicher und die Verwaltung der Konfiguration Ihrer Apps in Container Apps zentralisieren. In dieser Schnellstartanleitung wird die in Schnellstart: Erstellen einer ASP.NET Core App mit App Configuration erstellte ASP.NET Core-App verwendet. Sie containerisieren die App und stellen sie in Azure Container Apps bereit. Schließen Sie die Schnellstartanleitung ab, bevor Sie fortfahren.

Tipp

Registrieren Sie bei der Durchführung dieses Schnellstarts möglichst alle neuen Ressourcen in einer einzigen Ressourcengruppe, damit Sie sie später alle an einem Ort zusammenfassen und schneller löschen können, wenn Sie sie nicht mehr benötigen.

Voraussetzungen

Azure App Configuration mit der Container-App verbinden

  1. Navigieren Sie im Azure-Portal zu Ihrer Container Apps-Instanz.

  2. Befolgen Sie die Anleitung im Schnellstart zum Dienstconnector für Azure Container Apps, um mithilfe der folgenden Einstellungen eine Dienstverbindung mit Ihrem App Configuration-Speicher zu erstellen.

    1. Auf der Registerkarte Grundlagen:

      • Wählen Sie unter Diensttyp die Option App Configuration aus.

      • Wählen Sie unter App Configuration Ihren App Configuration-Speicher aus.

        Screenshot der Azure-Plattform mit einem Formular im Menü „Dienstconnector“ in einer Container-App.

    2. Auf der Registerkarte Authentifizierung:

      • Wählen Sie als Authentifizierungstyp Systemseitig zugewiesene verwaltete Identität aus.
      • Erweitern Sie das Menü Erweitert.
      • Zuweisen der Rolle App Configuration-Datenleser zu Ihrer Identität
      • Unter Konfigurationsinformationen finden Sie eine Umgebungsvariable namens AZURE_APPCONFIGURATION_ENDPOINT. Wählen Sie auf der rechten Seite das Stiftsymbol aus, und passen Sie den Namen der Umgebungsvariable an den Variablennamen in Ihrer Anwendung an, aus der Sie den App Configuration-Endpunkt laden. Wenn Sie Ihre Anwendung anhand des ASP.NET Core-Schnellstarts erstellt haben, lautet der Variablenname Endpoints:AppConfiguration. Ersetzen Sie beim Bearbeiten des Variablennamens den Doppelpunkt durch doppelte Unterstriche, sodass er Endpoints__AppConfiguration lautet. Wenn Sie mit einer anderen Anwendung arbeiten, geben Sie den entsprechenden Namen der Umgebungsvariable ein, und wählen Sie dann Fertig aus.

    3. Verwenden Sie für alles andere die Standardwerte.

    Beim Erstellen der Verbindung wird dem Container Ihrer Container-App-Ressource die Umgebungsvariable Endpoints__AppConfiguration hinzugefügt. Ihr Wert ist ein Verweis auf das Geheimnis der Container-App, den Endpunkt Ihres App Configuration-Speichers.

Erstellen eines Containers

  1. Führen Sie den Befehl dotnet publish aus, um die App im Releasemodus und die Ressourcen im Ordner Veröffentlicht zu erstellen.

    dotnet publish -c Release -o published

  2. Erstellen Sie eine Datei mit dem Namen Dockerfile im Verzeichnis, das Ihre .csproj-Datei enthält. Öffnen Sie sie in einem Text-Editor und geben Sie den folgenden Inhalt ein. Eine Dockerfile-Datei ist eine Textdatei ohne Dateierweiterung, die zum Erstellen eines Containerimages verwendet wird.

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

  3. Erstellen Sie den Container, indem Sie den folgenden Befehl ausführen.

    docker build --tag aspnetapp .

Erstellen einer Azure Container Registry-Instanz

Sie erstellen eine Azure Container Registry(ACR)-Instanz. ACR ermöglicht es Ihnen, Containerimages zu erstellen, zu speichern und zu verwalten.

  1. Befolgen Sie zum Erstellen der Containerregistrierung die Schnellstartanleitung Azure Container Registry.
  2. Öffnen Sie nach Abschluss der Bereitstellung Ihre ACR-Instanz und wählen Sie im linken Menü Einstellungen > Zugriffsschlüssel aus.
  3. Notieren Sie sich den auf dieser Seite aufgeführten Anmeldeserverwert. Diese Information wird in einem späteren Schritt verwendet.
  4. Ändern Sie Admin Benutzer zu Aktiviert. Mit dieser Option können Sie die ACR mithilfe von Administrator-Benutzeranmeldeinformationen mit Azure Container Apps verbinden. Alternativ können Sie sie deaktiviert lassen und die Container-App so konfigurieren, dass Images mit einer verwalteten Identität aus der Registrierung abgerufen werden.

Übertragen des Images an Azure Container Registry per Push

Pushen Sie das Docker-Image an die zuvor erstellte ACR.

  1. Verwenden Sie den Befehl az acr login, um sich bei der Registrierung anzumelden.

    az acr login --name myregistry

    Der Befehl gibt Login Succeeded zurück, sobald die Anmeldung erfolgreich war.

  2. Verwenden Sie docker tag, um die richtigen Details für das Image zu markieren.

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

    Tipp

    Führen Sie docker image ls aus, um die Liste Ihrer vorhandenen Docker-Images und -Tags zu überprüfen. In diesem Szenario sollten mindestens zwei Images angezeigt werden: aspnetapp und myregistry.azurecr.io/aspnetapp.

  3. Verwenden Sie docker push, um das Image in die Containerregistrierung zu pushen. In diesem Beispiel wird das Repository aspnetapp in ACR mit dem Image aspnetapp erstellt. Ersetzen Sie im folgenden Beispiel die Platzhalter <login-server, <image-name> und <tag> durch den Anmeldeserverwert des ACR, den Imagenamen und das Imagetag.

    Methode:

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

    Beispiel:

    docker push myregistry.azurecr.io/aspnetapp:v1

  4. Öffnen Sie Ihre Azure Container Registry im Azure-Portal, und vergewissern Sie sich, dass Sie unter Repositorys Ihr neues Repository sehen können.

    Screenshot der Azure-Plattform mit einem Repository in Azure Container Registries.

Hinzufügen Ihres Containerimages zu Azure Container Apps

Aktualisieren Sie Ihre Container-App, um das Containerimage aus Ihrem ACR zu laden.

  1. Öffnen Sie im Azure-Portal Ihre Azure Container Apps-Instanz.

  2. Wählen Sie im linken Menü unter AnwendungContainer aus.

  3. Wählen Sie Bearbeiten und bereitstellen aus.

  4. Klicken Sie unter Containerimage auf den Namen des vorhandenen Containerimages.

  5. Aktualisieren Sie die folgenden Einstellungen:

    Einstellung Vorgeschlagener Wert BESCHREIBUNG
    Imagequelle Azure Container Registry Wählen Sie Azure Container Registry als Imagequelle aus.
    Authentifizierung Administrator-Anmeldeinformationen Verwenden Sie die Option Administrator-Benutzeranmeldeinformationen, die zuvor in der Containerregistrierung aktiviert wurde. Wenn Sie den Administratorbenutzer nicht aktiviert haben sondern die Verwendung einer verwalteten Identität konfiguriert haben, müssen Sie das Image und das Tag manuell in das Formular eingeben.
    Registrierung myregistry.azurecr.io Wählen Sie die zuvor erstellte Azure Container Registry aus.
    Image aspnetapp Wählen Sie das Docker-Image aus, das Sie zuvor erstellt und an ACR gepusht haben.
    Imagetag v1 Wählen Sie Ihren Image-Tag aus der Liste aus.

  6. Klicken Sie auf Speichern und dann auf Erstellen, um das Update in Azure Container App bereitzustellen.

Navigieren Sie zur URL der Azure Container-App.

Navigieren Sie im Azure-Portal in der Azure Container Apps-Instanz zur Registerkarte Übersicht und öffnen Sie die Anwendungs-URL.

Die Webseite sieht folgendermaßen aus:

Screenshot eines Internetbrowsers, in dem die App ausgeführt wird.

Bereinigen von Ressourcen

Wenn Sie die in diesem Artikel erstellten Ressourcen nicht mehr verwenden möchten, löschen Sie die erstellte Ressourcengruppe, um Kosten zu vermeiden.

Wichtig

Das Löschen einer Ressourcengruppe kann nicht rückgängig gemacht werden. Die Ressourcengruppe und alle darin enthaltenen Ressourcen werden unwiderruflich gelöscht. Achten Sie daher darauf, dass Sie nicht versehentlich die falsche Ressourcengruppe oder die falschen Ressourcen löschen. Falls Sie die Ressourcen für diesen Artikel in einer Ressourcengruppe erstellt haben, die andere beizubehaltende Ressourcen enthält, löschen Sie die Ressourcen einzeln über den entsprechenden Bereich, statt die Ressourcengruppe zu löschen.

  1. Melden Sie sich beim Azure-Portal an, und klicken Sie auf Ressourcengruppen.
  2. Geben Sie im Feld Nach Name filtern den Namen Ihrer Ressourcengruppe ein.
  3. Wählen Sie in der Ergebnisliste den Ressourcengruppennamen aus, um eine Übersicht anzuzeigen.
  4. Wählen Sie die Option Ressourcengruppe löschen.
  5. Sie werden aufgefordert, das Löschen der Ressourcengruppe zu bestätigen. Geben Sie zur Bestätigung den Namen Ihrer Ressourcengruppe ein, und klicken Sie auf Löschen.

Daraufhin werden die Ressourcengruppe und alle darin enthaltenen Ressourcen gelöscht.

Zugehöriger Inhalt

In dieser Schnellstartanleitung führen Sie die folgenden Schritte aus:

  • Azure App Configuration mit Azure Container Apps verbunden
  • Docker zum Erstellen eines Containerimages aus einer ASP.NET Core-App mit App Configuration Einstellungen verwendet
  • Eine Azure Container Registry-Instanz erstellt
  • Das Image an die Azure Container Registry-Instanz gepusht
  • Das Containerimage zu Azure Container Apps hinzugefügt
  • Zur URL der Azure Container Apps-Instanz, die mit den Einstellungen aktualisiert wurde, die Sie in Ihrem App Configuration Store konfiguriert haben, navigiert.

Mit der verwalteten Identität kann eine Azure-Ressource auf eine andere zugreifen, ohne Geheimnisse zu verwalten. Sie können den Zugriff von Container Apps auf andere Azure-Ressourcen optimieren. Weitere Informationen finden Sie unter Zugreifen auf App Configuration mithilfe einer verwalteten Identität und Zugreifen auf Container Registry mithilfe einer verwalteten Identität.

Fahren Sie mit dem nächsten Tutorial fort, um zu erfahren, wie Sie Ihre ASP.NET Core-Web-App für das dynamische Aktualisieren der Konfigurationseinstellungen konfigurieren:

Tutorial: Verwenden der dynamischen Konfiguration in einer .NET Framework-App