.NET 运行时

概览

Cloud Functions 函数在由操作系统版本、插件软件包、语言支持以及支持和调用函数的 Functions 框架库组成的环境中运行。此环境由语言版本进行标识，称为运行时。

如需了解运行时的一般信息以及每个 NET 运行时使用的 Ubuntu 版本，请参阅 Cloud Functions 执行环境。

如需开始在 Cloud Functions 上使用 .NET，请参阅快速入门。

模板软件包

模板软件包可帮助您创建新函数。要使用此应用，请执行以下操作：

  1. 安装 .NET SDK。

  2. 安装模板软件包：

    dotnet new install Google.Cloud.Functions.Templates

为 C#（默认）、F# 和 Visual Basic 三种类型的函数提供了模板。通过模板创建新项目时，指定 -lang f# 以创建 F# 项目，或指定 -lang vb 以创建 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

如需了解更多部署参数，请参阅使用 Google Cloud CLI 进行部署。

控制台

如果您使用的是 Google Cloud 控制台，请参阅 Google Cloud 控制台快速入门以获取详细说明。

函数准备

您可以直接在 Google Cloud 控制台中准备函数，也可以在本地机器上编写函数并上传该函数。如需准备本地机器以用于 .NET 开发，请参阅设置 .NET 开发环境。

调用您的函数的库是 .NET 版 Cloud Functions 框架。

如需快速开始在 Cloud Functions 上使用 .NET，请参阅快速入门。

源代码结构

要让 Cloud Functions 找到您的函数定义，每个运行时都对您的源代码有一定的结构要求。如需了解详情，请参阅编写 Cloud Functions 函数。

指定依赖项

如需为函数指定依赖项，您可以将依赖项添加到项目文件中。如需了解详情，请参阅指定 .NET 依赖项。

后续步骤