在本文中,我们使用 Visual Studio Code 来创建一个响应 HTTP 请求的 JavaScript 函数。 在本地测试代码后,将代码部署到 Azure Functions 的无服务器环境。
完成本快速入门会从你的 Azure 帐户中扣取最多几美分的费用。
本文还有一个基于 CLI 的版本。
配置环境
在开始之前,请确保已满足下列要求:
-
具有活动订阅的 Azure 帐户。 免费创建帐户。
-
Node.js,活动 LTS 和维护 LTS 版本(建议使用 10.14.1)。 可以使用
node --version命令检查你的版本。 -
安装在某个受支持的平台上的 Visual Studio Code。
-
Visual Studio Code 的 Azure Functions 扩展。
创建本地项目
在本部分,你将使用 Visual Studio Code 在 JavaScript 中创建一个本地 Azure Functions 项目。 稍后在本文中,你要将函数代码发布到 Azure。
-
在活动栏中选择“Azure”图标,然后在“Azure:函数”区域中选择“创建新项目...”图标。
选择“创建新项目”
-
为项目工作区选择目录位置,然后选择“选择” 。
NOTE 这些步骤已设计为在工作区之外完成。 在这种情况下,请不要选择属于工作区内的项目文件夹。
-
根据提示提供以下信息:
-
选择函数项目的语言:选择
JavaScript。 -
为项目的第一个函数选择模板:选择
HTTP trigger。 -
提供函数名称:键入
HttpExample。 -
授权级别:选择
Anonymous,这使任何人都可以调用你的函数终结点。 若要了解授权级别,请参阅授权密钥。 -
选择打开项目的方式:选择
Add to workspace。
-
-
Visual Studio Code 将使用此信息生成一个包含 HTTP 触发器的 Azure Functions 项目。 可以在资源管理器中查看本地项目文件。 若要详细了解所创建的文件,请参阅生成的项目文件。
在本地运行函数
Visual Studio Code 与 Azure Functions Core Tools 相集成,便于你在发布到 Azure 之前在本地开发计算机上运行此项目。
-
若要调用函数,请按 F5 启动函数应用项目<kbd></kbd>。 来自 Core Tools 的输出会显示在“终端” 面板中。 应用将在“终端”面板中启动。 可以看到 HTTP 触发函数的 URL 终结点在本地运行。
本地函数 VS Code 输出
如果在 Windows 上运行时遇到问题,请确保用于 Visual Studio Code 的默认终端未设置为“WSL Bash”。
-
运行 Core Tools 后,转到“Azure:Functions”区域。 在“Functions”下,展开“本地项目” > “Functions” 。 右键单击 (Windows) 或按 <kbd>Ctrl -</kbd> 单击 (macOS)
HttpExample函数,然后选择“立即执行函数...”。 -
在“输入请求正文”中,你将看到请求消息正文值
{ "name": "Azure" }。 按 Enter 将此请求消息发送给函数。 -
当函数在本地执行并返回响应时,Visual Studio Code 中将引发通知。 函数执行的相关信息将显示在“终端”面板中。
-
按 Ctrl + C 停止 Core Tools 并断开调试器的连接<kbd></kbd>。
确认该函数可以在本地计算机上正确运行以后,可以使用 Visual Studio Code 将项目直接发布到 Azure。
登录 Azure
在发布应用之前,必须先登录到 Azure。
-
如果你尚未登录,请在活动栏中选择“Azure”图标,然后在“Azure: 函数”区域中,选择“登录到 Azure...”。如果没有帐户,可以创建一个免费 Azure 帐户。 学生可以创建一个免费的面向学生的 Azure 帐户。
在 VS Code 中登录到 Azure
如果已登录,请转到下一部分。
-
在浏览器中出现提示时,请选择你的 Azure 帐户,并使用你的 Azure 帐户凭据登录。
-
成功登录后,可以关闭新浏览器窗口。 属于你的 Azure 帐户的订阅显示在边栏中。
将项目发布到 Azure
在本部分,你将在 Azure 订阅中创建一个函数应用和相关资源,然后部署代码。
Important: 发布到现有函数应用将覆盖该应用在 Azure 中的内容。
-
在活动栏中选择“Azure”图标,然后在“Azure:函数”区域中,选择“部署到函数应用...”按钮。
将项目发布到 Azure
-
根据提示提供以下信息:
-
选择文件夹:从工作区中选择一个文件夹,或浏览到包含函数应用的文件夹。 如果已打开有效的函数应用,则不会看到此信息。
-
选择订阅:选择要使用的订阅。 如果只有一个订阅,则不会看到此项。
-
在 Azure 中选择函数应用:选择
+ Create new Function App。 (请不要选择本文中未介绍的Advanced选项。) -
输入函数应用的全局唯一名称:键入在 URL 路径中有效的名称。 将对你键入的名称进行验证,以确保其在 Azure Functions 中是唯一的。
-
选择运行时:选择你一直在本地运行的 Node.js 版本。 可以使用
node --version命令来检查你的版本。 -
选择新资源的位置:为了获得更好的性能,请选择你附近的 区域。
在 Azure 中创建单个资源时,扩展会在通知区域显示这些资源的状态。
-
-
完成后,将使用基于函数应用名称的名称在订阅中创建以下 Azure 资源:
-
一个资源组:相关资源的逻辑容器。
-
一个标准 Azure 存储帐户:用于维护项目的状态和其他信息。
-
一个消耗计划:用于定义无服务器函数应用的基础主机。
-
一个函数应用:提供用于执行函数代码的环境。 可以通过函数应用将函数分组为逻辑单元,以便在同一托管计划中更轻松地管理、部署和共享资源。
-
一个连接到函数应用的 Application Insights 实例:用于跟踪无服务器函数的使用情况。
创建函数应用并应用了部署包之后,会显示一个通知。
Tip: 默认情况下,会根据你提供的函数应用名称创建函数应用所需的 Azure 资源。 默认情况下,还会在函数应用所在的新资源组中创建这些资源。 如果要自定义这些资源的名称或重复使用现有资源,则需要使用高级创建选项来发布项目。
-
在此通知中选择“查看输出”以查看创建和部署结果,其中包括你创建的 Azure 资源。 如果错过了通知,请选择右下角的响铃图标以再次查看。
创建完成通知
在 Azure 中运行函数
-
返回到“Azure:函数”区域(位于侧栏中),然后展开你的订阅、新的函数应用和“函数”。 右键单击 (Windows) 或按 <kbd>Ctrl -</kbd> 单击 (macOS)
HttpExample函数,然后选择“立即执行函数...”。 -
在“输入请求正文”中,你将看到请求消息正文值
{ "name": "Azure" }。 按 Enter 将此请求消息发送给函数。 -
当函数在 Azure 中执行并返回响应时,Visual Studio Code 中将引发通知。
清理资源
若要继续执行下一步骤将 Azure 存储队列绑定添加到函数,需要保留到目前为止构建的所有资源。
否则,可以使用以下步骤删除函数应用及其相关资源,以免产生任何额外的费用。
-
在 Visual Studio Code 中,按 F1 打开命令面板<kbd></kbd>。 在命令面板中,搜索并选择
Azure Functions: Open in portal。 -
选择你的函数应用,然后按 Enter<kbd></kbd>。 随即将在 Azure 门户中打开函数应用页面。
-
在“概览”选项卡中,选择“资源组”旁边的命名链接。
-
在“资源组”页中查看所包括的资源的列表,然后验证这些资源是否是要删除的。
-
选择“删除资源组”,然后按说明操作。
可能需要数分钟才能删除完毕。 完成后会显示一个通知,持续数秒。 也可以选择页面顶部的钟形图标来查看通知。
若要详细了解 Functions 的费用,请参阅估算消耗计划成本。
后续步骤
你已使用 Visual Studio Code 通过简单的 HTTP 触发函数创建了函数应用。 在下一篇文章中,你将通过连接到 Azure 存储来扩展该函数。 若要详细了解如何连接到其他 Azure 服务,请参阅将捆绑项添加到 Azure Functions 中的现有函数。
历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
