Migration der Anwendungsliveansicht zum verwalteten Administrator für Spring in Azure Container Apps

Artikel
02/06/2025

Hinweis

Die Pläne Basic, Standard und Enterprise gelten ab Mitte März 2025 als veraltet und werden über einen Zeitraum von drei Jahren eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie in der Ankündigung zur Einstellung von Azure Spring Apps.

Der Plan Standardverbrauch und dediziert gilt ab dem 30. September 2024 als veraltet und wird nach sechs Monaten vollständig eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie unter Migrieren des Plans „Standardverbrauch und dediziert“ von Azure Spring Apps zu Azure Container Apps.

Dieser Artikel gilt für: ❎ Basic/Standard ✅ Enterprise

In diesem Artikel wird die Migration des API-Portals zum verwalteten Administrator für Spring in Azure Container Apps beschrieben.

Die verwaltete Komponente „Administrator für Spring“ bietet eine Verwaltungsschnittstelle für Spring Boot-Webanwendungen, die Aktuatorendpunkte verfügbar machen. Sie ähnelt der Anwendungsliveansicht und fungiert als einfaches Tool für Erkenntnisse und die Problembehandlung, um Entwicklern und Bedienern bei der Überwachung der ausgeführten Apps zu helfen.

Voraussetzungen

Eine konfigurierte Instanz des Azure Spring Apps Enterprise-Plans mit aktiviertem Anwendungskonfigurationsdienst.
Eine vorhandene Azure-Container-App. Weitere Informationen finden Sie unter Schnellstart: Bereitstellen Ihrer ersten Container-App über das Azure-Portal.
Azure-Befehlszeilenschnittstelle.

Bereitstellen des verwalteten Administrators für Spring in Azure Container Apps

Führen Sie die folgenden Schritte aus, um die Komponente bereitzustellen:

Azure portal
Azure-Befehlszeilenschnittstelle

Navigieren Sie im Azure-Portal zur Umgebung Ihrer Container-App.
Wählen Sie im Dienstmenü unter Dienste die Option Dienste aus.
Wählen Sie Konfigurierenund dann Java-Komponente aus.
Füllen Sie den Bereich Java-Komponente konfigurieren mit den folgenden Werten aus:

Eigenschaft Wert

Java-Komponententyp Administrator für Spring

Java-Komponentenname admin
Wählen Sie Weiter aus.
Wählen Sie auf der Registerkarte Überprüfen die Option Konfigurieren aus.

Eigenschaft	Wert
Java-Komponententyp	Administrator für Spring
Java-Komponentenname	admin

Verwenden Sie den folgenden Befehl, um die Java-Komponente „Administrator für Spring“ zu erstellen:

az containerapp env java-component admin-for-spring create \
    --resource-group $RESOURCE_GROUP \
    --name $JAVA_COMPONENT_NAME \
    --environment $ENVIRONMENT \
    --min-replicas 1 \
    --max-replicas 1

Verwenden Sie den folgenden Befehl, um die Java-Komponente „Administrator für Spring“ zu aktualisieren:

az containerapp env java-component admin-for-spring update \
    --resource-group $RESOURCE_GROUP \
    --name $JAVA_COMPONENT_NAME \
    --environment $ENVIRONMENT \
    --min-replicas 2 \
    --max-replicas 2

Aktualisieren der Abhängigkeit Ihrer Container-App

Um die Administratorkomponente in Ihre Container-App zu integrieren, fügen Sie der Datei pom.xml die folgende Abhängigkeit hinzu. Ersetzen Sie die Versionsnummer durch die neueste Version aus dem Maven-Repository.

<dependency>
    <groupId>de.codecentric</groupId>
    <artifactId>spring-boot-admin-starter-client</artifactId>
    <version>3.3.2</version>
</dependency>

Binden der Container-App an die Java-Komponente „Administrator für Spring“

Azure portal
Azure-Befehlszeilenschnittstelle

Führen Sie die folgenden Schritte aus, um Ihre Container-App an die Komponente zu binden:

Wechseln Sie im Azure-Portal zur Umgebung Ihrer Container-App.
Wählen Sie unter Dienste die Option Dienste aus.
Wählen Sie in der Liste Administrator aus.
Wählen Sie unter Bindungen den Namen Ihrer Container-App im Dropdown-Menü App-Name aus.
Wählen Sie die Registerkarte Überprüfen und dann Konfigurierenaus.
Navigieren Sie im Azure-Portal zu Ihrer Container-App, und kopieren Sie ihre URL zur späteren Verwendung.

Verwenden Sie den folgenden Befehl, um die Container-App zu erstellen und sie an die Komponente „Administrator für Spring“ zu binden:

az containerapp create \
    --resource-group $RESOURCE_GROUP \
    --name $APP_NAME \
    --environment $ENVIRONMENT \
    --image $IMAGE \
    --min-replicas 1 \
    --max-replicas 1 \
    --ingress external \
    --target-port 8080 \
    --bind $JAVA_COMPONENT_NAME

Zugriff auf das Admin-Dashboard

Hinweis

Der verwaltete Administrator für Spring in Azure Container Apps unterstützt keine SSO-Konfiguration (Single Sign-On). Er benötigt Azure-Rollenzuweisungen.

Damit Sie auf das Dashboard zugreifen können, muss Ihrem Konto die Microsoft.App/managedEnvironments/write-Rolle für die Ressource der verwalteten Umgebung zugewiesen sein.

Erstellen und Zuweisen einer benutzerdefinierten Rolle

Führen Sie die folgenden Schritte aus, um eine benutzerdefinierte Rolle zu erstellen und zuzuweisen:

Verwenden Sie den folgenden Befehl, um eine benutzerdefinierte Rollendefinition zu erstellen:

az role definition create --role-definition '{
    "Name": "<ROLE_NAME>",
    "IsCustom": true,
    "Description": "Access to managed Java Component dashboards in managed environments",
    "Actions": [
       "Microsoft.App/managedEnvironments/write"
    ],
    "AssignableScopes": ["/subscriptions/<SUBSCRIPTION_ID>"]
}'

Verwenden Sie den folgenden Befehl, um die benutzerdefinierte Rolle Ihrem Konto zuzuweisen:

az role assignment create \
    --assignee <USER_OR_SERVICE_PRINCIPAL_ID> \
    --role "<ROLE_NAME>" \
    --scope $ENVIRONMENT_ID

Freigeben über