通过


快速入门:使用 azd 模板创建和部署 Python Web 应用以Azure

本快速入门将指导你通过使用最简单、最快的方法,把Python Web和数据库解决方案创建并部署到Azure。 按照本快速入门中的说明进行操作:

  • 根据要构建的 Python Web 框架、Azure数据库平台和Azure Web 托管平台,选择一个 azd 模板。
  • 使用 CLI 命令运行 azd 模板来创建示例 Web 应用和数据库,并创建和配置必要的Azure资源。 然后,将示例 Web 应用部署到Azure。
  • 在本地计算机上编辑 Web 应用,并使用 命令重新部署。
  • 使用 azd 命令清理Azure资源。

完成本教程需要不到 15 分钟的时间。 完成后,可以使用自定义代码开始修改新项目。

若要了解有关用于Python Web 应用开发的这些 azd 模板的详细信息,请参阅:

  • 这些模板是什么?
  • 模板的工作原理是什么?
  • 为什么我想使用它?
  • 我的其他选项是什么?

先决条件

Azure订阅 - 免费创建一个订阅

在本地计算机上安装以下工具:

选择模板

根据Python Web 框架、Azure Web 托管平台和要构建的数据库平台 Azure,选择 azd 模板。

  1. 从下表中的以下模板列表中选择模板名称(第一列)。 在下一部分的步骤中使用模板名称。

    • 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

运行模板

在跨语言和框架时,运行模板是相同的。 相同的基本步骤适用于所有模板。 这些步骤包括:

  1. 在终端上,导航到本地计算机上的文件夹,其中通常存储本地 git 存储库。 创建名为 azdtest 的新文件夹。 然后,使用命令进入该目录。

    mkdir azdtest
    cd azdtest
    

    不要将 Visual Studio Code 终端用于本快速入门。

  2. 若要设置本地开发环境,请在终端中输入以下命令并回答任何提示:

    azd init --template <template name>
    

    将 替换为在上一步中选择的表中的一个模板,例如 azure-django-postgres-aca。

    当系统提示输入环境名称时,请使用 azdtest 或任何其他名称。 命名Azure资源组和资源时,将使用环境名称。 为获得最佳效果,请使用短名称、小写字母、无特殊字符。

  3. 若要向 Azure 帐户azd进行身份验证,请在终端中输入以下命令,并按照提示作:

    azd auth login
    

    当系统提示“选取帐户”或登录到Azure帐户时,请按照说明作。 成功进行身份验证后,以下消息会显示在网页中:“身份验证完成。 可以返回到应用程序。 随时关闭此浏览器选项卡。

    关闭选项卡时,shell 会显示消息:

    Logged in to Azure.
    
  4. 在尝试下一步之前,请确保 Docker Desktop 在后台打开并运行。

  5. 若要创建必要的Azure资源,请在终端中输入以下命令并回答任何提示:

    azd up
    

    重要

    azd up成功完成后,示例 Web 应用在公共 Internet 上可用,Azure订阅开始收取创建的所有资源的费用。 模板的创建者有意选择了便宜的层级,但不一定是免费层级,因为免费层级的可用性通常会受到限制。

    当系统提示选择Azure订阅用于付款时,请按照说明进行作,然后选择要使用的Azure位置。 选择地理上靠近的区域。

    执行 azd up 可能需要几分钟时间,因为它正在预配和部署多个Azure服务。 在显示进度时,请注意错误。 如果看到错误,请尝试以下方法解决问题:

    • 从头开始删除 azd-quickstart 文件夹和快速入门说明。
    • 出现提示时,为环境选择更简单的名称。 仅使用小写字母和短划线。 没有数字、大写字母或特殊字符。
    • 选择其他位置。

    如果仍有问题,请参阅本文档底部的 “故障排除 ”部分。

    重要

    使用完示例 Web 应用后,用于 删除创建的所有服务 。

  6. 当 成功完成时,将显示以下输出:

     在 azd 命令行接口中成功输出的截屏,其中突出显示了终结点 URL,用户可以通过该 URL 查看部署在 Azure 上的工作中的 Relecloud 应用程序。

    复制单词 - Endpoint: 后的第一个 URL,并将其粘贴到 Web 浏览器的位置栏中,以查看在 Azure 中实时运行的示例 Web 应用项目。

  7. 在 Web 浏览器中打开一个新选项卡。

    1. 复制上一步骤中的第二个 URL 并将其粘贴到位置栏中。
    2. Azure门户显示部署到托管示例 Web 应用项目的新资源组中的所有服务。

编辑和重新部署

接下来,对 Web 应用进行少量更改,然后重新部署它。

  1. 打开Visual Studio Code并打开 azdtest 文件夹。

  2. 此模板配置为选择性地使用开发容器。 当看到开发容器通知显示在Visual Studio Code中时,请选择“容器”中的“打开”按钮按钮。

  3. 使用 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>
    

    保存更改。

  4. 若要使用更改重新部署应用,请在终端中运行以下命令:

    azd deploy
    

    由于你使用的是开发容器并远程连接到容器的 shell,因此不要使用 Visual Studio Code 的终端窗格来运行 azd 命令。

  5. 命令完成后,刷新 Web 浏览器以查看更新。 根据所使用的 Web 托管平台,更改可能需要几分钟才能显示。

    现在,你已准备好编辑和删除模板中的文件。 有关详细信息,请参阅 可以在模板中编辑或删除哪些内容?

清理资源

  1. 通过运行 命令清理模板创建的资源。

    azd down
    

    azd down 命令删除Azure资源和GitHub Actions工作流。 出现提示时,同意删除与资源组关联的所有资源。

    还可以删除 azdtest 文件夹,或者通过修改项目的文件将其用作你自己的应用程序的基础。

故障排除

如果您在 时发现错误,请尝试以下步骤:

  • 运行 以删除命令创建的任何资源。 或者,可以删除在Azure门户中创建的资源组。
  • 删除本地计算机上的 azdtest 文件夹。
  • 在 Azure 门户网站中,搜索 Key Vaults。 选择“ 管理已删除的保管库”,选择订阅,选择包含名称 azdtest 的所有密钥保管库或任何你命名的环境,然后选择“ 清除”。
  • 请重试本快速入门中的步骤。 出现提示时,请为环境选择更简单的名称。 请尝试短名称、小写字母、无数字、无大写字母和无特殊字符。
  • 重试快速入门步骤时,请选择其他位置。

有关可能问题和解决方案的更全面的列表,请参阅 常见问题解答。