.NET 运行时
概览
Cloud Run functions 函数在由操作系统版本、插件软件包、语言支持以及支持和调用函数的 Functions 框架库组成的环境中运行。此环境由语言版本进行标识,称为运行时。
如需了解运行时的一般信息以及每个 NET 运行时使用的 Ubuntu 版本,请参阅 Cloud Functions 执行环境。
如需开始在 Cloud Run functions 上使用 PHP,请参阅快速入门。
模板软件包
模板软件包可帮助您创建新函数。要使用此应用,请执行以下操作:
安装 .NET SDK。
安装模板软件包:
dotnet new install Google.Cloud.Functions.Templates
为 C#(默认)、F# 和 Visual Basic 三种类型的函数提供了模板。通过模板创建新项目时,指定 -lang f#
以创建 F# 项目,或指定 -lang vb
以创建 Visual Basic 项目。如需了解详情,请参阅以下主题:
- 您的第一个函数:C#
- .NET 语言(适用于 F# 和 Visual Basic)
选择 .NET Functions 框架版本
不同版本的 .NET Functions 框架支持不同的运行时。版本 1 支持 .NET Core 3.1 及更高版本,模板默认为 .NET Core 3.1。版本 2 支持 .NET 6 及更高版本,模板默认为 .NET 6。
如需使用 .NET Functions 框架版本 1 升级现有项目,请修改项目文件(或使用 Visual Studio)来更新以 Google.Cloud.Functions
开头的所有依赖项,并将目标框架设置为 .NET 6。
选择运行时
Cloud Functions 函数支持运行时支持页面上列出的多个 .NET 版本。部署函数时,您必须指定与项目文件(MyFunction.csproj
或类似文件)中的目标框架对应的 .NET 运行时。如需指定 .NET 运行时,请执行以下操作:
gcloud
如果您使用的是 Google Cloud CLI,请使用 --runtime
参数指定运行时。--entry-point
标志指定完全限定类名称 (FQN)。例如:
gcloud functions deploy NAME --entry-point FQN --runtime dotnet6 --trigger-http FLAGS...
FLAGS...
是指在第一次部署您的函数期间传递的参数。如需详细了解必需参数和可选参数,请参阅使用 Google Cloud CLI 进行部署。
控制台
如果您使用的是 Google Cloud 控制台,请参阅 Google Cloud 控制台快速入门以获取详细说明。
函数准备
您可以直接在 Google Cloud 控制台中准备函数,也可以在本地机器上编写函数并上传该函数。如需准备本地机器以用于 .NET 开发,请参阅设置 .NET 开发环境。
调用您的函数的库是 .NET 版 Cloud Functions 框架。
如需快速开始在 Cloud Functions 上使用 .NET,请参阅快速入门。
源代码结构
要让 Cloud Run 函数找到您的函数定义,每个运行时都对您的源代码有一定的结构要求。如需了解详情,请参阅编写 Cloud Run 函数。
指定依赖项
如需为函数指定依赖项,您可以将依赖项添加到项目文件中。如需了解详情,请参阅指定 .NET 依赖项。
后续步骤
- 从头开始创建您的第一个 C# 函数。
- 了解可用于编写 Cloud Functions 函数的其他 .NET 语言:F# 和 Visual Basic。