將 Azure 容器應用程式重新配置到另一個區域

本文說明如何透過在目標區域重建受管理環境和容器應用程式,將 Azure 容器應用工作負載重新定位到另一個 Azure 區域。 流程涵蓋匯出應用程式設定、重新部署資源、驗證部署,以及清理來源區域的資源。

Important

Azure 容器應用程式 不支援原地區域遷移。 你在目標區域 重建 資源——現有資源不會被移動。 本文將介紹容器應用程式配置與基礎設施的遷移。 它不涵蓋複製應用程式數據、資料庫或其他具有狀態的相依性。

Prerequisites

開始前,請確認您符合以下條件:

  • Azure 容器應用程式 在目標區域內可用。
  • 目標區域支援與來源區域相同的容器應用程式功能、工作負載設定檔和網路選項。
  • 你在目標區域有足夠的配額來部署你計劃部署的資源。
  • 你在來源訂閱和目標訂閱中都有以下權限:
    • 資源群組的擁有者或貢獻者。
    • 容器應用程式參與者(推薦)。 此角色包含萬用字元權限,授予容器應用程式秘密值的存取權限。 欲取得更窄的存取權,請參閱 「管理秘密權限」。
  • 你的容器映像檔存在於可從目標區域存取的登錄檔中(例如 Azure 容器登錄檔或支援的外部登錄檔)。
  • 依賴的 Azure 資源,如 金鑰保存庫、儲存帳號、資料庫、虛擬網路和訊息服務,要麼已在目標區域內可用,要麼已有重新部署計畫。

Tip

如果你使用 Azure 容器登錄檔(ACR),可以考慮啟用 地理複製 功能,讓映像檔在目標區域可用,而無需重新部署登錄檔。

az acr replication create --registry <REGISTRY_NAME> --location <TARGET_REGION>

了解停機需求

Azure 容器應用程式不支援即時區域遷移。 停機主要由 DNS 傳播及切換期間流量路由變更所驅動。 為了減少影響:

  1. 先在目標區域部署並驗證容器應用程式。
  2. 事先降低 DNS TTL 值(例如縮短到 60 秒),讓路由變更能快速傳播。
  3. 只有在驗證完成後,才將生產流量重新導向到新的端點。
  4. 在確認目標部署狀態正常之前,保持原始容器應用程式執行。

準備

為準備搬遷,匯出原始設定並檢視所有區域專屬設定。

識別相依性

在切換前,目標區域必須存在以下相依資源:

  • Azure Key Vault
  • 儲存帳戶
  • 資料庫與訊息服務(例如 Azure 服務匯流排、Azure Cosmos DB)
  • 虛擬網路、子網路與私有端點
  • 網路安全群組(NSG)與使用者定義路由(UDR)
  • 私人 DNS 區域
  • Log Analytics 工作區
  • DAPR 元件(如有使用)

Important

秘密、憑證、自訂網域和安全設定值 不會被保留 在匯出的範本中。 你必須在目標區域手動從原始來源重建這些資源。

管理式身份變更計畫

受管理身份處理依身份類型而定:

  • 系統指派身份:當你重新建立容器應用程式時,Azure 會產生一個新的主體 ID。 您必須將所有 RBAC 角色、金鑰庫存取政策及下游服務權限重新指派到新身份。

  • 使用者指派身份:使用者指派的受管理身份是區域資源,無法跨區域移動。 在目標區域建立新的使用者指派身份,並在部署前分配所需權限。

匯出來源設定

使用 Azure 入口網站匯出 ARM 範本,涵蓋容器應用程式管理環境及個別容器應用程式。

  1. 請登入Azure portal。
  2. 請前往容器應用程式管理環境或容器應用程式資源。
  3. 從左側選單中,選擇 自動化>匯出範本。
  4. 選擇 下載 並將檔案 .zip 解壓到本地資料夾。

解壓出來的檔案包括:

檔案 Description
template.json 資源配置定義
參數檔案 部署參數值
部署指令碼 範本執行指令碼

Note

匯出的範本是理解你的設定的起點。 它們可能包含唯讀屬性需要移除,且 不包含秘密 或憑證值。 在重新部署前,請仔細檢查匯出的輸出。

修改受管理環境範本

在重新部署受管理環境前,先更新匯出的設定:

  • 更新位置:將屬性設定 location 為目標 Azure 區域。
  • 驗證資源名稱:確保受管理環境名稱在目標資源群組與區域內是唯一的。
  • 檢視 Log Analytics 設定:如果工作區是區域特定的,請更新 Log Analytics 工作區的參考資料。 你可能需要在目標區域建立一個新的工作區。
  • 移除唯讀屬性:如果你從入口網站匯出,請移除像 id、 type、 systemData、 及其他導致部署失敗的唯讀屬性欄位。

修改容器應用程式範本

匯出容器應用程式設定後,請做以下修改:

  • 更新受管理環境參考:將 managedEnvironmentId 替換為目標區域中新管理環境的資源 ID。 受管理環境是區域限制性的,無法跨區域重複使用。

  • 驗證容器映像參考:確認影像參考指向可從目標區域存取的容器登錄檔。 如果你啟用了 ACR 地理複製,現有的參考可能不用更改即可正常運作。

  • 檢視入口設定:重新部署後,應用程式的完全限定網域名稱(FQDN)會變更。 計畫在切換期間更新自訂 DNS 紀錄和流量路由。

  • 重新配置秘密與應用程式設定:透過使用 Azure Key Vault 參考或應用程式設定重新建立秘密。 不要只依賴匯出值來設定敏感度。

  • 更新 Dapr 元件:如果您使用 Dapr,請確認 Dapr 元件組態是否參考目標區域內的可用資源 (例如狀態存放區、發佈/訂閱訊息代理程式、秘密存放區)。

  • 更新診斷與監控:驗證 Log Analytics 工作區的參考資料,並視需要重新配置診斷設定。

重新部署

Azure 容器應用程式 管理環境是區域限制的。 在重新部署任何容器應用程式之前,先在目標區域建立受管理環境。

部署管理環境

  1. 在 Azure 入口網站,前往目標資源群組。
  2. 選擇 部署自訂範本。
  3. 在編輯器中選擇 「建立你自己的範本 」,然後上傳修改過的 ARM 範本。
  4. 檢視部署設定,然後選擇 檢視 + 創建 開始部署。

驗證容器登錄存取權

在部署容器應用程式前,請確認容器應用程式所使用的身份(系統指派或使用者指派的管理身份)在目標 Azure 容器登錄檔中已分配 AcrPull 角色。

az role assignment create \
  --assignee <IDENTITY_PRINCIPAL_ID> \
  --role AcrPull \
  --scope <ACR_RESOURCE_ID>

Note

如果容器應用程式在不同訂閱或區域中參考 ACR,請事先確認所需權限已設定,以防止部署時拉取映像失敗。

部署容器應用程式

  1. 在 Azure 入口網站,前往目標資源群組。
  2. 選擇 部署自訂範本。
  3. 上傳修改過的 ARM 範本用於容器應用程式。
  4. 檢視設定並完成部署。

設定網路

部署後,重新配置網路以符合原始設定:

  1. 設定入口:根據應用程式的暴露模型設定公開或私有入口。

  2. 重新套用 VNet 整合:如果容器應用程式使用私有網路,請在目標區域配置 VNet、子網路、私有端點及私有 DNS 區域。

  3. 更新 NSG 與 UDR:視需要重建網路安全群組及使用者自訂路由。

  4. 更新 IP 允許清單:若下游服務使用 IP 型允許清單,請將清單更新為目標區域環境的新輸出 IP 位址。

  5. 設定自訂網域與憑證:自訂網域與 TLS 憑證在搬遷時不會被轉移。 在新的容器應用程式中重新設定它們並更新 DNS 紀錄。

完全移轉流量

驗證後,將流量重新導向目標區域部署:

  1. 如果你之前降低了 DNS TTL,請更新 DNS 紀錄,讓它指向新的容器應用程式 FQDN。

  2. 如果你使用 Azure Front Door 或 Azure 流量管理員,請更新後端池或端點,加入目標區域容器應用程式,並移除來源區域端點。

  3. 監控流量以確認請求是否已抵達新部署。

Tip

在回滾視窗期間保持原始容器應用程式在運行。 如果出現問題,請將 DNS 或流量路由還原到來源端點,直到問題解決為止。

驗證

交通切換後,請驗證以下項目:

  • 應用程式的可用性與回應時間。
  • 在預期負載和峰值負載下的縮放行為。
  • 連接相關服務,如資料庫、金鑰庫、儲存及訊息傳遞。
  • 使用管理的身分識別來存取下游資源。
  • Dapr 元件功能 (如果使用)。
  • 日誌和指標會流到 Azure 監視器 和 Log Analytics。

請使用CLI驗證:

# Confirm the container app is running
az containerapp show \
  --name <APP_NAME> \
  --resource-group <TARGET_RESOURCE_GROUP> \
  --query "{status:properties.runningStatus, fqdn:properties.configuration.ingress.fqdn}" \
  --output table

# Test the application endpoint
curl -s -o /dev/null -w "%{http_code}" https://<APP_FQDN>/health

Important

請持續執行原始容器應用程式,直到驗證完成並確認目標部署正常。 在清理原始資源前,定義一個回滾時間範圍,例如 24 到 48 小時。

清除來源資源

在成功驗證與流量切換後:

  1. 刪除來源容器應用程式。
  2. 如果你不再需要,請刪除原始碼管理環境。
  3. 移除未使用的容器映像檔、網路資源及身份分配,以避免不必要的費用。
  4. 更新任何參考來源資源的監控儀表板或警示規則。

局限性

  • Azure 容器應用程式不支援原地或即時區域重定位。
  • 你必須重新建立秘密、憑證和自訂網域。
  • 修訂歷史不會被保留在目標部署中。
  • 切換過程中需要休息時間。
  • 系統指派的管理身份主體 ID 會變動,因此您必須重新建立所有 RBAC 指派。
  • 使用者指派的管理身份是區域性的,必須在目標區域重新建立。
  • 出站 IP 位址會變動,這可能會影響下游的服務允許清單。