Cloud Run 函式的執行環境包含作業系統版本、附加套件、語言支援,以及支援和叫用函式的 .NET Functions Framework 程式庫。這個環境由語言版本識別,稱為執行階段 ID。
函式準備
您可以直接透過 Google Cloud 控制台準備函式,也可以在本機電腦上編寫函式後再上傳。如要準備本機電腦以進行 .NET 開發作業,請參閱「設定 .NET 開發環境」。
支援的 .NET 執行階段和基本映像檔
| 執行階段 | 執行階段 ID | 堆疊 | 執行階段基礎映像檔 |
|---|---|---|---|
| .NET 10 (預先發布版) |
dotnet10 |
|
|
| .NET 8 | dotnet8 |
|
|
| .NET 6 | dotnet6 |
|
|
| .NET Core 3 | dotnet3 | google-18-full | google-18-full/dotnet3 |
範本套件
範本套件可協助您建立新函式。使用方法:
安裝 .NET SDK。
安裝範本套件:
dotnet new install Google.Cloud.Functions.Templates
範本適用於 C# (預設)、F# 和 Visual Basic 這三種函式。使用範本建立新專案時,請指定 -lang f# 以建立 F# 專案,或指定 -lang vb 以建立 Visual Basic 專案。
選取執行階段
部署函式時,您必須在專案檔案 (MyFunction.csproj 或類似檔案) 中,指定與目標架構對應的 .NET 執行階段。您可以在部署期間,為函式選取支援的 .NET 執行階段。
您可以使用 Google Cloud 控制台或 gcloud CLI 選取執行階段版本。按一下分頁標籤,瞭解如何使用自選工具:
gcloud
部署函式時,請使用 --base-image 旗標指定函式的 .NET 基本映像檔。例如:
gcloud run deploy FUNCTION \
--source . \
--function FUNCTION_ENTRYPOINT \
--base-image dotnet8
取代:
將 FUNCTION 替換為您要部署的函式名稱。您可以完全省略這個參數,但這樣系統會提示您輸入名稱。
FUNCTION_ENTRYPOINT,指定原始碼中函式的進入點。這是 Cloud Run 在函式執行時執行的程式碼。此旗標的值必須是原始碼中既有的函式名稱或完整類別名稱。
如需使用 gcloud CLI 部署函式的詳細操作說明,請參閱「在 Cloud Run 中部署函式」。
控制台
在 Google Cloud 控制台中建立或更新 Cloud Run 函式時,可以選取執行階段版本。如需部署函式的詳細操作說明,請參閱「在 Cloud Run 中部署函式」。
如要在 Google Cloud 控制台建立函式時選取執行階段,請按照下列步驟操作:
前往 Google Cloud 控制台的 Cloud Run 頁面:
按一下「編寫函式」。
在「Runtime」清單中,選取 .NET 執行階段版本。
按一下「建立」,然後等待 Cloud Run 使用預留位置修訂版本建立服務。
控制台會將您重新導向至「來源」分頁,您可以在這裡查看函式的原始碼。按一下「儲存並重新部署」。
如需在部署函式後更新執行階段版本的詳細操作說明,請參閱「重新部署新的原始碼」。
原始碼結構
原始碼必須遵循特定結構,Cloud Run functions 才能找到函式的定義。詳情請參閱「編寫 Cloud Run 函式」。
指定依附元件
.NET Cloud Run functions 使用 Microsoft Build Engine (MSBuild) 專案檔案,這些檔案是建構和部署程序的核心。您可以在專案檔案中指定函式的依附元件。C# 的副檔名為 .csproj,F# 的副檔名為 .fsproj,Visual Basic 的副檔名則為 .vbproj。
如要進一步瞭解依附元件和其他類型的自訂項目,請參閱「透過 Functions Startup 類別進行自訂」。