.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 函式支援多個 .NET 版本,請參閱「執行階段支援」頁面。部署函式時,您必須在專案檔案 (MyFunction.csproj 或類似檔案) 中指定與目標架構相對應的 .NET 執行階段。如要指定 .NET 執行階段,請按照下列步驟操作:

gcloud

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

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

如需瞭解更多部署參數,請參閱「部署 Cloud Run 函式」。

控制台

如果您使用的是 Google Cloud 控制台,請參閱 Google Cloud 控制台快速入門,瞭解詳細操作說明。

函式準備

您可以直接從 Google Cloud 控制台準備函式,也可以在本機上編寫函式並上傳。如要為 .NET 開發作業準備本機電腦,請參閱「設定 .NET 開發環境」一文。

叫用函式的程式庫是 .NET 函式架構

原始碼結構

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

指定依附元件

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

後續步驟