Migrer l’affichage en direct de l’application vers l’Administration gérée pour Spring dans Azure Container Apps

Article
02/07/2025

Remarque

Les plans Essentiel, Standard et Entreprise seront déconseillés à compter de la mi-mars 2025, avec une période de mise hors service de 3 ans. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez l’annonce de mise hors service d’Azure Spring Apps.

Le plan de consommation standard et dédiée sera déconseillé à compter du 30 septembre 2024, avec un arrêt complet après six mois. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez Migrer le plan de consommation standard et dédiée Azure Spring Apps vers Azure Container Apps.

Cet article s’applique à : ❎ Essentiel/Standard ✅ Entreprise

Cet article explique comment migrer le portail d’API vers l’Administration gérée pour Spring dans Azure Container Apps.

Le composant d’administration gérée pour Spring fournit une interface d’administration pour les applications web Spring Boot qui exposent des points de terminaison d’actionneur. Il est similaire à l’application d’affichage en direct, agissant comme un outil léger d’insights et de résolution des problèmes pour aider les développeurs et les opérateurs à surveiller les applications en cours d’exécution.

Prérequis

Une instance configurée de plan d’entreprise Azure Spring Apps, dans laquelle est activé le service de configuration des applications.
Une application conteneur Azure existante. Pour plus d’informations, consultez Démarrage rapide : Déployer votre première application de conteneur avec le portail Azure.
Azure CLI.

Configurer une administration gérée pour Spring dans Azure Container Apps

Pour configurer le composant, procédez comme suit :

Azure portal
Azure CLI

Accédez à votre environnement d’application conteneur dans le portail Azure.
Dans le menu du service, sous Services, sélectionnez Services.
Choisissez Configurer, puis sélectionnez Composant Java.
Renseignez le volet Configurer le composant Java avec les valeurs suivantes :

Propriété Valeur

Type de composant Java Administration pour Spring

Nom du composant Java admin
Cliquez sur Suivant.
Dans l’onglet Vérifier, sélectionnez Configurer.

Propriété	Valeur
Type de composant Java	Administration pour Spring
Nom du composant Java	admin

Utilisez la commande suivante pour créer le composant Administrateur pour Spring Java :

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

Utilisez la commande suivante pour mettre à jour le composant Administrateur pour Spring Java :

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

Mettre à jour votre dépendance d’application conteneur

Pour intégrer le composant Administrateur dans votre application conteneur, ajoutez la dépendance suivante à votre fichier pom.xml. Remplacez le numéro de version par la dernière version disponible sur le référentiel Maven.

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

Lier votre application conteneur au composant Java de l’administration pour Spring

Azure portal
Azure CLI

Procédez comme suit pour lier votre application conteneur au composant :

Accédez à votre environnement Container Apps dans le portail Azure.
Sous Services, sélectionnez App Services.
Dans la liste, choisissez administrateur.
Sous Liaisons, sélectionnez le nom de votre application conteneur dans la liste déroulante Nom de l’application.
Sélectionnez l’onglet Révision, puis Configurer.
Accédez à votre application conteneur dans le portail Azure et copiez son URL pour une utilisation ultérieure.

Utilisez la commande suivante pour créer l’application conteneur et la lier au composant Administrateur pour Spring :

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

Accéder au tableau de bord d’administration

Remarque

L’administration gérée pour Spring dans Azure Container Apps ne prend pas en charge la configuration de l’authentification unique (SSO). Elle s’appuie sur les attributions de rôles Azure.

Pour accéder au tableau de bord, vous devez avoir le rôle Microsoft.App/managedEnvironments/write attribué à votre compte pour la ressource d’environnement managée.

Créer et affecter un rôle personnalisé

Pour créer et attribuer un rôle personnalisé, procédez comme suit :

Utilisez la commande suivante pour créer une définition de rôle personnalisée :

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>"]
}'

Utilisez la commande suivante pour affecter le rôle personnalisé à votre compte :

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

Partager via