通过 Azure Functions 按需运行代码

  • 10 分钟

创建了函数应用后，让我们了解如何生成、配置和执行函数。 我们将在下一个练习中执行函数，所以在本单元中无需完成任何任务。

触发器

函数是事件驱动的，也就是说函数的运行是对某个事件的响应。 启动函数的事件类型称为触发器。 每个函数都必须配置一个触发器。

可使用来自以下 Azure 服务的 HTTP 请求、计划的计时器和事件来触发函数执行：

Azure 服务 触发器说明
Blob 存储 检测到新的或更新的 Blob 时启动函数。
Azure Cosmos DB 在检测到插入内容或更新内容时启动函数。
事件网格 在事件网格收到新事件时启动函数。
事件中心 在事件中心收到新事件时启动函数。
队列存储 在队列收到新项时启动函数。 队列消息作为输入提供给该函数。
服务总线 启动函数以响应来自服务总线队列的消息。

绑定

绑定是将数据和服务连接到函数的声明性方式。 绑定与各种数据源交互，也就是说要连接到数据源并管理连接，无需在函数中编写代码。 该平台会通过绑定代码为你处理这些复杂性。 每个绑定都有一个方向：代码从“输入”绑定读取数据，并将数据写入“输出”绑定。 每个函数都有零个或多个绑定，以便管理由函数处理的输入和输出数据。

触发器是一种能够启动某些代码执行的输入绑定类型。

Azure 提供了大量绑定，以便连接到不同的存储和消息服务。

定义示例绑定

让我们来看一个配置函数的示例，其中有输入绑定（触发器）和输出绑定。 假设希望在 Azure 队列存储中显示一条新消息时就将一个新行写入 Azure 表存储。 使用 Azure 队列存储触发器和 Azure 表存储输出绑定即可实现此方案。

以下代码段是此方案的 function.json 文件。

{
  "bindings": [
    {
      "name": "order",
      "type": "queueTrigger",
      "direction": "in",
      "queueName": "myqueue-items",
      "connection": "MY_STORAGE_ACCT_APP_SETTING"
    },
    {
      "name": "$return",
      "type": "table",
      "direction": "out",
      "tableName": "outTable",
      "connection": "MY_TABLE_STORAGE_ACCT_APP_SETTING"
    }
  ]
}

我们的 JSON 配置指定在将消息添加到名为“myqueue-items”的队列时触发我们的函数。 然后，将函数的返回值写入 Azure 表存储中的“outTable”。

对于 PowerShell 函数，输出绑定是使用 Push-OutputBinding cmdlet 显式写入的。

此示例简单说明了我们如何为函数配置绑定。 可以使用 SendGrid 绑定将输出更改为电子邮件，或将事件置于服务总线上，以通知体系结构中的一些其他组件。 我们甚至可以有多个输出绑定将数据推送到各种服务。

提示

若要在 Azure 门户中查看和编辑 function.json 的内容，请在主页中选择自己的函数应用，然后在右侧窗格中选择“JSON 视图”。 “资源 JSON”视图显示资源 ID 和可编辑的 JSON 代码。 要关闭 JSON 视图，请选择窗格右上角的“X”。

并非 Functions 支持的所有语言都使用 function.json 文件来定义函数。

在 Azure 门户中创建函数

Azure Functions 具有预定义的函数模板，它们基于特定类型的触发器。 使用所选语言的这些模板可以轻松开始创建第一个函数。

Functions 支持的所有语言都不支持此模块，门户本身也不支持使用 Functions 支持的所有语言创建函数。

对于使用 function.json 文件定义函数的支持语言，可以直接在 Azure 门户中创建和编辑这些函数。 这些门户支持的语言包括：JavaScript、PowerShell、Python 和 C# 脚本 (.csx)。 直接在代码本身中定义函数的语言必须在门户之外开发并部署到 Azure。 这些非门户支持的语言包括：C#、Java、Python（v2 编程模型）和 JavaScript/TypeScript（Node.js v4 编程模型）。

函数模板

在门户中创建第一个函数时，可为函数选择预定义的触发器。 根据你的选择，Azure 生成默认的代码和配置信息，例如在收到输入数据时创建事件日志条目。

从“添加函数”窗格中选择模板可以轻松访问最常用的开发环境、触发器、依赖项。 在 Azure 门户中创建函数时，可从 20 多个模板中进行选择。 创建后，可进一步自定义代码。

从模板创建函数时，系统会创建多个文件，包括配置文件 function.json 和源代码文件 index.js。

从“函数应用”菜单中选择“函数”类别下的“函数”，可为你的函数应用创建或编辑函数。

选择在你的函数应用中创建的一个函数时，将打开“函数”窗格。 通过从“函数”菜单中选择“代码 + 测试”，可访问命令栏中的操作来测试和运行代码、保存或放弃所做的更改或获取发布的 URL。 通过从命令栏中选择“测试/运行”，可对包含查询字符串和值的请求运行用例。 代码框上方的函数路径显示了打开的文件的名称。 可从下拉列表中选择特定的文件（例如 function.json）来测试或编辑。

Screenshot of the function code and test editor showing the expanded Test/Run view, with menu options highlighted.

在上图中，右侧窗格有“输入”和“输出”选项卡。 选择“输入”选项卡，可通过添加查询参数并为查询字符串提供值来生成和测试函数。 “输出”选项卡显示请求的结果。

测试 Azure 函数

在门户中创建函数后，需要对其进行测试。 有两种方法：

  • 在门户中进行测试
  • 手动运行

在 Azure 门户中测试

该门户还提供测试函数的便捷方法。 如上面的屏幕截图所述。 在此窗格中选择“运行”时，结果会自动显示在“输出”标签中，并且“日志”窗格会打开以显示状态。

手动运行函数

可以通过手动触发已配置触发器来启动函数。 例如，如果使用 HTTP 触发器，可以使用 Postman 或 cURL 等工具来发起对函数终结点 URL 的 HTTP 请求，函数终结点 URL 可在函数定义（获取函数 URL）中找到。

监视和 Application Insights 仪表板

在开发和生产过程中，监视函数的能力至关重要。 Azure 门户提供了监控仪表板，可通过启用 Application Insights 集成来打开它。 在“函数应用”菜单中的“设置”下，依次选择“Application Insights”、“启用 Application Insights”和“应用”。 在对话框中，选择“是”。 使用 Application Insights 仪表板，可显示由 Application Insights 填充的时间戳、结果代码、持续时间和操作 ID，从而快速查看函数操作的历史记录。

Screenshot showing the HTTP function Application Insights dashboard with function results, corresponding HTTP status codes, and the Monitoring menu items highlighted.

“流式传输日志”窗格

在 Azure 门户中启用 Application Insights 后，可将日志记录语句添加到函数以进行调试。 为每种语言调用的方法都将被传递一个“logging”对象，该对象可用于在运行测试时将日志信息添加至“代码 + 测试”窗格中的“日志”窗格。

使用 context 对象上的 log 方法从代码中写入日志，该方法将传递给处理程序。 以下示例写入默认日志级别（信息）：

context.log('Enter your logging statement here');

使用 Write-Host cmdlet 从代码写入日志，如以下示例所示：

Write-Host "Enter your logging statement here"

错误、失败、警告和异常

可使用指标或“函数”菜单中“调查”类别的选项来监视性能、诊断故障，或者配置几十个预定义的工作簿来管理函数应用。 从代码中的编译错误和警告到按角色分类的使用情况统计信息。