共用方式為

更新 Azure Functions 中的語言堆疊版本

在 Azure Functions 中，語言堆疊的支援僅限於 特定版本。 當有新版本可用時，建議您更新函數應用程式以利用新功能。 Functions 也可能會結束對舊版本的支援，這通常與社群結束支援的時間表一致。 如需詳細資訊，請參閱語言執行階段支援原則 (部分機器翻譯)。 如需各種語言的支援版本，請參閱依執行階段版本的語言 (部分機器翻譯)。

為了確保您的函數應用程式能夠繼續獲得支援，請遵循本文所述的指示將其更新到最新的可用版本。 更新函數應用程式的方式取決於數個因素：

  • 您用來開發函數應用程式的語言。 請務必在本文頂部選取您的程式設計語言。
  • 您的函數應用程式在 Azure 中執行的作業系統：Windows 或 Linux。
  • 主控方案。

附註

本文說明如何更新使用隔離的背景工作角色模型之函數應用程式的 .NET 版本。 如果您的函數應用程式在舊版 .NET 上執行，並使用內含式模型，請考慮下列選項：

先決條件

  • 具有有效訂閱的 Azure 帳戶。 免費創建一個。
  • 裝載於下列其中一個 Functions 方案中的函數應用程式：
    • 進階
    • 專用
    • 使用量

準備函數應用程式

在 Azure 中更新函數應用程式的堆疊設定之前，請先完成下列各節中的工作。

在本機驗證函數應用程式

使用新的目標版本在本機測試並驗證函數應用程式程式碼。

使用下列步驟來更新本機電腦上的專案：

  1. 確定已安裝 .NET SDK 的目標版本。

    如果您的目標是預覽版本，請參閱 預覽 .NET 版本的函式指引 ，以確保支援版本。 使用 .NET 預覽可能需要更多步驟。

  2. 更新您的引用至最新版本的 Microsoft.Azure.Functions.Worker 和 Microsoft.Azure.Functions.Worker.Sdk。

  3. 將專案的目標 Framework 更新為新版本。 針對 C# 專案，您必須更新 <TargetFramework> 檔案中的 元素。 如需版本的詳細資訊，請參閱 目標架構。

    變更專案的目標架構可能也需要變更專案程式碼之外的工具鏈元件。 例如，在 Visual Studio Code 中，您可能需要更新使用者設定或專案的 azureFunctions.deploySubpath 檔案中的 延伸模組設定。 檢查是否有對存在於專案程式碼外部之架構版本的任何相依性，作為建置步驟或持續整合與持續傳遞 (CI/CD) 管線的一部分。

  4. 對新的 .NET 版本所需的專案程式代碼進行任何更新。 檢查版本的發行備註以取得特定資訊。 您也可以使用 .NET Upgrade Assistant 來協助更新程序代碼，以回應主要版本的變更。

進行那些變更之後，請重建專案並進行測試，以確認函數應用程式如預期般執行。

移至最新的 Functions 執行環境

請確定您的函式應用程式會在最新版的 Functions 執行時間 （4.x 版） 上執行。 您可以在 Azure 入口網站或使用 Azure CLI 來判斷執行階段版本。

使用下列步驟來判斷您的 Functions 執行階段版本：

  1. 在 Azure 入口網站中，找出並選取您的函式應用程式。 在側邊功能表上，選取 [設定]>[組態]。

  2. 移至 [函式執行階段設定] 索引標籤，然後檢查 [執行階段版本] 值。 您的函式應用程式應該在 Functions 執行階段 (~4) 4.x 版本上執行。

如果您需要將函數應用程式更新至 4.x 版，請參閱將應用程式從 Azure Functions 1.x 版移轉至 4.x 版 (部分機器翻譯) 或將應用程式從 Azure Functions 3.x 版移轉至 4.x 版 (部分機器翻譯)。 請遵循這些文章中的指示，而不只是變更 FUNCTIONS_EXTENSION_VERSION 設定。

發佈函數應用程式更新

如果您更新了函數應用程式以在新版本上正確執行，請先發佈函數應用程式更新，再更新函數應用程式的堆疊組態。

秘訣

若要簡化更新流程，請將函數應用程式的停機時間降到最低，並提供復原的潛在版本，您應該將更新的函數應用程式發佈至預備位置。 如需詳細資訊，請參閱 Azure Functions 部署位置。

當您將更新的函數應用程式發佈至預備位置時，請務必遵循本文其餘部分的位置特定更新指示。 稍後會將更新的預備位置與生產位置交換。

更新堆疊設定

更新堆疊組態的方式取決於您的函數應用程式是在 Azure 中的 Windows 還是 Linux 上執行。

當您使用預備位置時，請務必將更新的目標設為正確的位置。

請使用下列步驟來更新 Java 版本：

  1. 在 Azure 入口網站中，找出並選取您的函式應用程式。 在側邊功能表上，選取 [設定]>[組態]。 如果您有預備位置，請選取特定位置。

  2. 在 [一般設定] 索引標籤上，將 [Java 版本] 更新為所需的版本。

  3. 選取 [儲存]。 當您收到重新啟動通知時，請選取 [繼續]。

請使用下列步驟來更新 .NET 版本：

  1. 在 Azure 入口網站中，找出並選取您的函式應用程式。 在側邊功能表上，選取 [設定]>[組態]。 如果您有預備位置，請選取特定位置。

  2. 在 [一般設定] 索引標籤上，將 [.NET 版本] 更新為所需的版本。

  3. 選取 [儲存]。 當您收到重新啟動通知時，請選取 [繼續]。

請使用下列步驟來更新 Node.js 版本：

  1. 在 Azure 入口網站中，找出並選取您的函式應用程式。 在側邊功能表上，選取 [設定]>[組態]。 如果您有預備位置，請選取特定位置。

  2. 在 [一般設定] 索引標籤上，將 [Node.js 版本] 更新為所需的版本。

  3. 選取 [儲存]。 當您收到重新啟動通知時，請選取 [繼續]。 這項變更會更新 WEBSITE_NODE_DEFAULT_VERSION 應用程式設定。

使用下列步驟來更新 PowerShell 版本：

  1. 在 Azure 入口網站中，找出並選取您的函式應用程式。 在側邊功能表上，選取 [設定]>[組態]。 如果您有預備位置，請選取特定位置。

  2. 在 [一般設定] 索引標籤上，將 [PowerShell Core 版本] 更新為所需的版本。

  3. 選取 [儲存]。 當您收到重新啟動通知時，請選取 [繼續]。

Windows 不支援 Python 應用程式。 改為移至 [Linux] 索引標籤。

您的函數應用程式會在您更新版本之後重新啟動。

交換位置

如果您使用預備位置來部署程式碼專案並更新設定，請將預備位置切換到生產環境。 如需詳細資訊，請參閱交換位置。

相關內容

Java 開發人員指南

C# 隔離背景工作處理序指南

Node.js 開發人員指南

Python 開發人員指南

PowerShell 開發人員指南

  • Last updated on