快速入门:将数据 API 生成器与 Azure SQL 和 Azure 静态 Web 应用配合使用
在本快速入门中,你将数据 API 生成器(DAB)作为 Docker 容器部署到 Azure 容器应用。 使用 Azure 开发人员 CLI (AZD) 模板通过最新的最佳做法部署 DAB 和 Azure SQL 数据库。 该模板还部署使用 GraphQL 连接到 DAB 终结点的示例 Web 应用程序。
先决条件
- Azure 开发人员 CLI
- .NET 9.0
如果没有 Azure 帐户,请在开始前创建 免费帐户。
初始化项目
使用 Azure 开发人员 CLI (azd
) 创建 Azure SQL 帐户,将 DAB 部署为容器化解决方案,并部署容器化示例应用程序。 示例应用程序使用 DAB 查询示例数据。
在空目录中打开终端。
如果尚未进行身份验证,请使用
azd auth login
向 Azure 开发人员 CLI 进行身份验证。 按照工具指定的步骤,使用首选的 Azure 凭据向 CLI 进行身份验证。azd auth login
使用
azd init
初始化项目。azd init --template dab-azure-sql-quickstart
在初始化期间,配置唯一的环境名称。
使用
azd up
将完整解决方案部署到 Azure。 Bicep 模板将 Azure SQL 帐户 DAB 部署到 Azure 容器应用,以及示例 Web 应用程序。azd up
在预配过程中,选择订阅和所需位置。 等待预配过程完成。 此过程可能需要大约 7 分钟。
预配 Azure 资源后,输出中将包含正在运行的 Web 应用程序的 URL。
Deploying services (azd deploy) (✓) Done: Deploying service api - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io> (✓) Done: Deploying service web - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io> SUCCESS: Your up workflow to provision and deploy to Azure completed in 7 minutes 0 seconds.
记录 api 和 Web 服务的 URL 值。 本指南中您将在之后使用这些值。
配置数据库连接
现在,浏览到 Azure 容器应用中的每个容器化应用程序,以验证它们是否按预期工作。
首先,导航到 API 服务的 URL。 此 URL 链接到正在运行的 DAB 实例。
观察 DAB 的 JSON 输出。 它应指示 DAB 容器正在运行,状态为 健康。
{ "status": "healthy", "version": "1.1.7", "app-name": "dab_oss_1.1.7" }
导航到 DAB 实例的相对
/swagger
路径。 此 URL 应打开 Swagger UI REST 集成开发环境(IDE)。在 Swagger IDE 中,针对 Azure SQL
products
表中的所有行运行GET
请求。最后,导航到 Web 服务的 URL。 此 URL 链接到正在运行的示例 Web 应用程序,该应用程序连接到在上一步中访问的 GraphQL 终结点。
观察正在运行的 Web 应用程序并查看输出数据。
收拾
不再需要示例应用程序或资源时,请删除相应的部署和所有资源。
从 Azure 订阅中删除部署。
azd down
如果使用的是 GitHub Codespaces,请删除正在运行的代码空间,以最大化存储和核心权利。