本文將說明如何將現有的功能應用程式從 消費方案 遷移到 彈性消費方案。 對大多數應用程式來說,這個遷移過程都很直接。 從 Windows 遷移的應用程式也必須與 Linux 相容,可能需要修改程式碼。
這很重要
在使用量方案中裝載於 Linux 上的函式應用程式,其支援將於 2028 年 9 月 30 日終止。 截至目前,Linux 消費方案尚未進行功能與語言增強。 請參考本文,將您的 Consumption 計畫應用程式遷移至在 Flex Consumption 計畫中運行。 若要深入了解 Linux 使用量方案的支援終止日期,請參閱 Azure Functions 使用量方案裝載 (舊版)。
移轉方法
本文說明如何在 Linux 和 Windows 應用程式的 Flex Consumption 方案下,將應用程式遷移至 Linux 功能應用程式。 Functions 提供多種方法來簡化大多數遷移步驟,特別是針對 Linux 應用程式。
下表顯示各作業系統可用的遷移方法,本文將涵蓋。
| 移轉方法 | 說明 | Linux | Windows |
|---|---|---|---|
| Azure Skills in GitHub Copilot | 讓 Copilot 以互動式方式引導並自動化您的遷移。 | ✅ | ✅ |
| CLI 遷移指令 | 用 az functionapp flex-migration 來自動化遷移。 |
✅ | ❌ |
| 標準 CLI 指令 | 使用 Azure CLI 命令的逐步遷移。 | ➖ | ✅ |
| Azure portal | Azure portal 中的逐步遷移。 | ✅ | ✅ |
| 基礎結構即程式代碼 | 使用 ARM 範本、Bicep 檔案或 Terraform 建立可重複的遷移程式碼。 | ➖ | ➖ |
✅ 支援與精選 |➖ 支援,非精選 | ❌ 不支援
要查看你應用程式的正確指示,請在文章頂端選擇你的作業系統。
您可以在 Azure 技能存放庫中檢閱 Linux 使用量移轉工作流程和 Windows 使用量移轉工作流程。
預期內容
遷移你的 Consumption 計畫應用程式所需的具體步驟,取決於作業系統以及你所採用的遷移方式:
Azure 技能會幫你自動化大部分的遷移。 你要採取的高層次步驟是:
小提示
要啟動基於GitHub Copilot的遷移,請參閱 Quickstart:使用 GitHub Copilot 將 Linux Consumption 應用程式遷移至 Flex Consumption。
無論你的遷移方式為何,以下是遷移的一般原則:
- 檢查程式碼相容性。 Linux 應用程式在支援的語言版本中通常不需要修改程式碼。 Windows 應用程式在 Linux 上執行之前也必須移除 Windows 專屬的相依性。 本指南能幫助你檢查。
- 你必須建立一個新的應用程式。 遷移過程會建立一個新的 Flex 消費應用程式,與你現有的應用程式一起存在,讓你可以在正式切換前進行測試。
- 使用同一個資源群組。 你的新應用程式運行在同一個資源群組,並且能存取相同的相依關係。
- 你掌控時機。 在重新導向流量並停用舊應用程式之前,務必徹底測試你的新應用程式。
備註
如果你用的是 Azure Government,Flex Consumption 尚未提供。 現在就檢視這份指引,讓你在它可用時做好準備。
遷移至彈性消費的好處
當你遷移相容的應用程式時,你的函式會獲得以下好處:
- 更快的冷啟動:隨時就緒的執行個體,表示您的函式能更快速地回應。
- 更好的縮放:每個函式的縮放和並發控制讓你有更多控制。
- 虛擬網路支援:將您的功能連接到私有網路並使用私有端點。
- 主動投資:彈性消費是新功能與改進的最先登陸點。
欲了解更多資訊,請參閱 彈性消費方案的福利 與 主機方案比較。
資源型部署
本文並未明確說明如何使用基礎設施即程式碼(IaC)進行遷移。 不過,你可以依照相同的遷移步驟轉換你的 ARM 範本、Bicep 檔案和 Terraform 設定。
Flex Consumption 計畫在 functionAppConfig 資源定義中新增了新的 Microsoft.Web/sites 區塊,取代了數個舊有的應用程式設定。 如需這些變更的詳細資料,請參閱彈性使用量方案淘汰項目。
這些資源能幫助您開始彈性消耗資源部署:
成功遷移後, 更新資源部署檔案 以符合新的彈性消費設定。
先決條件
存取包含一個或多個功能應用程式的 Azure 訂閱以進行遷移。 執行遷移任務的帳號必須具備以下權限:
- 建立和管理函式應用程式及 App Service 主控方案。
- 將角色指派給受控識別。
- 建立和管理記憶體帳戶。
- 建立和管理 Application Insights 資源。
- 存取你應用程式所有依賴資源,例如 Azure Key Vault、Azure 服務匯流排 或 Azure 事件中樞。
在資源群組中指派 擁有者 或 貢獻 者角色通常能提供足夠的權限。
使用 Azure CLI 或 GitHub Copilot 進行遷移:
- Azure CLI,版本 2.77.0 或更新版本。 使用 Azure CLI 指令時必須使用。 腳本測試時會使用Azure CLIAzure Cloud Shell。
- 登入Azure CLI時,請執行
az login。 確保你已經登入包含你想遷移的功能應用程式的訂閱。
-
resource-graph 擴充套件,請使用
az extension add命令安裝:
az extension add --name resource-graph-
此工具
jq,用來處理 JSON 輸出。
若要使用 GitHub Copilot 進行遷移,請設定 GitHub Copilot 以您想要的模式:
如果你還沒登入 Azure CLI,請登入:
az login確保你已經登入包含你想遷移的功能應用程式的訂閱。
啟動 Copilot CLI:
copilot新增市集來源 (僅限第一次):
/plugin marketplace add microsoft/azure-skills安裝外掛:
/plugin install azure@azure-skills安裝後,重新載入模型情境協定(MCP)伺服器:
/mcp reload驗證安裝:
/mcp show你應該會看到 Azure 外掛並有勾選標記。 這個
functionapp工具是這個外掛的一部分。
小提示
如果 Copilot 以錯誤的訂用帳戶為目標,請要求其使用特定訂用帳戶識別碼。 你可以透過執行
az account show --query id -o tsv來找到你的訂閱 ID 。 如果 Copilot 連接錯誤的 Azure 租戶,請要求 Copilot 在撥打 Azure 電話時使用你的特定租戶 ID。 你可以透過輸入az account show --query tenantId -o tsv來找到你的租戶 ID 。
識別要移轉的潛在應用程式
小提示
已經知道要遷移哪個應用程式了嗎? 你可以跳過這部分,直接進入 評估你現有的應用程式。
如果你有多個功能應用程式,且不確定哪些需要遷移,這個部分能幫助你找到它們。 你會得到一份應用程式名稱、資源群組、位置和執行時堆疊的清單。
要開始互動式遷移,掃描你的訂閱並提示你選擇要遷移的應用程式,請使用以下提示:
migrate my linux function apps in azure from consumption to flex consumption
Copilot 會幫你辨識符合資格的 Linux 消費應用程式,讓你選擇要遷移哪些,然後引導你完成每個應用程式的評估、應用程式建立、設定和部署流程。 繼續進行 遷移步驟。
如果你只是想看看哪些應用程式符合資格,但不想開始遷移,請使用這個提示:
list my linux consumption apps eligible for flex consumption migration
Copilot 會回傳一份符合資格和不符合資格的應用程式清單,以及任何不相容的原因。 接著你可以透過「 開始 Linux 遷移」中的提示,遷移特定應用程式。
要在不開始遷移的情況下辨識訂閱中的 Windows Consumption 應用程式,請使用此提示:
What Windows Consumption Function Apps can I upgrade to Flex Consumption?
Copilot 會發現候選應用程式,並檢查其區域、執行環境、部署設定及其他相容性需求。 Discovery 會識別候選項目,但不保證每個應用程式都已準備好遷移。 在繼續前,請先檢視評估結果。
若要移轉特定應用程式,請使用開始移轉中的提示。
評估現有的應用程式
Azure 技能會自動幫你執行這些任務。 使用Azure技能時,直接進入開始遷移。
遷移前,先快速檢查這份清單,確保你的應用程式已準備好。 大多數應用程式都能順利通過這些檢查:
使用 Copilot 時,請在不建立目標應用程式的情況下要求評估:
Assess whether my Windows Consumption Function App <APP_NAME> is ready to migrate to Flex Consumption.
請用你的來源應用程式名稱替換 <APP_NAME> 。 Copilot 會產生相容性評估,並記錄阻礙因素及所需準備事項。 對於 Windows 應用程式,也要檢查 Windows 專用的程式碼相依關係。
確認區域相容性
請確認 Flex Consumption 方案目前在與您要移轉的取用方案應用程式相同的地區中受到支援。
確認: 當
az functionapp flex-migration list指令輸出或Copilot評估將你的應用程式納入eligible_apps清單時,Flex Consumption 方案會支援你目前 Linux Consumption 應用程式所使用的相同區域。 在此情況下,您可以繼續 驗證語言堆疊相容性。
需要採取行動:在輸出包含你的應用程式於 清單中時,你會看到顯示為
ineligible_apps的錯誤訊息。 在這種情況下,Flex Consumption 方案在你目前 Linux Consumption 應用程式使用的區域不支援。
Copilot 會檢查來源應用程式區域是否提供 Flex Consumption,並將結果記錄在評估中。 如果該區域不受支援,請先處理位置選擇,再建立目標應用程式。
如果您的區域目前不受支援,但仍選擇移轉函式應用程式,您的應用程式必須在支援 Flex 取用方案的不同區域中執行。 不過,在其他已連線服務的不同區域中執行您的應用程式,可能會造成額外的延遲。 在完成移轉之前,請確定新區域可以符合您應用程式的效能需求。
驗證語言堆疊相容性
Flex Consumption 方案並不支援所有 Functions 語言堆疊。 下表指出目前支援哪些語言堆疊:
| 堆疊設定 | 堆疊名稱 | 支援 |
|---|---|---|
dotnet-isolated |
.NET(孤立工人模型) | ✅ 是 |
node |
JavaScript/TypeScript | ✅ 是 |
java |
Java | ✅ 是 |
python |
Python | ✅ 是 |
powershell |
PowerShell | ✅ 是 |
go |
Go | ✅ 是 |
dotnet |
.NET(進行中模型) | ❌ 否 |
custom |
自訂處理程式 | ✅ 是 |
Confirmed: 如果
az functionapp flex-migration list指令或Copilot評估將你的應用程式納入eligible_apps清單,表示你的 Linux Consumption 應用程式已經使用了 Flex Consumption 支援的語言堆疊,你可以繼續驗證堆疊版本相容性。
需要採取行動: 如果輸出中包含了你的應用程式在
ineligible_apps清單中,並且顯示錯誤訊息為Runtime '<name>' not supported for function apps on the Flex Consumption plan.,這表示你的 Linux Consumption 應用程式正在執行非 Flex Consumption 支援的運行時環境。
如果您的函式應用程式使用不支援的執行階段堆疊:
- 對於在進程內與執行階段(
dotnet)一起執行的 C# 應用程式,你必須首先將應用程式遷移到 .NET 隔離。 如需詳細資訊,請參閱 將 C# 應用程式從進程內模型遷移至隔離的背景工作模型。
Copilot 在評估時讀取來源執行階段和 Functions 主機版本。 不支援的工作型執行環境或非版本 4 的 Functions 主機版本,遷移前需先準備。
確認堆疊版本相容性
遷移前,請確認在目前區域的彈性消耗計畫中,您的應用程式的執行階段堆疊版本是否受到支援。
已確認: 如果
az functionapp flex-migration list指令或 Copilot 評估將你的應用程式列入eligible_apps清單,表示你的 Linux Consumption 應用程式已經使用由 Flex Consumption 支援的語言堆疊版本,你可以繼續Verify 部署插槽使用率。
需要採取行動:如果輸出的 清單中包含了你的應用程式,並且出現錯誤訊息指出
ineligible_apps,這表示你的 Linux Consumption 應用程式沒有運行在 Flex Consumption 支援的執行環境上。
Copilot 會比較原始語言版本與目標區域中 Flex Consumption 支援的版本。 當 Azure 設定缺失或模糊時,它會使用專案或部署套件的元資料;當證據中沒有標示出單一支援版本時,會要求你選擇目標版本。
如果你的功能應用程式使用不支援的語言堆疊版本,先將 應用程式程式碼升級到支援版本 ,再遷移到 Flex Consumption 方案。
確認部署位置使用量
消耗計劃應用程式可以定義部署插槽。 欲了解更多資訊,請參閱 Azure Functions 部署時段。 不過,Flex 用量計畫目前不支援部署插槽。 遷移前,先確認你的應用程式是否有部署時段。 如果有此情況,請定義在彈性使用量方案中執行時,如何在不使用部署位置的情況下管理應用程式的策略。
已確認:當您目前的應用程式已啟用部署位置時,
az functionapp flex-migration list命令或 Copilot 評估會在eligible_apps清單中顯示您的函式應用程式,但不會加上警告。 繼續 驗證憑證的使用。
需要採取動作:您目前的應用程式已啟用部署位置,且輸出會在
eligible_apps清單中顯示您的函式應用程式,但會附上以下警告:The site '<name>' has slots configured. This condition doesn't block migration, but please note that slots aren't supported in Flex Consumption.
Copilot 會偵測來源部署位置並將其記錄在評估中。 由於彈性使用量不支援部署位置,請選擇如何整合其功能或改用獨立應用程式後,再繼續。
如果您的函式應用目前使用部署插槽,您目前無法在 Flex 用量方案中重現此功能。 遷移前,請考慮以下選項:
- 重新架構你的應用程式,讓它使用獨立的功能應用程式。 如此一來,您就可以開發並測試函式程式碼,然後將其部署到第二個非生產應用程式,而不是使用部署位置。
- 將任何新的程式碼或功能從部署插槽移轉到主要(生產)插槽。
確認憑證的使用
Flex Consumption 方案支援透過網站範圍憑證模型使用 TLS/SSL 憑證。 與其他主機方案不同,後者憑證會在同一區域和資源群組的應用程式間共享,Flex Consumption 憑證則是針對每個應用程式進行範圍。 如果你現有的應用程式使用憑證,請注意以下差異:
-
WEBSITE_LOAD_CERTIFICATESFlex Consumption 方案中不會使用該應用程式設定。 相反地,你可以透過入口網站中的 「可存取應用程式」代碼 切換,讓每張憑證都能存取你的程式碼。 欲了解更多資訊,請參閱 「讓你的程式碼可存取憑證」。 - 因為 Flex Consumption 在 Linux 上運行,你的程式碼必須從檔案路徑載入憑證(公開時用
/var/ssl/certs,私密用/var/ssl/private),而不是從 Windows 憑證庫。 - 每個應用程式最多支援三個私人憑證和三個公開憑證(.cer)。
確認: 如果
az functionapp flex-migration list指令或 Copilot 評估將你的應用程式納入eligible_apps清單,表示你的 Linux Consumption 應用程式相容,你可以繼續 驗證你的 Blob 儲存觸發。 如果你的應用程式使用憑證,遷移後需要將它們加入新應用程式。
需要採取行動:如果輸出在
ineligible_apps清單中列出你的應用程式,且顯示憑證相關錯誤,請檢視 網站範圍憑證的相關考量,並確認你的應用程式可在憑證限制內運作。
Copilot 會盤點來源應用程式使用的憑證,並檢查站台範圍的憑證限制。 它不會自動轉移憑證。 透過使用網站範圍的憑證程序重新新增所需憑證,並更新讀取 Windows 憑證儲存庫的程式碼,使其使用 Linux 憑證檔案路徑。
如果您的應用程式使用憑證,請規劃於遷移後使用網站範圍憑證程序,將憑證重新新增至新的 Flex Consumption 應用程式中。 確保你的應用程式憑證需求符合 網站範圍 限制(每個應用程式 3 個私人 + 3 個公開)。
確認您的 Blob 儲存體觸發器
目前彈性使用量方案僅支援 Azure Blob 儲存體的事件型觸發程序,這類觸發程序是以使用 Source 做為 EventGrid 設定來定義的。 此方案不支援使用容器輪詢、且 Source 設定為 LogsAndContainerScan 的 Blob 儲存體觸發程序。 因為容器的輪詢機制為預設設定,你必須判斷是否有任何 Blob 儲存觸發器使用預設 LogsAndContainerScan 的來源設定。 如需詳細資訊,請參閱 Blob 容器上的觸發程序 (部分機器翻譯)。
確認:如果
az functionapp flex-migration list命令或 Copilot 評估在eligible_apps清單中包含你的應用程式,代表你的 Linux Consumption 應用程式沒有使用輪詢式 Blob 儲存觸發器。 您可以繼續 考慮相依服務。
需要採取行動: 如果在輸出中看到你的應用程式出現在
ineligible_apps清單中,並且有錯誤訊息顯示為The site '<name>' has blob storage triggers that don't use Event Grid as the source: <list> Flex Consumption only supports Event Grid-based blob triggers. Please convert these triggers to use Event Grid or replace them with Event Grid triggers before migration.,則表示你的 Linux Consumption 應用程式不相容於 Flex Consumption。
Copilot 會依類型識別 Blob 觸發繫結,並標記任何其來源未明確指定為 EventGrid 的觸發器。 它指導部署前所需的程式碼變更與事件訂閱設定。
如果您的應用程式有任何未擁有 Azure 事件方格來源的 Blob 儲存體觸發程序,則必須先變更為 Azure 事件方格來源,才能移轉至彈性使用量方案。
這很重要
在轉換輪詢 Blob 觸發器前,先確認事件網格能到達目標函式應用程式的事件傳遞端點。 Event Grid 推送不支援透過私有端點的傳遞。 若目標僅為私有,遷移前先解決事件傳遞架構;僅靠虛擬網路整合無法提供事件網格的入站連線。
將現有 Blob 記憶體觸發程式變更為事件方格來源的基本步驟如下:
在 Blob 儲存體觸發程式定義中新增或更新
source屬性為EventGrid,然後重新部署應用程式。在您的函式應用程式中建置端點 URL,以供事件訂閱使用。
在您的 Blob 儲存體容器上建立事件訂閱。
更多資訊請參閱 教程:使用事件訂閱觸發 Azure Functions 於 blob 容器。
檢查 Windows 專用的程式碼相依關係
Flex Consumption 可在 Linux 上執行。 檢查你的應用程式是否有僅限 Windows 的 API、套件、原生二進位檔、Windows 專屬路徑與大小寫假設、PowerShell 模組,以及對 Windows 憑證存放區的存取。 針對 .NET Framework 或為 Windows 執行時識別碼發佈的應用程式也需要進行準備作業。
Flex Consumption 不支援 PowerShell 管理的相依性。 遷移前,將所有必要的 PowerShell 模組與應用程式一併封裝在其根 Modules 目錄中,並確認這些模組支援 Linux。 單靠 requirements.psd1 檔案並不能在目標應用程式上安裝模組。 欲了解更多資訊,請參閱 PowerShell 相依管理。
在評估過程中,Copilot 會提供啟發式依賴性掃描。 盡可能提供本機來源目錄或已簽出的儲存庫。 若原始碼無法取得,Copilot 可以擷取已部署的套件,但編譯產物可能會限制掃描覆蓋範圍。 掃描並不全面,你必須負責驗證 Linux 相容性。
在部署到新應用程式前,先建立並驗證任何必要的程式碼變更。 如果你無法移除必須的 Windows 依賴,建議考慮 Windows 的 Premium 方案,而非 Flex Consumption。
考慮相依服務
小提示
簡單的只支援 HTTP 的應用程式? 如果你的函式只使用 HTTP 觸發器,且不連接其他 Azure 服務,你大概可以跳過大部分這部分。 只要記得遷移後更新任何客戶端,讓它們指向你新應用程式的網址。
由於 Azure Functions 屬於運算服務,請考慮遷移對應用程式上下游資料與服務的影響。
數據保護策略
為了在遷移過程中保護上游與下游資料,請採用以下策略:
- 等冪性:確保您的函式可以安全地處理相同的訊息多次,而不會產生負面影響。 如需詳細資訊,請參閱針對相同輸入設計 Azure Functions。
- 日誌與監控:為了追蹤訊息處理,遷移期間啟用兩個應用程式的詳細日誌。 欲了解更多資訊,請參閱 在 Azure Functions 中監控執行。
- 檢查點:針對串流觸發程序 (例如事件中樞觸發程序),請實作正確的檢查點行為來追蹤處理位置。 欲了解更多資訊,請參閱 Azure Functions 可靠事件處理。
- 平行處理:請考慮在完全移轉期間以平行方式暫時執行這兩個應用程式。 請務必仔細監視及驗證如何從上游服務處理數據。 如需詳細資訊,請參閱 用於復原的自訂多區域解決方案。
-
漸進式完全移轉:針對大量系統,請考慮藉由將部分流量重新導向至新的應用程式,來實作漸進式的完全移轉。 你可以透過像
Azure API 管理 或 Azure 應用程式閘道 這類服務來管理應用程式上游的請求路由。
觸發類型的緩解措施
規劃緩解策略以保護應用程式中特定功能觸發的資料:
| 觸發程序 | 數據的風險 | 策略 |
|---|---|---|
| Azure Blob storage | 高 | 為新應用程式中的事件型觸發程式建立個別的容器。 執行新的應用程式時,將用戶端切換為使用新的容器。 在停止舊應用程式之前,應允許原始容器完全處理完畢。 |
| Azure Cosmos DB | 高 | 為新的應用程式建立專用租用容器。 將此新的租用容器設定為 leaseCollectionName 新應用程式中的組態。需要您的函式具有等冪性,或是您必須能處理重複的變更摘要處理結果。 在新應用程式中將組態 StartFromBeginning 設定至 false,以避免重新處理整個摘要。 |
| Azure 事件方格 | 中等 | 在新應用程式中重新建立相同的事件訂用帳戶。 您的 函式必須是等冪的 ,或者您必須能夠處理重複事件處理的結果。 |
| Azure 事件中樞 | 中等 | 建立新的 取用者群組 以供新應用程式使用。 如需詳細資訊,請參閱 事件方格觸發程式的移轉策略。 |
| Azure 服務匯流排 | 高 | 建立新的主題或佇列,供新應用程式使用。 更新寄件者和用戶端以使用新的主題或佇列。 原始主題空白之後,請關閉舊的應用程式。 |
| Azure 儲存體 佇列 | 高 | 建立新的佇列以供新應用程式使用。 更新寄件人和用戶端以使用新的佇列。 原始佇列空白之後,請關閉舊的應用程式。 |
| HTTP | 低 | 請記得在移轉之後,將用戶端和其他應用程式或服務切換為以新的 HTTP 端點為目標。 |
| 計時器 | 低 | 在完全移轉期間,請務必錯開兩個應用程式之間的計時器排程,以免這兩個應用程式同時執行。 在新的應用程式成功執行後,停用舊應用程式中的計時器觸發器。 |
預先移轉工作
在建立新的 Flex Consumption 應用程式前,先蒐集一些關於你目前應用程式的資訊。 此步驟確保過渡過程中不會失去任何設定。
使用 Copilot 時,此技能會將此組態做為移轉工作流程的一部分進行清查。 檢閱其結果和決定,而不是再次執行手動命令。
小提示
這個步驟基本上就是複製貼上的工作。 從現有應用程式收集設定,這樣你就能套用到新的應用程式。
遷移前請完成以下任務:
收集應用程式設定
如果你打算使用相同的觸發器、綁定來源及應用程式設定中的其他設定,請先注意你現有的消費方案應用程式中目前的應用程式設定。
Copilot 在不顯示秘密值的情況下會審查應用程式設定名稱。 它會詢問是否要複製篩選的來源設定,或是延後處理,以便設定隔離的目標相依性。 如果你延後這些設定,部署會等到所需的目標配置準備好。
謹慎
應用程式設定經常包含金鑰和其他共用秘密。 應用程式設定一定要安全儲存,最好是加密。 為了提升安全性,建議在新的 Flex Consumption 方案應用程式中使用 Microsoft Entra ID 與受管理身份驗證,而非共享秘密。
收集應用程式組態
除了應用程式設定之外,還有其他應用程式設定。 從現有應用程式擷取這些設定,這樣你才能在新應用程式中正確重建。
檢閱這些設定。 如果這些元件在現有應用程式中存在,請決定是否在新的 Flex Consumption 計劃應用程式中重新創建:
| 設定 | 設定 | 評論 |
|---|---|---|
| CORS 設定 | cors |
確定您的用戶端可能需要的任何現有跨來源資源共用 (CORS) 設定。 |
| 自訂網域 | 如果你的應用程式目前使用的網域不是 *.azurewebsites.net,你需要將目前的網域映射更換為指向新應用程式的自訂網域映射。 |
|
| HTTP 版本 | http20Enabled |
判斷您的應用程式是否需要 HTTP 2.0。 |
| 僅限 HTTPS | httpsOnly |
判斷是否需要 TSL/SSL 才能存取您的應用程式。 |
| 傳入的用戶端憑證 | clientCertEnabledclientCertModeclientCertExclusionPaths |
設定使用憑證進行驗證的用戶端要求需求。 |
| 最大橫向擴展限制 | WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT |
設定擴展實例的數量限制。 預設最大值為 200。 此值可在您的應用程式設定中找到,但在 Flex 取用方案應用程式中,它會改為新增為網站設定 (maximumInstanceCount)。 |
| 最低入站 TLS 版本 | minTlsVersion |
設定應用程式所需的最低 TLS 版本。 |
| 最小輸入 TLS 加密 | minTlsCipherSuite |
設定應用程式的最低 TLS 加密需求。 |
| 已掛接的 Azure 檔案儲存體共用 | azureStorageAccounts |
判斷您的應用程式中是否有任何明確掛接的檔案共用(僅限Linux)。 |
| SCM 基本驗證發佈憑證 | scm.allow |
判斷scm發佈網站是否已啟用。 雖然出於安全性考慮不建議使用,但某些發佈方法需要它。 |
備註
沒有可供盤點或遷移的後量子 TLS 設定。
minTlsVersion 控制最低接受的 TLS 協定版本,並 minTlsCipherSuite 控制密碼套件的選擇。 任一屬性皆不控制用於金鑰交換的 TLS 支援群組。 支援 TLS 1.3 及混合群組的用戶端可自動與平台前端協商 X25519MLKEM768 ;不支援群組的用戶端則使用支援的經典金鑰交換。 詳情請參閱 Azure App 服務 中的後量子混合金鑰交換。
Copilot 會清查網站設定、縮放限制、CORS、自訂網域及其他組態。 它會記錄評估中未被支持或手動處理的項目。 在這次 Windows 遷移中,明確的 Azure 檔案儲存體 掛載中繼資料僅供盤點使用。
識別受控識別和角色型存取
遷移前,請記錄您的應用程式是否依賴系統指派的管理身份或任何使用者指定的管理身份。 確定這些身份所獲得的角色基礎存取控制(RBAC)權限。 您必須重新建立系統指派的受管理的身分識別,並在您的新應用程式中設定任何角色指派。 你可以在新應用程式中重複使用使用者指派的管理身份。
Copilot 會清查系統指派與使用者指派的受控識別及其角色指派。 它利用此清單來設定目標的身分,並重新建立對適當資源的必要存取權限。
識別內建驗證設定
在遷移到 Flex Consumption 之前,請收集任何內建認證設定的相關資訊。 如果你想讓你的應用程式使用相同的客戶端認證行為,必須在新應用程式中重新建立它們。 更多資訊,請參閱 Azure Functions 中的 Authentication and authorization。
請特別注意重新導向 URI、允許的外部重新導向和令牌設定,以確保已驗證用戶的順暢轉換。
Copilot 會盤點已啟用的提供者與驗證行為,且不會暴露提供者的機密。 它識別特定目標的回調 URI,並在程式碼部署前指導提供者設定。 它不會自動複製提供者的註冊或機密資料。
審查入站存取限制
你可以在消費方案中設定 應用程式的入站存取限制 。 您可能想要在新應用程式中維護這些限制。 對於你定義的每個限制,務必捕捉以下特性:
- IP 位址或 CIDR 範圍
- 優先順序值
- 動作型態 (允許/拒絕)
- 規則的名稱
Copilot 會盤點並重建相容的存取限制。 它不會為了讓部署健康情況檢查或 HTTP 驗證成功而自動放寬這些限制。
在 Flex 彈性用量方案中執行時,您可以重新建立這些入站 IP 型限制。 您可以藉由實作其他網路限制,例如虛擬網路整合和輸入私人端點,進一步保護您的應用程式。 如需詳細資訊,請參閱虛擬網路整合 \(部分機器翻譯\)。
開始移轉
這很重要
若所選主機或部署儲存帳戶已停用共用金鑰存取,或您的組織需要無金鑰的儲存體存取,請為主機儲存與部署儲存設定管理式身分識別驗證及所需的角色指派。 本文所述的基本基於 CLI 的建立流程使用儲存連接字串。 使用金鑰建立應用程式並在之後轉換,並不符合在佈建時禁止共用金鑰驗證的需求。 欲了解更多資訊,請參閱 基於身份的主機儲存連線及設定部署設定。
如果你在 「識別 」區塊使用了發現提示,該技能已經評估、建立並設定了你的新 Flex Consumption 應用程式。 你可以跳過這部分,直接進入 遷移步驟。
如果你已經知道要遷移哪個應用程式,請使用這個提示:
migrate my app <APP_NAME> to flex consumption
此技能能自動處理評估、應用程式建立及設定遷移——相當於指令 az functionapp flex-migration start 及其驗證步驟。
成功開始遷移後,繼續 取得程式碼部署套件。
如果你已經知道要遷移哪個應用程式,請使用這個提示:
Migrate my Windows Consumption Function App <APP_NAME> to Flex Consumption.
請用你的來源應用程式名稱替換 <APP_NAME> 。 Copilot 會呈現遷移計畫、進行評估、盤點配置,並在來源旁建立新的 Flex Consumption 應用程式。
預設情況下,工作流程會為目標應用程式名稱建議 <APP_NAME>-flex。 Copilot 會要求你在建立目標應用程式前,選擇是重複使用原始儲存帳號、建立新帳號,或是使用特定現有帳號。 你可以要求不同的目標名稱,或在提示中說明你的儲存偏好。 請檢視儲存空間的選擇,因為共用相依性可能會讓兩個應用程式同時處理相同的事件。
Copilot 會檢查所選儲存體帳戶是否允許使用共用金鑰驗證,並詢問有關僅限身分識別原則的需求。 如果不允許使用金鑰建立,Copilot 會在建立目標應用程式前暫停。 使用以身分識別優先的基礎架構即程式碼,在同一訂用帳戶中佈建一個專屬於此移轉的空白彈性使用量應用程式。 配置主機與部署儲存體的受控識別存取、所需角色指派及監控。 先不要部署函式程式碼。 如需佈建範例,請參閱 Flex Consumption 基礎結構即程式碼範例。
回傳目標的完整 Azure 資源 ID 和已儲存的進度檔案路徑。 Copilot 會驗證現有目標資源,並在您核准後,恢復組態與部署,完全無需建立新的應用程式。 請使用此提示:
Resume the Flex Consumption migration for <APP_NAME> using progress at <PROGRESS_FILE_PATH>.
I provisioned a keyless target at <TARGET_RESOURCE_ID>. Use that existing target; do not create another app.
部署前,Copilot 會指導 Windows 到 Linux 的程式碼準備、目標設定、內建認證及非 HTTP 觸發安全。 接著,它提供透過更新的管線、本地專案或相容的部署套件來部署。
預設情況下,Copilot 會在 .azure-upgrade/<SOURCE_APP_NAME>/upgrade-status.md 中記錄進度。 若要繼續,請使用此提示:
Resume the Flex Consumption migration for <APP_NAME>.
取得程式碼部署套件
要重新部署你的應用程式,你需要專案的原始檔案或部署套件。 理想狀況下,你應該把專案檔案放在原始碼管理中,這樣你就能輕鬆把函式程式碼重新部署到新應用程式。 如果您有原始程式碼檔案,可以略過本節,繼續擷取效能基準 (選用)。
如果你已經無法存取專案原始檔案,可以在 Azure 的現有 Consumption Plan 應用程式下載目前的部署套件。 部署套件的位置取決於你是用 Linux 還是 Windows。
Linux 上的取用方案應用程式會在下列其中一個位置中維護部署 zip 套件檔案:
預設主機儲存體帳戶 (
scm-releases) 中名為AzureWebJobsStorage的 Azure Blob 儲存體容器。 此容器是在 Linux 上應用程式的消耗方案的預設部署來源。如果您的應用程式的
WEBSITE_RUN_FROM_PACKAGE設定是 URL,則該套件會位於您維護的可從外部存取的位置。 外部套件應該裝載於具有限制存取權的 Blob 記憶體容器中。 如需詳細資訊,請參閱 外部套件 URL。
小提示
如果您將儲存帳戶限制為僅允許受管理的身份存取,您可能需要將 Azure 帳戶新增到 Storage Blob Data Reader 角色,以授予對儲存容器的讀取權限。
部署套件會透過以下 squashfs 格式進行壓縮。 若要查看套件內的內容,您必須使用可解壓縮此格式的工具。
使用下列步驟,從您目前的應用程式下載部署套件:
Copilot 遷移技能嘗試將你現有的程式碼專案下載並重新部署到你的新應用程式中。 若失敗,則會引導你取得並部署程式碼套件,作為遷移工作流程的一部分。 你可以跳過此部分,繼續閱讀 遷移步驟。
專案來源檔案的位置取決於 WEBSITE_RUN_FROM_PACKAGE 應用程式設定,如下所示:
WEBSITE_RUN_FROM_PACKAGE 值 |
來源檔案位置 |
|---|---|
1 |
檔案都放在一個壓縮包裡,儲存在 WEBSITE_CONTENTAZUREFILECONNECTIONSTRING 設定所定義的儲存帳號Azure 檔案儲存體份額裡。
WEBSITE_CONTENTSHARE 設定用於定義檔案共享的名稱。 |
| 端點 URL | 這些檔案位於您維護的可從外部存取的位置中的 zip 套件。 外部套件應該裝載於具有限制存取權的 Blob 記憶體容器中。 如需詳細資訊,請參閱 外部套件 URL。 |
Copilot 會先要求本地來源目錄。 若來源無法取得,系統會從來源應用程式的內容分享或外部套件 URL 取回已部署的套件。 它會檢查套件是否適合 Linux 和 Flex Consumption 使用;Windows 專用的建置需要事先準備,而非直接重新部署。
擷取效能基準(選擇性)
如果你打算根據遷移到 Flex Consumption 計畫來驗證應用程式的效能提升,可以考慮擷取你目前方案的效能基準。 接著,你可以將它們與你在 Flex Consumption 方案中運行的應用程式相同的基準測試做比較。
小提示
請在條件相似的情況下比較表現,例如一天中的時間、星期幾和客戶負載。 嘗試盡可能地緊接著運行這兩個基準測試。
以下是您在進行結構化效能測試時可考慮的一些基準:
| 建議的基準 | 評論 |
|---|---|
| 冷啟動 | 測量在閒置一段時間後,從第一個要求到第一個回應所花費的時間。 |
| 吞吐量 | 利用 負載測試工具 測量每秒最大請求,以判斷應用程式如何處理並行請求。 |
| 延遲 | 在各種負載條件下追蹤P50、P95和P99的回應時間。 您可以在 Application Insights 中監視這些計量。 |
請使用此 Kusto 查詢,檢視 Application Insights 中建議的延遲回應時間:
requests
| where timestamp > ago(1d)
| summarize percentiles(duration, 50, 95, 99) by bin(timestamp, 1h)
| render timechart
移轉步驟
要將您的功能從消費方案應用程式遷移到彈性消費方案應用程式,請遵循以下主要步驟:
驗證已建立和設定的 Flex Consumption 應用程式
執行 az functionapp flex-migration start 指令後,請確認您的新 Flex Consumption 應用程式已成功建立且設定正確。 以下是驗證移轉結果的一些步驟:
Copilot 遷移技能會自動驗證新應用程式,作為遷移的一部分。 如果你是透過 Start the migration for Linux 中的 Copilot 提示來開始遷移,該技能已經驗證應用程式已正確創建並配置。 你可以跳過這部分,繼續設定 內建認證。
回顧遷移摘要
自動遷移指令會傳輸大多數設定。 不過,請手動驗證這些項目是否已遷移。 你可能需要手動設定:
- 憑證:透過使用 站點範圍憑證流程,重新加入 TLS/SSL 憑證於 Flex Consumption 應用程式。
- 部署插槽:Flex Consumption 不支援。
- 內建認證設定:你需要手動重新設定這些設定。
- CORS 設定:根據你的設定,可能需要手動驗證這些設定。
若有關鍵設定缺失或錯誤,請依照本文
計劃最終審查
繼續進行移轉程式之前,請花點時間執行這些最後的準備步驟:
使用 Copilot 時,請在核准建立目標資源與部署前,先檢閱評估、組態詳細目錄、程式碼變更、部署選擇及觸發程序安全決策。 成功的僅限驗證移轉並不代表生產流量或觸發程序會完全移轉。
檢閱所有收集到的信息:流覽您在上一個評量和預先移轉小節中記載的所有附註、組態詳細數據和應用程式設定。 如果有任何不清楚的地方,請重新執行 Azure CLI 指令,或從入口網站取得資訊。
定義您的移轉計劃:根據您的結果,為您的移轉建立檢查清單,以醒目提示:
- 任何需要特別注意的設定
- 在移轉期間可能受影響的觸發程式和系結或其他相依性
- 移轉後驗證的測試策略
- 因應非預期問題的復原計劃
停機規劃:考慮何時停止原始功能應用程式,以避免資料遺失及事件重複處理,以及遷移可能對使用者或下游系統的影響。 在某些情況下,您可能需要 先停用特定函式 ,再停止整個應用程式。
仔細的最終檢閱有助於確保更順暢的移轉程式,並將忽略重要設定的風險降到最低。
在彈性取用方案中建立應用程式
你可以在 Flex Consumption 計畫中建立函式應用程式,並以多種方式建立其他必需的 Azure 資源:
| 建立選項 | 參考文章 |
|---|---|
| GitHub Copilot | 請在開始移轉中使用 Windows 命令提示字元。 Copilot 會確認目標資源,並依照導引式工作流程建立應用程式。 |
| Azure CLI | 建立 Flex 使用量應用程式 |
| Azure 入口網站 | 在Azure入口網站建立函式應用程式 |
| 基礎結構即程式碼 |
ARM 範本 azd Bicep Terraform |
| Visual Studio Code | Visual Studio Code部署 |
| Visual Studio | Visual Studio部署 |
小提示
若可能,請使用 Microsoft Entra ID 作為認證,而非包含共享金鑰的連線字串。 使用受控識別是一種最佳做法,可藉由排除直接在應用程式設定中儲存共享密碼的需求,來改善安全性。 如果你原本的應用程式使用連線字串,Flex Consumption 方案則支援管理身份。 這些連結大部分都會示範如何在函式應用程式中啟用受控識別。
在新應用程式中套用已移轉的應用程式設定
在部署程式碼前,請先用你原本功能應用程式中相關的 Flex Consumption 方案設定來設定新應用程式。
這很重要
在 Flex 取用方案中執行時,並非所有的取用方案應用程式設定都受到支援。 如需詳細資訊,請參閱 彈性使用量方案淘汰。
核准後,Copilot 會複製支援的應用程式設定,且不會顯示或保留原始祕密值。 它保留目標擁有的儲存空間和 Application Insights 設定。 它也會審查 Linux 上所需的從 : 轉換為 __ 名稱轉換,若來源名稱對應不明確則停止。
套用其他應用程式設定
找出你在 遷移前收集 到的舊應用程式設定清單,並在新應用程式中設定。
備註
沒有後量子 TLS 設定可套用。 Consumption 與 Flex Consumption 應用程式皆使用平台管理的協商方式,與相容的用戶端進行協商;遷移憑證或自訂網域不會改變後量子金鑰交換的適用資格。 最低 TLS 和 cipher-suite 設定不會控制支援的群組。 詳情請參閱 Azure App 服務 中的 Post-quantum hybrid key exchange。
Copilot 會從清單套用相容的站點配置並驗證目標。 未支援的設定和需要手動處理的項目仍是明確的後續工作,而非被默默複製。
設定規模和並行設定
彈性使用量方案採用個別函式調整規模機制。 應用程式內的每個功能會根據其工作負載獨立擴展。 縮放性更嚴格地與並發設定相關。 這些設定幫助你根據目前並行執行量做出縮放決策。 如需詳細資訊,請參閱彈性使用量方案文章中的個別函式縮放 (部分機器翻譯) 和並行 (部分機器翻譯)。
如果你想讓你的新應用程式像原本一樣擴展,請考慮並行設定。 設定較高的並行值可能會導致建立較少的實例來處理相同的負載。
如果你在原本的應用程式設定自訂的擴展上限,就可以套用到新的應用程式。 否則,請直接跳到下一部分。
預設的最大實例數是 100。 設定在1到1,000之間。
備註
將HTTP函式應用程式的最大實例數降至40以下,可能導致頻繁的請求失敗及流量超過容量時的限速窗口延長。 此設定僅適用於可接受有限規模擴展且經過完整測試的進階情境。
Copilot 會在套用前,檢查任何來源最大擴大設定是否在支援的彈性使用量範圍內。 如果來源沒有設定自訂限制,它會保留目標預設值。 移轉後檢視特定工作負載的並行度調校。
設定任何自訂網域和 CORS 存取權
如果你原本的應用程式有任何綁定的自訂網域或 CORS 設定,請在新應用程式中重新建立它們。 欲了解更多自訂網域資訊,請參閱 在 Azure App 服務 設定現有自訂網域。
Copilot 會重建相容的 CORS 設定並指導自訂網域設定。 任何對來源綁定、DNS 或生產路由的變更都需要另外的審核;建立目標應用程式並不會完成流量切換。
設定受控識別並指派角色
你如何在新應用程式中設定受管理身份,取決於管理身份的種類:
| 受控識別類型 | 建立身分識別 | 角色指派 |
|---|---|---|
| 使用者指派 | 可選 | 您可以繼續使用相同的使用者分配的管理識別來配合新應用程式。 您必須將這些身分識別重新指派給 Flex Consumption 應用程式,並確認這些身分識別在遠端服務中仍具有正確的角色指派。 如果您選擇為新的應用程式建立新的身分識別,您必須指派與現有身分識別相同的角色。 |
| 系統指派 | 是的 | 由於每個函式應用程式都有自己的系統指派受控識別,因此您必須在新應用程式中啟用系統指派的受控識別,並重新指派與原始應用程式中相同的角色。 |
正確重新建立角色指派是確保你的函式應用程式在遷移後仍能存取 Azure 資源的關鍵。
小提示
如果你原本的應用程式使用連線字串或其他共享秘密來進行認證,這是個很好的機會,可以透過改用 Microsoft Entra ID 認證來提升應用程式安全性,並搭配受管理身份。 欲了解更多資訊,請參閱 Azure Functions 中的遠端服務連線設定。
設定網路存取限制
如果你原本的應用程式有任何基於 IP 的入站存取限制,請重新建立你想保留的入站存取規則。
小提示
Flex Consumption 方案 完全支援虛擬網路整合。 因為有這些支援,遷移後你也可以使用入站的私有端點。 如需詳細資訊,請參閱私人端點。
Copilot 會重建相容的原始碼存取限制並驗證這些限制。 如果這些限制阻止了直接的 HTTP 測試,它會將驗證狀態記錄為延後處理,而非自動開啟存取。
啟用監視
在彈性取用方案中啟動新的應用程式之前,請確定已啟用Application Insights。 當你設定 Application Insights 時,可以排除在程式碼部署和啟動過程中出現的任何問題。
實作涵蓋應用程式計量、記錄和成本的完整監視策略。 透過此策略,您可以驗證遷移成功,快速識別問題,並優化新應用程式的效能與成本。
如果您打算比較這個新應用程式與目前的應用程式,請確定您的配置也會收集必要的基準檢驗以進行比較。 如需詳細資訊,請參閱 設定監視。
使用 Copilot 時,該技能會在部署前驗證目標的 Application Insights 設定。 它會保留來源使用 Microsoft Entra 認證的資料擷取,並在部署後驗證遙測資料。
設定內建驗證
如果你原本的應用程式使用內建客戶端認證(有時稱為 Easy Auth),請在新應用程式中重新建立。 如果你打算重複使用相同的客戶端註冊,務必在認證提供者中設定新應用程式的認證端點。
Linux 的 Copilot 遷移技能並不會自動設定內建的認證設定。 請使用 Azure CLI 或 Azure portal 分頁手動重新建立你的認證設定。
Copilot 會在目標上按提供者引導進行組態與驗證。 您必須直接透過入口網站、現有的秘密設定或 金鑰保存庫 參考來設定提供者祕密,並註冊目標回撥 URI。 如果驗證遭延遲,Copilot 會在部署程式碼前停止,避免目標暴露先前受保護但未要求驗證的端點。
將你的應用程式程式碼部署到新的 Flex Consumption 資源
在根據原應用程式設定新的 Flex Consumption 方案後,再將程式碼部署到 Azure 的新應用程式資源。
謹慎
部署成功後,新應用程式啟用的觸發器可立即開始處理連接服務的資料。 為了減少重複資料並防止在啟動新應用程式並關閉原始應用程式時的資料遺失,請檢視你在 緩解措施中依觸發器類型定義的策略。
部署前,Copilot 會分類每個觸發器,並建議停用可能處理生產事件或執行排程的非 HTTP 函式。 如果您核准停用,它會在部署前寫入並驗證停用設定,部署後再驗證有效的函式狀態。 HTTP 功能會持續啟用,因為用戶端必須被重新導向到新的主機名稱。
包含連字號 (-) 的函式名稱在 Linux 上無法透過每函式應用程式設定加以停用。 針對這些函式,Copilot 需要獨立的安全決策:隔離相依性、重新命名與重新封裝、核准以來源優先的完全移轉,或明確接受主動處理。 它不會把無效的停用旗標視為保護。
在 HTTP 切換作業前先規劃功能鍵處理。 新應用程式有自己的主控鍵和功能鍵。 對於使用這些金鑰的呼叫者,要麼保留相容的來源主機金鑰與 HTTP 函式金鑰,要麼更新呼叫者使用目標應用程式的金鑰,再重新導向流量。 Copilot 會詢問使用哪種策略,若選擇保留,部署後會複製並驗證所選金鑰。 在完全移轉前,針對目標端點驗證已通過驗證的要求。
Copilot 不會複製 _master 按鍵或由擴充功能管理的系統按鍵。 更新另外需要由目標產生的系統金鑰的 Webhook 整合。 保留客戶端金鑰意味著這些憑證在兩者共存時授權這兩個應用程式。
使用 Copilot 時,可選擇是更新 CI/CD 管線、發布已準備好的本地專案,或部署相容的已取得套件。 驗證後,Copilot 會引導生產切換,並在更改原始應用程式前要求明確批准。
Functions 提供數種方式來部署程式代碼,無論是從程式碼專案,還是作為現成執行的部署套件。
小提示
如果你將專案程式碼保存在原始碼倉庫中,現在正是配置持續部署流程的最佳時機。 持續部署可讓您根據連線存放庫中的變更自動部署應用程式更新。
更新你現有的部署工作流程,將原始碼部署到新應用程式:
使用 Azure Pipelines 進行建置與部署 使用 GitHub Actions
您也可以為新的應用程式建立新的持續部署工作流程。 欲了解更多資訊,請參閱持續部署Azure Functions。
移轉後工作
🎉 恭喜! 你的應用程式現在已經在 Flex Consumption 上運行。 為了充分利用你的新計畫,請考慮以下可選的後續任務:
確認基本功能
確認新的應用程式正在 Flex 取用方案中執行:
Copilot 遷移技能會在部署後驗證你的新應用程式,包括其主機計畫和功能狀態。 當刻意的存取限制阻止 HTTP 測試時,可以繼續將其延後。 在生產切換前,檢查任何已延後的測試並驗證非 HTTP 處理。 如果你需要重新驗證,請使用這個提示:
verify my flex consumption app <APP_NAME> is running correctly使用 HTTP 用戶端在您的新應用程式上至少呼叫一個 HTTP 觸發程式端點,以確保它如預期般回應。
擷取效能基準
在新應用程式執行時,執行你從原始應用程式收集的效能基準測試,例如:
| 建議的基準 | 評論 |
|---|---|
| 冷啟動 | 測量在閒置一段時間後,從第一個要求到第一個回應所花費的時間。 |
| 吞吐量 | 利用 負載測試工具 測量每秒最大請求,以判斷應用程式如何處理並行請求。 |
| 延遲 | 在各種負載條件下追蹤P50、P95和P99的回應時間。 您可以在 Application Insights 中監視這些計量。 |
請使用此 Kusto 查詢,檢視 Application Insights 中建議的延遲回應時間:
requests
| where timestamp > ago(1d)
| summarize percentiles(duration, 50, 95, 99) by bin(timestamp, 1h)
| render timechart
備註
彈性使用量方案的計量與使用量方案的計量不同。 在移轉前後比較效能時,請記住,您必須使用不同的計量來追蹤類似的效能特性。 如需詳細資訊,請參閱 設定監視。
建立自定義儀錶板
透過使用 Azure 監視器 指標與應用程式洞察,您可以在 Azure 入口網站<
考慮在 Azure 入口網站中針對你的關鍵指標設置儀表板和警示。 欲了解更多資訊,請參閱在 Azure 中監控您的應用程式。
精簡方案設定
移轉的實際效能改善和成本影響可能會根據您的應用程式特定工作負載和設定而有所不同。 Flex Consumption 方案提供數個您可以調整以精簡應用程式效能的設定。 您可能想要調整以更緊密地比對原始應用程式的行為,或平衡成本與效能。 如需詳細資訊,請參閱彈性取用一文中的 微調您的應用程式 。
更新你的資源部署檔案
如果你是用 Bicep 或 Terraform 管理功能應用基礎架構,請更新部署檔案,現在鎖定 Flex Consumption 計畫。 本節展示消耗計畫與彈性消耗計畫資源定義的主要差異。
這很重要
你無法將現有的消費方案應用程式直接轉換成 Flex Consumption。 你需要先建立新資源並命名,或刪除現有資源,才能部署 Flex Consumption 等效資源。
主要差異
在將資源部署從消耗型遷移到彈性型消耗時,請考慮以下重要變更:
| 層面 | 消費方案 | 彈性使用量方案 |
|---|---|---|
| 託管方案 SKU |
Y1 (動態) |
FC1 (彈性消費) |
| 需要計畫 | 可選(自動建立) | 必須(必須明確) |
| 操作系統 | Windows 或 Linux | 僅限 Linux |
| 設定 | 應用程式設定 |
functionAppConfig 區段 |
| 儲存內容共享 |
WEBSITE_CONTENTSHARE 設定 |
deployment.storage 中的 functionAppConfig |
以下範例說明消耗計畫與彈性消耗計畫資源定義的主要差異。 它們使用系統指派的管理身份,但並不完整。 它們不包含所有必要的資源,例如儲存帳號、應用程式洞察或所有必要的角色分配。 如需完整且可生產的範例,請參閱Flex Consumption IaC樣本。
消費計畫(前):
// Consumption plan (optional - auto-created if omitted)
resource hostingPlan 'Microsoft.Web/serverfarms@2022-03-01' = {
name: hostingPlanName
location: location
sku: {
name: 'Y1'
tier: 'Dynamic'
}
properties: {
reserved: true // Linux
}
}
resource functionApp 'Microsoft.Web/sites@2022-03-01' = {
name: functionAppName
location: location
kind: 'functionapp,linux'
properties: {
serverFarmId: hostingPlan.id
siteConfig: {
linuxFxVersion: 'DOTNET-ISOLATED|8.0'
appSettings: [
{ name: 'FUNCTIONS_EXTENSION_VERSION', value: '~4' }
{ name: 'FUNCTIONS_WORKER_RUNTIME', value: 'dotnet-isolated' }
{ name: 'AzureWebJobsStorage__accountName', value: storageAccount.name }
{ name: 'WEBSITE_CONTENTAZUREFILECONNECTIONSTRING__accountName', value: storageAccount.name }
{ name: 'WEBSITE_CONTENTSHARE', value: functionAppName }
{ name: 'APPLICATIONINSIGHTS_CONNECTION_STRING', value: appInsights.properties.ConnectionString }
{ name: 'APPLICATIONINSIGHTS_AUTHENTICATION_STRING', value: 'Authorization=AAD' }
]
}
}
identity: {
type: 'SystemAssigned'
}
}
彈性消費計畫(後):
// Flex Consumption plan (required)
resource hostingPlan 'Microsoft.Web/serverfarms@2023-12-01' = {
name: hostingPlanName
location: location
sku: {
name: 'FC1'
tier: 'FlexConsumption'
}
kind: 'functionapp'
properties: {
reserved: true
}
}
// Deployment storage container (required)
resource deploymentContainer 'Microsoft.Storage/storageAccounts/blobServices/containers@2023-05-01' = {
name: '${storageAccount.name}/default/deployments'
}
resource functionApp 'Microsoft.Web/sites@2023-12-01' = {
name: functionAppName
location: location
kind: 'functionapp,linux'
properties: {
serverFarmId: hostingPlan.id
functionAppConfig: {
deployment: {
storage: {
type: 'blobContainer'
value: '${storageAccount.properties.primaryEndpoints.blob}deployments'
authentication: {
type: 'SystemAssignedIdentity'
}
}
}
scaleAndConcurrency: {
maximumInstanceCount: 100
instanceMemoryMB: 2048
}
runtime: {
name: 'dotnet-isolated'
version: '8.0'
}
}
siteConfig: {
appSettings: [
{ name: 'AzureWebJobsStorage__accountName', value: storageAccount.name }
{ name: 'APPLICATIONINSIGHTS_CONNECTION_STRING', value: appInsights.properties.ConnectionString }
{ name: 'APPLICATIONINSIGHTS_AUTHENTICATION_STRING', value: 'Authorization=AAD' }
]
}
}
identity: {
type: 'SystemAssigned'
}
}
備註
當你使用 APPLICATIONINSIGHTS_AUTHENTICATION_STRING 配合 Authorization=AAD 時,你也必須在 Application Insights 資源中為函式應用程式的管理身份分配 Monitoring Metrics Publisher 角色。
完整的 Bicep 範例請參見Flex Consumption Bicep 範例。
遷移後的資源部署對帳
如果你用基礎設施作為程式碼來管理 Azure 資源部署,遷移到 Flex Consumption 後請更新部署檔案,以防止設定漂移。 以下是推薦的做法:
不要混用手動與資源型部署:如果你在遷移時使用Azure CLI或入口網站建立 Flex Consumption 應用程式,請在下一次部署前更新資源檔案。 否則,您的部署可能會嘗試重新建立舊的使用量方案資源。
更新資源名稱或使用生命週期管理:由於無法將 Consumption 應用程式轉換成 Flex Consumption,你有兩個選擇:
- 新資源名稱:更新你的部署程式碼,讓主機計畫和功能應用程式使用新名稱。 這種方式能讓你的舊資源保持完整,直到你確信遷移成功為止。
-
匯入現有資源:如果你想保留相同名稱,先刪除舊資源,然後讓你的部署建立新的彈性消耗資源。 或者,你可以用
terraform import將手動建立的資源匯入你的 Terraform 狀態,或在 Bicep 中引用現有資源。
確認狀態對齊:更新部署檔案後,執行計畫或預覽操作(
terraform plan或az deployment group what-if)以確認沒有意外變更。更新 CI/CD 管線:如果您的部署管線參考舊的 Consumption 計畫設定,請更新以使用新的 Flex Consumption 資源定義與部署方法。
小提示
為了減少干擾,建議在過渡期間同時同時執行舊的 Consumption 應用程式與新的 Flex Consumption 應用程式。 更新你的部署以管理新的 Flex Consumption 應用程式,確認它正常運作,然後從 Azure 和你的部署檔案中移除舊的 Consumption 應用程式資源。
移除原始應用程式 (選擇性)
小提示
不急。 先保留你原本的應用程式幾天或幾週,確認一切正常運作。 Consumption 方案只對實際使用量收費,所以保留舊版應用程式(關閉觸發器)成本不高。
當你確信新應用程式運作正常時,就可以清理原本的應用程式。 此步驟是可選的——有些團隊會保留舊應用程式作為參考或回滾選項。
這很重要
此動作會刪除原始函式應用。 如果其他應用程式使用,Consumption 方案仍會維持不變。 在繼續之前,請確保:
- 成功將所有功能遷移到新的 Flex Consumption 應用程式。
- 確認沒有流量被導向原始應用程式。
- 備份了所有相關的日誌、設定或可能需要參考的資料。
Copilot 遷移技能可在生產切換與目標驗證完成後移除原始應用程式。 如果準備工作持續延遲,或來源仍在處理生產工作負載,請保留來源應用程式。 Copilot 刪除任何東西前都會要求你明確確認。 請使用此提示:
delete my original consumption app <ORIGINAL_APP_NAME>
故障排除與復原策略
大多數遷移都能順利完成。 如果某些方法不如預期,可以試試以下這些常見問題的解決方案:
| 問題 | 解決方法 |
|---|---|
| 冷啟動效能問題 | • 檢閱 並行設定 檢查是否有遺漏的相依關係 |
| 缺少綁定 | • 驗證 擴充套件組合 • 更新系結組態 |
| 權限錯誤 | • 檢查身分識別指派和角色權限 |
| 網路連線問題 | • 驗證存取限制和網路設定 |
| 缺乏的應用洞察 | • 重新建立 Application Insights 連線 |
| 應用程式無法啟動 | 請參閱 一般疑難解答步驟 |
| 觸發程式不會處理事件 | 請參閱 一般疑難解答步驟 |
如果您在移轉生產應用程式時遇到問題,請考慮在進行疑難排解時將移轉復原至原始應用程式。
一般疑難排解步驟
針對新應用程式無法啟動或函式觸發程式未處理事件的情況,請使用下列步驟:
在 Azure 入口網站的新應用程式頁面中,選擇應用程式頁面左側窗格的診斷並解決問題。 選取 [可用性和效能],然後檢閱 [函式應用程式停機或報告錯誤] 偵測器。 欲了解更多資訊,請參閱Azure Functions診斷概述。
在應用程式頁面中,選取 [ 監視>Application Insights>檢視 Application Insights 數據 ],然後選取 [ 調查>失敗] ,並檢查是否有任何失敗事件。
選取 [監視>記錄 ],然後執行此 Kusto 查詢來檢查這些資料表是否有錯誤:
traces | where severityLevel == 3 | where cloud_RoleName == "<APP_NAME>" | where timestamp > ago(1d) | project timestamp, message, operation_Name, customDimensions | order by timestamp desc在這些查詢中,將
<APP_NAME>替換為新應用程式的名稱。 這些查詢會檢查過去一天的錯誤(where timestamp > ago(1d))。回到應用程式頁面,選擇 設定>環境變數 ,並確認所有關鍵應用程式設定都已正確傳輸。 尋找任何可能未正確移轉的已淘汰設定,或任何錯字或不正確的連接字串。 確認 預設主機記憶體連線。
選擇 設定>身份 ,並再次確認預期身份是否存在且分配到正確的角色。
在您的程式碼中,請確認所有綁定配置正確無誤,特別注意連線字串名稱、儲存佇列和容器名稱,以及在事件中樞觸發器中的消費者群組設定。
重要生產應用程式的復原步驟
如果你無法排除問題,可以考慮在持續排查過程中恢復使用原本的應用程式。
如果原本的應用程式被停止,請重新啟動它:
要求 Copilot 重新啟動原始應用程式,並還原移轉:
restart my original consumption app <ORIGINAL_APP_NAME>如果你建立了新的佇列、主題或容器,請確保客戶端被重新導向到原本的資源。
如果您修改了 DNS 或自訂網域,請還原這些變更以指向原始應用程式。
提供意見反應
如果您遇到使用本文的移轉問題,或想要提供此指引的其他意見反應,請使用下列其中一種方法來取得協助或提供意見反應:
在 Microsoft Q&A 尋求幫助 - 在 Azure Functions 倉庫 中建立問題
- 提供產品意見反應
- 建立支援票證
相關文章
- Flex 用量方案概觀
- 如何使用彈性用量計畫
- Azure CLI flex-migration 指令(僅限 Linux)
- 彈性使用量方案正式發行公告 (英文)
- Flex 消費方案專屬樣本