本文說明如何透過在目標區域重建受管理環境和容器應用程式,將 Azure 容器應用工作負載重新定位到另一個 Azure 區域。 流程涵蓋匯出應用程式設定、重新部署資源、驗證部署,以及清理來源區域的資源。
Important
Azure 容器應用程式 不支援原地區域遷移。 你在目標區域 重建 資源——現有資源不會被移動。 本文將介紹容器應用程式配置與基礎設施的遷移。 它不涵蓋複製應用程式數據、資料庫或其他具有狀態的相依性。
Prerequisites
開始前,請確認您符合以下條件:
- Azure 容器應用程式 在目標區域內可用。
- 目標區域支援與來源區域相同的容器應用程式功能、工作負載設定檔和網路選項。
- 你在目標區域有足夠的配額來部署你計劃部署的資源。
- 你在來源訂閱和目標訂閱中都有以下權限:
- 資源群組的擁有者或貢獻者。
- 容器應用程式參與者(推薦)。 此角色包含萬用字元權限,授予容器應用程式秘密值的存取權限。 欲取得更窄的存取權,請參閱 「管理秘密權限」。
- 你的容器映像檔存在於可從目標區域存取的登錄檔中(例如 Azure 容器登錄檔或支援的外部登錄檔)。
- 依賴的 Azure 資源,如 金鑰保存庫、儲存帳號、資料庫、虛擬網路和訊息服務,要麼已在目標區域內可用,要麼已有重新部署計畫。
Tip
如果你使用 Azure 容器登錄檔(ACR),可以考慮啟用 地理複製 功能,讓映像檔在目標區域可用,而無需重新部署登錄檔。
az acr replication create --registry <REGISTRY_NAME> --location <TARGET_REGION>
了解停機需求
Azure 容器應用程式不支援即時區域遷移。 停機主要由 DNS 傳播及切換期間流量路由變更所驅動。 為了減少影響:
- 先在目標區域部署並驗證容器應用程式。
- 事先降低 DNS TTL 值(例如縮短到 60 秒),讓路由變更能快速傳播。
- 只有在驗證完成後,才將生產流量重新導向到新的端點。
- 在確認目標部署狀態正常之前,保持原始容器應用程式執行。
準備
為準備搬遷,匯出原始設定並檢視所有區域專屬設定。
識別相依性
在切換前,目標區域必須存在以下相依資源:
- Azure Key Vault
- 儲存帳戶
- 資料庫與訊息服務(例如 Azure 服務匯流排、Azure Cosmos DB)
- 虛擬網路、子網路與私有端點
- 網路安全群組(NSG)與使用者定義路由(UDR)
- 私人 DNS 區域
- Log Analytics 工作區
- DAPR 元件(如有使用)
Important
秘密、憑證、自訂網域和安全設定值 不會被保留 在匯出的範本中。 你必須在目標區域手動從原始來源重建這些資源。
管理式身份變更計畫
受管理身份處理依身份類型而定:
系統指派身份:當你重新建立容器應用程式時,Azure 會產生一個新的主體 ID。 您必須將所有 RBAC 角色、金鑰庫存取政策及下游服務權限重新指派到新身份。
使用者指派身份:使用者指派的受管理身份是區域資源,無法跨區域移動。 在目標區域建立新的使用者指派身份,並在部署前分配所需權限。
匯出來源設定
使用 Azure 入口網站匯出 ARM 範本,涵蓋容器應用程式管理環境及個別容器應用程式。
- 請登入Azure portal。
- 請前往容器應用程式管理環境或容器應用程式資源。
- 從左側選單中,選擇 自動化>匯出範本。
- 選擇 下載 並將檔案
.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 容器應用程式 管理環境是區域限制的。 在重新部署任何容器應用程式之前,先在目標區域建立受管理環境。
部署管理環境
- 在 Azure 入口網站,前往目標資源群組。
- 選擇 部署自訂範本。
- 在編輯器中選擇 「建立你自己的範本 」,然後上傳修改過的 ARM 範本。
- 檢視部署設定,然後選擇 檢視 + 創建 開始部署。
驗證容器登錄存取權
在部署容器應用程式前,請確認容器應用程式所使用的身份(系統指派或使用者指派的管理身份)在目標 Azure 容器登錄檔中已分配 AcrPull 角色。
az role assignment create \
--assignee <IDENTITY_PRINCIPAL_ID> \
--role AcrPull \
--scope <ACR_RESOURCE_ID>
Note
如果容器應用程式在不同訂閱或區域中參考 ACR,請事先確認所需權限已設定,以防止部署時拉取映像失敗。
部署容器應用程式
- 在 Azure 入口網站,前往目標資源群組。
- 選擇 部署自訂範本。
- 上傳修改過的 ARM 範本用於容器應用程式。
- 檢視設定並完成部署。
設定網路
部署後,重新配置網路以符合原始設定:
設定入口:根據應用程式的暴露模型設定公開或私有入口。
重新套用 VNet 整合:如果容器應用程式使用私有網路,請在目標區域配置 VNet、子網路、私有端點及私有 DNS 區域。
更新 NSG 與 UDR:視需要重建網路安全群組及使用者自訂路由。
更新 IP 允許清單:若下游服務使用 IP 型允許清單,請將清單更新為目標區域環境的新輸出 IP 位址。
設定自訂網域與憑證:自訂網域與 TLS 憑證在搬遷時不會被轉移。 在新的容器應用程式中重新設定它們並更新 DNS 紀錄。
完全移轉流量
驗證後,將流量重新導向目標區域部署:
如果你之前降低了 DNS TTL,請更新 DNS 紀錄,讓它指向新的容器應用程式 FQDN。
如果你使用 Azure Front Door 或 Azure 流量管理員,請更新後端池或端點,加入目標區域容器應用程式,並移除來源區域端點。
監控流量以確認請求是否已抵達新部署。
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 小時。
清除來源資源
在成功驗證與流量切換後:
- 刪除來源容器應用程式。
- 如果你不再需要,請刪除原始碼管理環境。
- 移除未使用的容器映像檔、網路資源及身份分配,以避免不必要的費用。
- 更新任何參考來源資源的監控儀表板或警示規則。
局限性
- Azure 容器應用程式不支援原地或即時區域重定位。
- 你必須重新建立秘密、憑證和自訂網域。
- 修訂歷史不會被保留在目標部署中。
- 切換過程中需要休息時間。
- 系統指派的管理身份主體 ID 會變動,因此您必須重新建立所有 RBAC 指派。
- 使用者指派的管理身份是區域性的,必須在目標區域重新建立。
- 出站 IP 位址會變動,這可能會影響下游的服務允許清單。