將應用程式實時檢視移轉至 Spring Boot 管理員

發行項
2025-03-08

注意

基本、標準和企業方案將從 2025 年 3 月中旬開始淘汰，並停用 3 年。建議您轉換至 Azure Container Apps。如需詳細資訊，請參閱 Azure Spring Apps 淘汰公告。

標準 耗用量和專用 方案將從 2024 年 9 月 30 日起淘汰，並在六個月後完成關閉。建議您轉換至 Azure Container Apps。如需詳細資訊，請參閱將 Azure Spring Apps 標準取用和專用方案遷移至 Azure Container Apps。

本文適用於： ❎基本/標準 ✅ 企業

本文說明從應用程式實時檢視移轉至 Spring Boot 管理員的移轉路徑。

Spring Boot Admin 是管理及監視 Spring Boot 應用程式的強大工具。其建置在 Spring Boot 執行器上，可讓您深入瞭解透過可存取的 HTTP 端點執行應用程式的內部工作。 Spring Boot 管理員會收集數據，並利用這些端點協助與應用程式互動。

設定 Spring Boot Admin Server

Azure Spring Apps 先前提供與 Tanzu 應用程式即時檢視的內建整合，可協助您管理應用程式。不過，由於產品功能變更，此功能已不再提供。為了確保您可以繼續輕鬆地管理應用程式，下列步驟會引導您設定和使用 Spring Boot Admin Server 作為替代解決方案：

建立新的應用程式。
- Azure 入口網站
- Azure CLI
使用下列步驟來建立 Spring Boot Admin Server 應用程式：
1. 流覽至 Azure 入口網站中的 Azure Spring Apps 企業實例。
2. 從瀏覽窗格開啟 [應用程式] 窗格，以檢視服務執行個體的應用程式。
3. 選取 [建立應用程式 ] 以開啟 [ 建立應用程式 ] 窗格。
4. 將應用程式 命名為 spring-boot-admin。
5. 將部署類型保留為 Artifacts （Java/Polyglot） 不變。
6. 開啟 [系結 ] 下拉式清單，然後選取 [服務登錄]。
7. 選取 [建立] 以建立應用程式。
使用下列命令建立 Spring Boot Admin Server 應用程式：
```
az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name spring-boot-admin \
    --bind-service-registry
```

建置 Spring Boot Admin Service。

建立應用程式之後，下一個步驟是建置 Spring Boot Admin Service 應用程式。請遵循 Spring Boot 管理員快速入門檔中的指示。

您可以參考下列範例程式代碼：

SpringBootAdminApplication.java

@SpringBootApplication
@Configuration
@EnableAutoConfiguration // Use a discovery service instead of Spring Boot Admin Clinet. The rest is done by our AutoConfiguration.
@EnableDiscoveryClient  // Enables the service to register with a discovery service
@EnableAdminServer
public class SpringBootAdminApplication {
  public static void main(String[] args) {
     SpringApplication.run(SpringBootAdminApplication.class, args);
  }
}

pom.xml

新增下列 Spring Boot 管理員相依性：

<!-- Spring Boot Admin -->
<dependency>
  <groupId>de.codecentric</groupId>
  <artifactId>spring-boot-admin-starter-server</artifactId>
  <version>${spring-boot-admin.version}</version>
</dependency>
<dependency>
  <groupId>de.codecentric</groupId>
  <artifactId>spring-boot-admin-server-ui</artifactId>
  <version>${spring-boot-admin.version}</version>
</dependency>

部署應用程式。

建置 Spring Boot 管理服務之後，請使用 Azure CLI 進行部署：

cd <path-to-maven-or-gradle-source-root>
az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name spring-boot-admin \
    --source-path

指派公用端點。

透過 Azure Spring Apps 指派公用端點，讓 Spring Boot 管理伺服器可供存取。

Spring Boot Admin 預設不包含授權。 Spring Boot Admin 是一般的 Spring Boot 應用程式，因此您可以使用 Spring Security 來保護它。另請參閱保護 Spring Boot Admin Server。

向 Spring Boot 管理員註冊應用程式

使用探索服務

Spring Boot 系統管理員可以依賴探索服務來探索應用程式。向 Tanzu 服務登錄註冊應用程式之後，Spring Boot Admin 伺服器會自動辨識它們。

如需如何向 Tanzu 服務登錄註冊應用程式的詳細資訊，請參閱使用 Tanzu 服務登錄。

Spring Boot Admin 可順暢地連線到並監視具有自定義執行器設定的 Spring Boot 應用程式。

使用 Spring Boot 管理用戶端

您也可以將應用程式註冊為 Spring Boot 管理用戶端。此方法不相依於探索服務，但需要修改您的應用程式以包含 Spring Boot Admin 用戶端相依性。如需詳細資訊，請參閱 Spring Boot 管理檔中的開始使用。

使用 Spring Boot Admin 來監視您的應用程式

Spring Boot 管理員可讓您檢視 Spring Boot 應用程式的即時計量。 Spring Boot Admin 是以 Spring Boot 執行器的概念為基礎。

請遵循下列步驟來部署應用程式，並在 Spring Boot Admin 中加以監視：

新增執行器相依性。將下列相依性新增至應用程式的 pom.xml 檔案。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
 </dependency>

啟用執行器端點。在應用程式的 application.properties 檔案中，新增下列組態以公開必要的端點：
```
management.endpoints.web.exposure.include=info,health
```
組建應用程式。使用下列命令在本機建置您的應用程式：
```
mvn clean package -DskipTests
```

部署應用程式。使用下列命令將應用程式部署至 Azure Spring Apps：

az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name>
cd <path-to-maven-or-gradle-source-root>
az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name> \
    --source-path

停用應用程式實時檢視

在 Spring Boot Admin 中註冊所有 Spring Boot 應用程式之後，您可以遵循下列步驟來停用 Azure Spring Apps 中的應用程式實時檢視功能：

Azure 入口網站
Azure CLI

流覽至您的 Azure Spring Apps 服務實例，然後選取 [ 開發人員工具]。
選取 [ 管理工具]。
取消核取 [ 啟用應用程式實時檢視] 複選框，然後選取 [ 儲存]。
然後，您可以在開發人員工具上檢視應用程式即時檢視的狀態。

使用下列命令來停用應用程式實時檢視：

az spring application-live-view delete
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

已知的限制

如果您使用 Service Registry 註冊應用程式， EUREKA-SERVER 應用程式會出現在 Spring Boot Admin 儀錶板中，狀態為 OFFLINE ，且無法隱藏或移除。
根據預設，不支援單一登錄（SSO）。

共用方式為