你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 Azure Arc 上创建第一个函数（预览版）

  • 项目

在本快速入门中，你将创建一个 Azure Functions 项目，并将其部署到在支持 Azure Arc 的 Kubernetes 群集上运行的函数应用。 若要了解详细信息，请参阅 Azure Arc 上的应用服务、Functions 和逻辑应用。此方案仅支持在 Linux 上运行的函数应用。

注意

现支持在已启用 Azure Arc 的 Kubernetes 群集上运行函数 - 该项支持现为预览版。

目前不支持将 PowerShell 函数项目发布到支持 Azure Arc 的 Kubernetes 群集。 如果需要将 PowerShell 函数部署到支持 Azure Arc 的 Kubernetes 群集，请在容器中创建函数应用。

如果需要自定义运行函数应用的容器，请参阅在 Azure Arc 上创建第一个容器化函数（预览版）。

先决条件

在本地计算机上：

安装 Azure Functions Core Tools

建议的 Core Tools 安装方法取决于本地开发计算机的操作系统。

以下步骤使用 Windows 安装程序 (MSI) 安装 Core Tools v4.x。 若要详细了解其他基于包的安装程序，请参阅 Core Tools 自述文件。

基于Windows 版本下载并运行 Core Tools 安装程序：

如果之前使用 Windows 安装程序 (MSI) 在 Windows 上安装 Core Tools，则应在安装最新版本之前从“添加/移除程序”中卸载旧版本。

创建应用服务 Kubernetes 环境

在开始之前，必须为已启用 Azure Arc 的 Kubernetes 群集创建应用服务 Kubernetes 环境。

注意

创建环境时，请确保同时记下自定义位置名称和包含该自定义位置的资源组名称。 你可以使用它们来查找自定义位置 ID，在环境中创建函数应用时需要用到该 ID。

如果未创建环境，请与群集管理员联系。

添加 Azure CLI 扩展

在 Azure Cloud Shell 中启动 Bash 环境。

由于这些 CLI 命令尚未成为核心 CLI 集的一部分，因此请通过以下命令添加它们：

az extension add --upgrade --yes --name customlocation
az extension remove --name appservice-kube
az extension add --upgrade --yes --name appservice-kube

创建本地函数项目

在 Azure Functions 中，函数项目是用于部署和执行一个或多个单独函数的单元，每个函数响应特定的触发器。 项目中的所有函数共享相同的本地和宿主配置。 在本部分，你将创建包含单个函数的函数项目。

  1. 按如下所示运行 func init 命令，在名为 LocalFunctionProj 的文件夹中创建使用指定运行时的函数项目：

    func init LocalFunctionProj --dotnet

  2. 导航到项目文件夹：

    cd LocalFunctionProj

    此文件夹包含项目的各个文件，其中包括名为 local.settings.json 和 host.json 的配置文件。 默认情况下，local.settings.json 文件会从 .gitignore 文件的源代码管理中排除。 此排除是因为该文件可以包含从 Azure 下载的机密。

  3. 使用以下命令将一个函数添加到项目，其中，--name 参数是该函数 (HttpExample) 的唯一名称，--template 参数指定该函数的触发器 (HTTP)。

    func new --name HttpExample --template "HTTP trigger" --authlevel "anonymous"

在本地运行函数

  1. 通过从 LocalFunctionProj 文件夹启动本地 Azure Functions 运行时主机来运行函数。

    func start

    在输出的末尾，必须要显示以下行：

    Screenshot of terminal window output when running function locally.

    注意

    如果 HttpExample 未按如上所示出现，则可能是在项目的根文件夹外启动了主机。 在这种情况下，请按 Ctrl+C 停止主机，转至项目的根文件夹，然后重新运行上一命令。

  2. 将此输出中的 HTTP 函数的 URL 复制到浏览器，并追加查询字符串 ?name=<YOUR_NAME>，使完整 URL 类似于 http://localhost:7071/api/HttpExample?name=Functions。 浏览器应显示回显查询字符串值的响应消息。 当你发出请求时，启动项目时所在的终端还会显示日志输出。

  3. 完成后，按 Ctrl + C 并键入 y 以停止函数主机。

获取自定义位置

若要在自定义位置中创建函数应用，需要获取有关环境的信息。

从群集管理员处获取有关自定义位置的以下信息（请参阅创建自定义位置）。

customLocationGroup="<resource-group-containing-custom-location>"
customLocationName="<name-of-custom-location>"

获取自定义位置 ID，供下一步使用。

customLocationId=$(az customlocation show \
    --resource-group $customLocationGroup \
    --name $customLocationName \
    --query id \
    --output tsv)

创建 Azure 资源

你需要创建另外两个资源，然后才能将函数代码部署到新的应用服务 Kubernetes 环境：

  • 一个存储帐户。 虽然本文创建了一个存储帐户，但在某些情况下可能不需要存储帐户。 有关详细信息，请参阅“存储注意事项”一文中的已启用 Azure Arc 的群集。
  • 一个函数应用：提供用于执行函数代码的上下文。 函数应用在应用服务 Kubernetes 环境中运行，并映射到本地函数项目。 函数应用可将函数分组为一个逻辑单元，以便更轻松地管理、部署和共享资源。

注意

函数应用以专用（应用服务）计划在应用服务 Kubernetes 环境中运行。 如果在没有现有计划的情况下创建函数应用，则系统会为你创建正确的计划。

创建存储帐户

使用 az storage account create 命令在资源组和区域中创建常规用途存储帐户：

az storage account create --name <STORAGE_NAME> --location westeurope --resource-group myResourceGroup --sku Standard_LRS

注意

在某些情况下，可能不需要存储帐户。 有关详细信息，请参阅“存储注意事项”一文中的已启用 Azure Arc 的群集。

在上一个示例中，将 <STORAGE_NAME> 替换为适合你且在 Azure 存储中唯一的名称。 名称只能包含 3 到 24 个数字和小写字母字符。 Standard_LRS 指定 Functions 支持的常规用途帐户。 --location 值是标准 Azure 区域。

创建函数应用

运行 az functionapp create 命令以在环境中创建新的函数应用。

az functionapp create --resource-group MyResourceGroup --name <APP_NAME> --custom-location <CUSTOM_LOCATION_ID> --storage-account <STORAGE_NAME> --functions-version 4 --runtime dotnet

在此示例中，请将 <CUSTOM_LOCATION_ID> 替换为你为应用服务 Kubernetes 环境确定的自定义位置的 ID。 另请将 <STORAGE_NAME> 替换为上一步中使用的帐户的名称，并将 <APP_NAME> 替换为适合你的全局唯一名称。

将函数项目部署到 Azure

在 Azure 中成功创建函数应用后，便可以使用 func azure functionapp publish 命令部署本地函数项目。

在以下示例中，请将 <APP_NAME> 替换为你的应用的名称。

func azure functionapp publish <APP_NAME>

publish 命令显示类似于以下输出的结果（为简洁起见，示例中的结果已截断）：

...

Getting site publishing info...
Creating archive for current directory...
Performing remote build for functions project.

...

Deployment successful.
Remote build succeeded!
Syncing triggers...
Functions in msdocs-azurefunctions-qs:
    HttpExample - [httpTrigger]
        Invoke url: https://msdocs-azurefunctions-qs.azurewebsites.net/api/httpexample

由于在支持 Azure Arc 的 Kubernetes 群集上完成完整部署可能需要一些时间，因此可能需要重新运行以下命令来验证已发布的函数：

func azure functionapp list-functions

在 Azure 上调用函数

由于函数使用 HTTP 触发器，因此，可以通过在浏览器中或使用 curl 等工具，向此函数的 URL 发出 HTTP 请求来调用它。

将 publish 命令的输出中显示的完整“调用 URL”复制到浏览器的地址栏，并追加查询参数 ?name=Functions。 浏览器显示的输出应与本地运行函数时显示的输出类似。

The output of the function run on Azure in a browser

后续步骤

既然你的函数应用在容器中运行已启用 Azure Arc 的应用服务 Kubernetes 环境，你可通过添加队列存储输出绑定来将其连接到 Azure 存储。