通过

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

使用 Azure Static Web Apps CLI 启动 API 服务器

  • 项目

重要

为了提高通过 Static Web Apps CLI 进行部署的安全性，我们引入了一项中断性变更，需要你在 2025 年 1 月 15 日前升级到 Static Web Apps CLI 的最新版本 (2.0.2)。

在 Azure Static Web Apps 中，可以使用集成的托管 Functions 将 API 终结点添加到应用程序。 可以使用 Azure Functions 核心工具 CLI 在本地运行 Azure Functions 应用。 通过核心工具 CLI，可以在本地运行和调试 API 终结点。

可以手动或自动启动核心工具。

手动启动

将 SWA CLI 模拟器与 API 服务器一起使用：

  1. 使用 Azure Functions 核心工具 CLI 或 Visual Studio Code 扩展启动 API 服务器。

    核心工具开始运行后，复制本地 API 服务器的 URL。

    func host start

  2. 在单独的终端中，使用 --api-devserver-url 选项启动 SWA CLI，向其传递本地 API 服务器 URI。

    例如：

    swa start ./my-dist --api-devserver-url http://localhost:7071

自动启动

若要设置自动启动，首先要使一个 Azure Functions 应用程序项目位于本地开发环境中的 api 文件夹中。

  1. 将 API 服务器与 SWA 模拟器一并启动

    swa start ./my-dist --api-location ./api

  2. 在运行开发服务器的情况下启动

    swa start http://localhost:3000 --api-location ./api

后续步骤

部署到 Azure