請使用本指南,從舊有的 Functions on Azure 容器應用程式 V1 主機模型,轉換到推薦的 Functions on Azure 容器應用程式 V2 主機模型。 你學會為什麼要遷移、哪些變更,以及如何以最小風險執行轉換。
備註
使用 Azure Functions on Azure 容器應用程式 v1 遷移助理,幫助你將功能應用從 v1 模型遷移到 v2 模型。
你可以透過兩種部署模型在 Azure 容器應用程式中架設 Azure Functions:
Azure 容器應用程式 V1 上的函式:一種舊版代理模型,使用函式應用程式(
Microsoft.Web資源提供者)以及一個在幕後執行的容器應用程式。Azure 容器應用程式 V2 上的 Functions:原生模型,會建立單一 Azure 容器應用程式資源 (
Microsoft.App),並使用kind=functionapp。
當你在 Azure 容器應用程式 V2 上遷移到 Functions,就能簡化管理、解鎖原生功能,並與 Azure Functions 未來的路線圖保持一致。
模型比較
| Area | 在 Azure 容器應用程式 V1(舊版)上執行的 Functions | Azure 容器應用程式 V2 上的 Functions(建議使用) |
|---|---|---|
| 資源模型 | 代理功能應用程式搭配隱藏的容器應用程式 | 單一原生容器應用程式(kind=functionapp) |
| 原生特徵 (修訂、祕密、健康情況探測、自訂網域、Sidecar 容器) |
不支援 | 支援 |
| 縮放控制 (冷卻時間,投票間隔) |
限制 | 完整的容器應用程式縮放選項 |
| 記錄和疑難排解 | 間接的 沒有直播控制台 | 直接。 包含即時日誌與診斷資料 |
| Dapr 整合 | 在某些孤立的 .NET 情境下會造成問題 | 支援標準模式식 |
| 驗證 (簡單驗證) | 無法提供 | 有現貨 |
| 憑證與自訂網域 | 無法提供 | 有現貨 |
| 指標與警示 | 基本 | 完整的原生指標與警示 |
| 未來路線圖 (函式列表、鍵、呼叫次數) |
未規劃 | 已規劃 |
| 操作複雜度 | 雙資源管理 | 單一資源 |
| 建議使用於新部署 | 否 | Yes |
Azure 容器應用程式 V1 上函式的限制
Azure 容器應用程式 V1 的功能有多項限制,影響可擴展性、管理及功能可用性。 了解這些限制有助於釐清遷移到 Azure 容器應用程式 V2 上的 Functions 的好處。
功能差距
以下功能在 Azure 容器應用程式 V1 應用程式中無法提供:
- 輕鬆認證
- 健康檢測
- 自訂網域
- Sidecar 容器
- 管理憑證
- 容器應用程式秘密
- 顆粒尺度設定
- 多版本流量分割
故障排除限制
在 Azure 容器應用程式 V1 應用程式上執行的 Functions 中,您無法直接存取容器,也無法取得即時主控台輸出。 相反地,請使用 Log Analytics 進行基礎架構診斷,並使用 Application Insights 來處理應用程式日誌。
DAPR 整合問題
Dapr 與 .NET 的隔離函式在建置或執行時可能因相依性與初始化排序限制而發生衝突。
Azure 容器應用程式 V2 上 Functions 的優點
Functions on Azure 容器應用程式 V2 直接建立一個原生容器應用程式資源。 此方法消除代理間接操作,並啟用完整的 Azure 容器應用功能。
主要優點:
- 啟用 Easy Auth 以解除身份。
- 配置健康探測以提升韌性。
- 設定自訂網域並使用受管理憑證。
- 以單一資源降低營運負擔。
- 以原生方式儲存祕密,並掛接 Sidecar 容器。
- 獲得更清晰的指標、警示與即時日誌串流。
- 使用多版本部署並安全分割流量。
- 套用細緻的縮放規則(輪詢間隔、冷卻時間)。
備註
不需要變更程式碼。 你可以重複使用你現有的容器映像檔。
舊有直接映像部署(不支援)
有些部署使用不帶有 kind=functionapp 的標準容器應用程式,並手動執行函式映像檔。
這很重要
這種做法並不被支援。 它缺乏自動擴展規則,也無法接收即將推出的 Azure 容器應用程式 V2 平台功能,例如函式列表、鍵數和調用計數。
建議:遷移到 Azure 容器應用程式 v2 上的函數。
先決條件
遷移前:
- Azure 訂閱與建立資源的權限。
- [Azure CLI](/cli/azure/install-azure-cli-windows?view=azure-cli-latest(最新版本)已安裝。
- 必要延伸:
az extension add --name containerapp、az extension add --name functionapp(如果適用)。 - 存取 Azure 容器應用程式 V1 部署中 Functions 使用的容器映像。
- 環境變數、秘密、儲存綁定及網路設定的清單。
遷移程序
1. 準備
- 確認你目前的部署是 Functions on Azure 容器應用程式 V1 應用程式。
- 匯出所有設定資料,包括環境變數、秘密、連線字串及自訂綁定。
- 檢視環境配額(CPU、記憶體、最大實例),必要時調整。
- 確認你的登記清單中有圖片可用。
2. 建立 Azure 容器應用程式 V2 上的 Azure Functions 應用程式
建立或重用 Azure 容器應用程式環境。
部署使用相同映像的新 Azure 容器應用程式 V2 上的 Functions 應用程式。
az containerapp create \ --name my-func-v2 \ --resource-group <RESOURCE_GROUP_NAME> \ --environment <ENVRONMENT_NAME> \ --image myregistry.azurecr.io/<IMAGE_NAME>:<TAG_NAME> \ --kind functionapp \ --ingress external --target-port <TARGET_PORT>重新套用組態細節,包括秘密、環境變數、身份、網路。
如有需要,啟用認證或自訂網域。
定義縮放規則(如有需要,包含 HTTP、CPU 和隊列觸發的相關規則)。
3. 驗證
執行 HTTP 觸發的函式(使用 curl 或瀏覽器)。
測試每種觸發類型(事件中心、服務匯流排、計時器)。
確認 Application Insights 遙測資料和 Log Analytics 記錄。
檢查負載下的縮放行為 (自動調整規則是否觸發)。
驗證祕密與連接字串是否正確解析。
確認健康探針狀態及容器修訂細節。
4. 更新 DNS 或自訂網域(可選)
如果您使用自訂網域,可以將其對應至 Azure 容器應用程式 V2 上新的 Functions 主機名稱(CNAME 或 A 記錄)。
重新綁定 SSL/TLS 憑證(管理型或上傳型)。
測試網域解析與 TLS 握手。
內部通知端點的變更。
5. 遷移
調整生產流量(更新 DNS TTL 或路由規則)。
監控延遲、錯誤和呼叫次數。
如果需要,調整縮放參數(冷卻時間、最小/最大實例)。
在最初幾小時期間追蹤記錄以檢測異常。
6. 清理
汰除舊版 Functions on Azure 容器應用程式 V1 應用程式及其相關資源。
謹慎
刪除前,請確認目前已無任何生產流量仍導向 Functions on Azure 容器應用程式 V1 端點。
移除未使用的秘密或儲存參考。
更新內部文件和營運手冊。
驗證檢查清單
| Item | 通過標準 |
|---|---|
| 觸發程序會觸發 | 所有設定的觸發器都能成功執行 |
| 日誌與遙測 | Application Insights 顯示調用次數,即時日誌串流 |
| 調整大小 | 實例數量會依規則配置調整 |
| 授權(如果啟用) | 受保護端點會回傳預期的狀態碼 |
| 網域 | 自訂網域會以有效憑證解析 |
| Secrets | 敏感值載入時無錯誤 |
操作強化(選配)
遷移後提升可靠性: