你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将应用程序实时视图迁移到 Azure 容器应用中 Spring 的托管管理员

项目
02/05/2025

注意

基本、标准和企业计划将从 2025 年 3 月中旬开始弃用，停用期为 3 年。建议转换到 Azure 容器应用。有关详细信息，请参阅 Azure Spring Apps 停用公告。

标准消耗和专用计划将于 2024 年 9 月 30 日开始弃用，并在六个月后完全关闭。建议转换到 Azure 容器应用。有关详细信息，请参阅将 Azure Spring Apps 标准消耗和专用计划迁移到 Azure 容器应用。

本文适用于： ❎ 基本计划/标准计划 ✅ 企业计划

本文介绍如何将 API 门户迁移到 Azure 容器应用中 Spring 的托管管理员。

适用于 Spring 的控制台托管组件为公开执行器终结点的 Spring Boot Web 应用程序提供了一个管理界面。它类似于应用程序实时视图，充当轻型见解和故障排除工具，可帮助开发人员和作员监视正在运行的应用。

先决条件

启用了应用程序配置服务的已配置的 Azure Spring Apps 企业计划实例。
现有 Azure 容器应用。更多信息，请参阅快速入门：使用 Azure 门户部署你的第一个应用程序。
Azure CLI。

在 Azure 容器应用中预配适用于 Spring 的管理控制台

使用以下步骤预配组件：

Azure 门户
Azure CLI

在 Azure 门户中导航到容器应用环境。
在服务菜单上的“服务”下，选择“服务”。
选择“配置”，然后选择“Java 组件”。
使用以下值填写“配置 Java 组件”窗格：

属性 Value

Java 组件类型 Spring 的控制台

Java 组件名称 admin
选择下一步。
在“查看”选项卡中，选择“配置”。

属性	Value
Java 组件类型	Spring 的控制台
Java 组件名称	admin

使用以下命令创建适用于 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

使用以下命令更新适用于 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

更新容器应用依赖项

若要将管理员组件集成到容器应用中，请在 pom.xml 文件中添加以下依赖项。将版本号替换为 Maven 存储库的最新版本。

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

使用以下步骤将容器应用绑定到组件：

在 Azure 门户中转到你的容器应用环境。
在“服务”下，选择“服务”。
从列表中选择“管理员”。
在“绑定”下，从“应用名称”下拉列表中选择容器应用名称。
选择“查看”选项卡，然后选择“配置”。
在 Azure 门户中导航到你的容器应用，并复制其 URL 供以后使用。

使用以下命令创建容器应用并绑定到适用于 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

访问管理仪表板

注意

Azure 容器应用中适用于 Spring 的管理控制台不支持单一登录 (SSO) 配置。它依赖于 Azure 角色分配。

要访问仪表板，必须在托管环境资源上向你的帐户分配 Microsoft.App/managedEnvironments/write 角色。

创建和分配自定义角色

使用以下步骤来创建和分配自定义角色：

使用以下命令创建自定义角色定义：

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

使用以下命令将自定义角色分配给帐户：

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

通过