共用方式為

將 Spring Cloud Config 伺服器從 Azure Spring Apps 遷移至 Azure Container Apps

注意

基本、標準和企業方案於 2025 年 3 月 17 日進入淘汰期。 如需詳細資訊，請參閱 Azure Spring Apps 淘汰公告。

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

本文說明如何在 Azure Container Apps 中將 Spring Cloud Config Server 移轉至 Spring 的設定伺服器。 Azure Container Apps 會管理 Spring 的 Config Server，其功能與 Azure Spring Apps 中的 Spring Cloud Config Server 類似。

必要條件

  • 已啟用設定伺服器的 Azure Spring Apps 實例。
  • 適用於 Config Server 和 Azure Container Apps 實例的 Azure Container Apps 環境。

布建組態伺服器

下列步驟說明如何在 Azure Container Apps 中布建 Spring 的 Config Server：

  1. 流覽至 Azure 入口網站 中的 Azure Container Apps 環境。

  2. 在功能表中，選取 [服務服務>]。

  3. 開啟 [設定] 下拉式列表，然後選取 [Java 元件]。

  4. 在 [ 設定 Java 元件 ] 面板中，輸入下列值：

    屬性 值
    JAVA 元件類型 選取 [適用於 Spring 的 Config Server]。
    JAVA 元件名稱 輸入 configserver。

  5. 在 [Git 存放庫] 區段中，選取 [新增]，然後將值從應用程式組態服務移轉至此處，如下表所示。 選擇一個存放庫作為 Spring 設定伺服器的預設存放庫。

    屬性 值
    類型 選取 [ 預設值]。
    URI 輸入存放庫 URI 的值。
    分支名稱 輸入存放庫標籤的值。
    搜尋路徑 輸入存放庫的搜尋路徑值。
    驗證 選取存放庫的驗證類型，然後輸入對應的資訊。

    保留其餘欄位的預設值，然後選取 [ 新增]。

  6. 如果您有多個存放庫，請選取 [ 新增 ] 以移轉其他存放庫。 針對 [ 類型]，選取 [其他]，然後移轉其他屬性，如上一個步驟和下表所示：

    屬性 值
    類型 選取 [ 預設值]。
    模式 以或 格式輸入存放{application} 值。

  7. 在 [系 結] 區段中，開啟下拉式清單以選取要系結至 Spring 的 Config Server 的應用程式。

  8. 選取 [下一步]。

  9. 若要設定 Config Server，請在 [ 檢閱 ] 索引標籤上選取 [ 設定]，然後遵循組態區段中的指示。

成功建立之後，您可以看到 Spring 的 Config Server 布建狀態 為 Succeeded。

資源配置

Azure Container Apps 中受控設定伺服器的容器資源配置已修正為下列值：

  • CPU：0.5 vCPU
  • 記憶體：1 Gi

若要設定 Spring 的 Config Server 實體計數，您必須以相同的值更新參數 --min-replicas 和 --max-replicas 。 此組態可確保實例計數維持固定狀態。 目前，系統不支援動態調整的自動調整設定。

設定組態伺服器

將 Azure Spring Apps 中 Spring Cloud Config Server 中設定的預設 Git 存放庫和其他存放庫對應至 Azure Container Apps 中 Config Server for Spring 中的預設和其他存放庫。 下表顯示屬性的對應關聯性：

Azure Spring Apps 中的屬性名稱 CONFIGURATION_KEY CONFIGURATION_VALUE
uri spring.cloud.config.server.git.uri
spring.cloud.config.server.git.repos.{repoName}.uri		 uri遠端存放庫的 。
search path spring.cloud.config.server.git.search-paths
spring.cloud.config.server.git.repos.{repoName}.search-paths		 搜尋要在本機工作複本中使用的路徑。 根據預設，只會搜尋根目錄。
label spring.cloud.config.server.git.default-label
spring.cloud.config.server.git.repos.{repoName}.default-label		 用於 Git 的標籤。
name 其他存放庫中 {repoName} 在下列組態中。
Patterns 其他存放庫中 spring.cloud.config.server.git.repos.{repoName}.pattern
username spring.cloud.config.server.git.username
spring.cloud.config.server.git.repos.{repoName}.username		 username如果驗證類型為 HTTP Basic，請輸入 使用遠端存放庫進行驗證的 。
password spring.cloud.config.server.git.password
spring.cloud.config.server.git.repos.{repoName}.password		 password如果驗證類型為 HTTP Basic，請輸入 使用遠端存放庫進行驗證的 。
private key spring.cloud.config.server.git.private-key
spring.cloud.config.server.git.repos.{repoName}.private-key		 如果驗證類型為 SSH，則為有效的 SSH 私鑰。
host key spring.cloud.config.server.git.host-key
spring.cloud.config.server.git.repos.{repoName}.host-key		 如果驗證類型為 SSH，則為有效的 SSH 主機金鑰。 如果 host-key-algorithm 也已設定，則必須設定 。
host key algorithm spring.cloud.config.server.git.host-key-algorithm
spring.cloud.config.server.git.repos.{repoName}.host-key-algorithm		 如果驗證類型為 ssh-dss，則為、ssh-rsassh-ed25519、ecdsa-sha2-nistp256ecdsa-sha2-nistp384、 ecdsa-sha2-nistp521或 SSH 的其中一個 。 如果同時設定 host-key，則必須設定 。

如需更多 Config Server 屬性，請參閱連線到 Azure Container Apps 中 Spring 受控設定伺服器的組態選項一節。

將應用程式部署至 Azure Container Apps

在本機測試應用程式之後，您可以將新的映像部署至 Azure Container Apps 應用程式。

使用下列步驟來部署：

  1. 流覽至 Azure 入口網站 中的 Azure Container Apps 應用程式。
  2. 在功能表中，選取 [應用程式>容器]。
  3. 選取 [編輯並部署 ] 以開啟 [ 建立並部署新的修訂 ] 頁面。
  4. 在 [ 容器映射] 區段中，選取映像，然後選取 [ 編輯]。
  5. 在 [ 編輯容器 ] 區段的 [屬性 ] 索引標籤上，選擇應用程式的新映像。
  6. 在 [環境變數] 索引標籤上，針對 [名稱] 指定 spring.application.name。 然後，針對 [來源] 選擇 [手動] 專案 ，然後指定應用程式取用組態的組態檔名稱。
  7. 選取 [ 儲存 ] 以部署新的修訂。

疑難排解

您可以使用 Log Analytics 檢視 Azure Container Apps 中 Spring 受控設定伺服器的記錄。 使用下列步驟：

  1. 流覽至 Azure 入口網站 中的 Azure Container Apps 環境。

  2. 選取 [監視記錄>] 功能表。

  3. 若要檢視記錄，請在數據表的查詢編輯器 ContainerAppSystemLogs_CL 中輸入查詢，如下列範例所示：

    ContainerAppSystemLogs_CL
| where ComponentType_s == "SpringCloudConfig"
| project Time=TimeGenerated, ComponentName=ComponentName_s, Message=Log_s
| take 100

如需查詢記錄的詳細資訊，請參閱 Azure Container Apps 中受控 Java 元件的可檢視性。

  • Last updated on