.NET 執行階段

總覽

Cloud Run 函式會在環境中執行，該環境包含作業系統版本、附加套件、語言支援，以及支援和叫用函式的 Functions Framework 程式庫。這個環境由語言版本識別，稱為「執行階段」。

如要瞭解一般執行階段，以及各個 .NET 執行階段使用的 Ubuntu 版本，請參閱 Cloud Run 函式執行環境。

範本套件

範本套件可協助您建立新函式。使用方法：

  1. 安裝 .NET SDK。

  2. 安裝範本套件：

    dotnet new install Google.Cloud.Functions.Templates

範本適用於 C# (預設)、F# 和 Visual Basic 這三種函式。使用範本建立新專案時，請指定 -lang f# 建立 F# 專案，或指定 -lang vb 建立 Visual Basic 專案。如需詳細資訊，請參閱：

選取 .NET Functions Framework 版本

不同版本的 .NET Functions Framework 支援不同的執行階段。 第 1 版支援 .NET Core 3.1 以上版本，範本預設為 .NET Core 3.1。第 2 版支援 .NET 6 以上版本，範本預設為 .NET 6。

如要使用 .NET Functions Framework 1 版升級現有專案，請編輯專案檔案 (或使用 Visual Studio)，將所有以 Google.Cloud.Functions 開頭的依附元件更新至最新版本，並將目標架構設為 .NET 6。

選取執行階段

Cloud Run functions 支援多個 .NET 版本，詳情請參閱「執行階段支援」頁面。部署函式時，您必須在專案檔案 (MyFunction.csproj 或類似檔案) 中，指定與目標架構對應的 .NET 執行階段。如要指定 .NET 執行階段，請按照下列步驟操作：

如果您使用的是 Google Cloud CLI，請使用 --runtime 參數指定執行階段，--entry-point 旗標會指定完整類別名稱 (FQN)。例如：

gcloud functions deploy NAME --no-gen2 --entry-point FQN --no-gen2 --runtime dotnet6 --trigger-http

如需更多部署參數，請參閱「部署 Cloud Run function」。

函式準備

您可以在本機電腦上編寫函式，然後上傳。如要準備本機電腦以進行 .NET 開發作業，請參閱「設定 .NET 開發環境」一文。

呼叫函式的程式庫是 .NET Functions Framework。

原始碼結構

為使 Cloud Run 函式能夠找到您函式的定義，每個執行階段都對原始碼有一定的結構要求。詳情請參閱「編寫 Cloud Run functions」一文。

指定依附元件

您可以將依附元件新增至專案檔案，為函式指定依附元件。詳情請參閱「在 .NET 中指定依附元件」。

後續步驟