本快速入门将指导你通过使用最简单、最快的方法,把Python Web和数据库解决方案创建并部署到Azure。 按照本快速入门中的说明进行操作:
- 根据要构建的 Python Web 框架、Azure数据库平台和Azure Web 托管平台,选择一个
azd模板。 - 使用 CLI 命令运行
azd模板来创建示例 Web 应用和数据库,并创建和配置必要的Azure资源。 然后,将示例 Web 应用部署到Azure。 - 在本地计算机上编辑 Web 应用,并使用 命令重新部署。
- 使用
azd命令清理Azure资源。
完成本教程需要不到 15 分钟的时间。 完成后,可以使用自定义代码开始修改新项目。
若要了解有关用于Python Web 应用开发的这些 azd 模板的详细信息,请参阅:
- 这些模板是什么?
- 模板的工作原理是什么?
- 为什么我想使用它?
- 我的其他选项是什么?
先决条件
Azure订阅 - 免费创建一个订阅
在本地计算机上安装以下工具:
- Azure 开发人员 CLI
- Docker Desktop
- Visual Studio Code
- 开发容器扩展
选择模板
根据Python Web 框架、Azure Web 托管平台和要构建的数据库平台 Azure,选择 azd 模板。
从下表中的以下模板列表中选择模板名称(第一列)。 在下一部分的步骤中使用模板名称。
- Django
- FastAPI (快速应用编程接口)
- Flask框架
模板 Web 框架 数据库 托管平台 GitHub存储库 azure-django-postgres-flexible-aca Django PostgreSQL 灵活服务器 Azure 容器应用 repo Azure-Django-PostgreSQL-灵活应用服务 Django PostgreSQL 灵活服务器 Azure 应用服务 repo azure-django-cosmos-postgres-aca Django Cosmos DB (PostgreSQL 适配器) Azure 容器应用 (Azure 容器应用) repo azure-django-cosmos-postgres-appservice Django Cosmos DB (PostgreSQL 适配器) Azure 应用服务 repo azure-django-postgres-addon-aca (Azure Django PostgreSQL 插件 ACA) Django Azure 容器应用 的 PostgreSQL 加载项 Azure 容器应用 repo
运行模板
在跨语言和框架时,运行模板是相同的。 相同的基本步骤适用于所有模板。 这些步骤包括:
在终端上,导航到本地计算机上的文件夹,其中通常存储本地 git 存储库。 创建名为 azdtest 的新文件夹。 然后,使用命令进入该目录。
mkdir azdtest cd azdtest不要将 Visual Studio Code 终端用于本快速入门。
若要设置本地开发环境,请在终端中输入以下命令并回答任何提示:
azd init --template <template name>将 替换为在上一步中选择的表中的一个模板,例如 azure-django-postgres-aca。
当系统提示输入环境名称时,请使用 azdtest 或任何其他名称。 命名Azure资源组和资源时,将使用环境名称。 为获得最佳效果,请使用短名称、小写字母、无特殊字符。
若要向 Azure 帐户
azd进行身份验证,请在终端中输入以下命令,并按照提示作:azd auth login当系统提示“选取帐户”或登录到Azure帐户时,请按照说明作。 成功进行身份验证后,以下消息会显示在网页中:“身份验证完成。 可以返回到应用程序。 随时关闭此浏览器选项卡。
关闭选项卡时,shell 会显示消息:
Logged in to Azure.在尝试下一步之前,请确保 Docker Desktop 在后台打开并运行。
若要创建必要的Azure资源,请在终端中输入以下命令并回答任何提示:
azd up重要
azd up成功完成后,示例 Web 应用在公共 Internet 上可用,Azure订阅开始收取创建的所有资源的费用。 模板的创建者有意选择了便宜的层级,但不一定是免费层级,因为免费层级的可用性通常会受到限制。当系统提示选择Azure订阅用于付款时,请按照说明进行作,然后选择要使用的Azure位置。 选择地理上靠近的区域。
执行
azd up可能需要几分钟时间,因为它正在预配和部署多个Azure服务。 在显示进度时,请注意错误。 如果看到错误,请尝试以下方法解决问题:- 从头开始删除 azd-quickstart 文件夹和快速入门说明。
- 出现提示时,为环境选择更简单的名称。 仅使用小写字母和短划线。 没有数字、大写字母或特殊字符。
- 选择其他位置。
如果仍有问题,请参阅本文档底部的 “故障排除 ”部分。
重要
使用完示例 Web 应用后,用于 删除创建的所有服务 。
当 成功完成时,将显示以下输出:
复制单词
- Endpoint:后的第一个 URL,并将其粘贴到 Web 浏览器的位置栏中,以查看在 Azure 中实时运行的示例 Web 应用项目。在 Web 浏览器中打开一个新选项卡。
- 复制上一步骤中的第二个 URL 并将其粘贴到位置栏中。
- Azure门户显示部署到托管示例 Web 应用项目的新资源组中的所有服务。
编辑和重新部署
接下来,对 Web 应用进行少量更改,然后重新部署它。
打开Visual Studio Code并打开 azdtest 文件夹。
此模板配置为选择性地使用开发容器。 当看到开发容器通知显示在Visual Studio Code中时,请选择“容器”中的“打开”按钮按钮。
使用 Visual Studio Code 的资源管理器视图导航到 src/templates 文件夹,并打开 index.html 文件。 找到以下代码行:
<h1 id="pagte-title">Welcome to ReleCloud</h1>更改 H1 中的文本:
<h1 id="pagte-title">Welcome to ReleCloud - UPDATED</h1>保存更改。
若要使用更改重新部署应用,请在终端中运行以下命令:
azd deploy由于你使用的是开发容器并远程连接到容器的 shell,因此不要使用 Visual Studio Code 的终端窗格来运行
azd命令。命令完成后,刷新 Web 浏览器以查看更新。 根据所使用的 Web 托管平台,更改可能需要几分钟才能显示。
现在,你已准备好编辑和删除模板中的文件。 有关详细信息,请参阅 可以在模板中编辑或删除哪些内容?
清理资源
通过运行 命令清理模板创建的资源。
azd downazd down命令删除Azure资源和GitHub Actions工作流。 出现提示时,同意删除与资源组关联的所有资源。还可以删除 azdtest 文件夹,或者通过修改项目的文件将其用作你自己的应用程序的基础。
故障排除
如果您在 时发现错误,请尝试以下步骤:
- 运行 以删除命令创建的任何资源。 或者,可以删除在Azure门户中创建的资源组。
- 删除本地计算机上的 azdtest 文件夹。
- 在 Azure 门户网站中,搜索 Key Vaults。 选择“ 管理已删除的保管库”,选择订阅,选择包含名称 azdtest 的所有密钥保管库或任何你命名的环境,然后选择“ 清除”。
- 请重试本快速入门中的步骤。 出现提示时,请为环境选择更简单的名称。 请尝试短名称、小写字母、无数字、无大写字母和无特殊字符。
- 重试快速入门步骤时,请选择其他位置。
有关可能问题和解决方案的更全面的列表,请参阅 常见问题解答。
相关内容
-
详细了解 Python web
azd模板。 - 了解有关命令的详细信息。
- 了解项目中每个文件夹和文件的作用以及您可以编辑或删除的内容。
- 详细了解开发容器。
- 更新Bicep模板以添加或删除Azure服务。 对Bicep不了解吗? 请尝试此学习路径:Bicep基础知识。
- 使用
azd设置 GitHub Actions CI/CD 管道,以便在合并到主分支时重新部署。 - 设置监视,以便可以使用 Azure 开发人员 CLI 监控应用。