你当前正在访问 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.jsonhost.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
    

    在输出的末尾,必须要显示以下行:

    在本地运行函数时的终端窗口输出的屏幕截图。

    注意

    如果 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 命令部署本地函数项目。

在根项目文件夹中,运行此 func azure functionapp publish 命令:

func azure functionapp publish <APP_NAME>

在此示例中,使用应用名称替代 <APP_NAME>。 成功的部署显示类似于以下输出的结果(为简洁起见,示例中的结果已截断):

...

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。 浏览器显示的输出应与本地运行函数时显示的输出类似。

在 Azure 上运行函数后浏览器中的输出

后续步骤

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