在 Azure 中部署使用 PostgreSQL 的 Python（Django 或 Flask）Web 应用

• 具有活动订阅的 Azure 帐户。 如果没有 Azure 帐户，可创建一个试用帐户。
• 了解使用 Flask 的 Python 开发或使用 Django 的 Python 开发

• 具有活动订阅的 Azure 帐户。 如果没有 Azure 帐户，可创建一个试用帐户。
• 已安装 Azure 开发人员 CLI。 可以使用 Azure Cloud Shell 执行这些步骤，因为它已安装 Azure 开发人员 CLI。

1. 创建应用服务和 PostgreSQL

git clone https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app.git

git clone https://github.com/Azure-Samples/msdocs-django-postgresql-sample-app.git

此步骤创建 Azure 资源。 本教程中使用的步骤创建一组默认安全的资源，其中包括应用服务和 Azure Database for PostgreSQL。 此创建过程中，你将指定：

• Web 应用的名称。 此名称用作 Web 应用的 DNS 名称的一部分，其格式为 https://<app-name>.chinacloudsites.cn。
• “区域”，在世界上以物理方式运行应用。
• 应用的运行时堆栈。 在此处选择要用于应用的 Python 版本。
• 应用的托管计划。 它是定价层，包括应用的一组功能和缩放容量。
• 应用的资源组。 使用资源组可将应用程序所需的所有 Azure 资源分组到一个逻辑容器中。

登录到 Azure 门户并按照以下步骤创建 Azure 应用服务资源。

2. 验证连接设置

创建向导已经为你生成了连接变量作为应用设置。 使用应用设置可以将连接机密保留在代码存储库之外。 准备好将机密移动到更安全的位置后，下面提供了一篇有关在 Azure 密钥保管库中存储的文章。

3. 部署示例代码

在此步骤中，你将使用 GitHub Actions 配置 GitHub 部署。 这只是部署到应用服务的许多方法之一，也是一种在部署过程中持续集成的好方法。 默认情况下，GitHub 存储库的每个 git push 都会启动生成和部署操作。

遇到问题？ 查看故障排除指南。

4. 生成数据库架构

5.浏览到应用

6.流式传输诊断日志

Azure 应用服务会捕获输出到控制台的所有消息，以帮助你诊断应用程序的问题。 示例应用包含了 print() 语句用于演示此功能，如下所示。

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

def index(request):
    print('Request for index page received')
    restaurants = Restaurant.objects.annotate(avg_rating=Avg('review__rating')).annotate(review_count=Count('review'))
    return render(request, 'restaurant_review/index.html', {'restaurants': restaurants})

在为 Python 应用程序设置 Azure Monitor 系列文章中，详细了解 Python 应用中的日志记录。

7.清理资源

完成后，可以通过删除资源组从 Azure 订阅中删除所有资源。

1.创建 Azure 资源并部署示例应用

在此步骤中，将创建 Azure 资源并将示例应用部署到 Linux 上的应用服务。 本教程中使用的步骤创建一组默认安全的资源，其中包括应用服务和 Azure Database for PostgreSQL。

1. 如果尚未执行以上操作，请在本地终端中克隆示例存储库的 starter-no-infra 分支。

   • Flask
   • Django

   git clone -b starter-no-infra https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app
   cd msdocs-flask-postgresql-sample-app
   

   此克隆分支是你的起点。 它包含简单的数据驱动 Flask 应用程序。

2. 从存储库根路径，运行 azd init。

   azd init --template python-app-service-postgresql-infra
   

3. 出现提示时，请提供以下答案：

   问题	Answer
   当前目录不为空。 是否要在此处初始化“<your-directory>”中的项目？	Y
   你希望对这些文件执行哪些操作？	使现有文件保持不变
   输入新环境名称	键入唯一名称。 azd 模板将此名称用作 Azure 中 Web 应用的 DNS 名称的一部分 (<app-name>.chinacloudsites.cn)。 允许使用字母数字字符和下划线。

4. 运行 azd up 命令以提供必要的 Azure 资源并部署应用代码。 如果尚未登录到 Azure，浏览器将启动并要求你登录。 azd up 命令还将提示选择要部署到的所需订阅和位置。

   azd up
   

   azd up 命令可能需要几分钟时间才能完成。 它还会编译和部署应用程序代码，但你稍后将修改代码以使用应用服务。 在运行时，该命令会提供有关预配和部署过程的消息，包括指向 Azure 中部署的链接。 完成后，命令还会显示指向部署应用程序的链接。

   此 azd 模板包含使用以下 Azure 资源生成安全默认体系结构的文件（azure.yaml 和 infra 目录）：

   • Flask
   • Django

   • 资源组 → 所有已创建资源的容器。
   • 应用服务计划 → 定义应用服务的计算资源。 已指定 B1 层中的 Linux 计划。
   • 应用服务 → 表示应用，且在应用服务计划中运行。
   • 虚拟网络 → 与应用服务应用集成，并隔离后端网络流量。
   • Azure Database for PostgreSQL 灵活服务器 → 只能从虚拟网络内部访问。 你的数据库和用户创建于此服务器上。
   • 专用 DNS 区域 → 在虚拟网络中启用 PostgreSQL 服务器的 DNS 解析。
   • Log Analytics 工作区 →充当应用日志传送的目标容器，还可以在其中查询日志。

2.使用数据库连接字符串

你使用的 azd 模板已为你生成了连接变量作为应用设置，并将它们输出到终端，以方便你使用。 使用应用设置可以将连接机密保留在代码存储库之外。

1. 在 azd 输出中，找到应用设置并查找设置 AZURE_POSTGRESQL_CONNECTIONSTRING 和 AZURE_REDIS_CONNECTIONSTRING。 为保护机密安全，只会显示设置名称。 它们在 azd 输出中如下所示：

    App Service app has the following settings:
   
            - AZURE_POSTGRESQL_CONNECTIONSTRING
            - AZURE_REDIS_CONNECTIONSTRING
            - FLASK_DEBUG
            - SCM_DO_BUILD_DURING_DEPLOYMENT
            - SECRET_KEY
    

2. AZURE_POSTGRESQL_CONNECTIONSTRING 包含 Azure 中 Postgres 数据库的连接字符串，AZURE_REDIS_CONNECTIONSTRING 则包含 Azure 中 Redis 缓存的连接字符串。 需要使用代码连接到它。 打开 azureproject/production.py，取消注释以下行，并保存文件：

   • Flask
   • Django

   conn_str = os.environ['AZURE_POSTGRESQL_CONNECTIONSTRING']
   conn_str_params = {pair.split('=')[0]: pair.split('=')[1] for pair in conn_str.split(' ')}
   DATABASE_URI = 'postgresql+psycopg2://{dbuser}:{dbpass}@{dbhost}/{dbname}'.format(
       dbuser=conn_str_params['user'],
       dbpass=conn_str_params['password'],
       dbhost=conn_str_params['host'],
       dbname=conn_str_params['dbname']
   )
   

   应用程序代码现已配置为连接到 Azure 中的 PostgreSQL 数据库。 如果需要，请打开 app.py 并查看如何使用 DATABASE_URI 环境变量。

3. 在终端中运行 azd deploy。

   azd deploy
   

4. 生成数据库架构

在 PostgreSQL 数据库受虚拟网络保护的情况下，运行 Flask 数据库迁移的最简单方法是使用应用服务容器在 SSH 会话中运行。

5.浏览到应用

1. 在 azd 输出中，找到应用的 URL 并在浏览器中导航到该 URL。 该 URL 在 AZD 输出中如下所示：

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>.chinacloudsites.cn/
    

2. 在列表中添加几家餐厅。

   • Flask
   • Django

   

   恭喜，你已在 Azure 应用服务中运行了一个 Web 应用，并安全连接到了 Azure Database for PostgreSQL。

6.流式传输诊断日志

Azure 应用服务可以捕获控制台日志，以帮助你诊断应用程序的问题。 为方便起见，azd 模板已启用对本地文件系统的日志记录以及将日志传送到 Log Analytics 工作区。

示例应用包含了 print() 语句用于演示此功能，如以下代码片段所示。

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

def index(request):
    print('Request for index page received')
    restaurants = Restaurant.objects.annotate(avg_rating=Avg('review__rating')).annotate(review_count=Count('review'))
    lastViewedRestaurant = request.session.get("lastViewedRestaurant", False)

在 azd 输出中，找到流式传输应用服务日志的链接，并在浏览器中导航到该链接。 该链接在 azd 输出中如下所示：

Stream App Service logs at: https://portal.azure.cn/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

在为 Python 应用程序设置 Azure Monitor 系列文章中，详细了解 Python 应用中的日志记录。

7.清理资源

若要删除当前部署环境中的所有 Azure 资源，请运行 azd down。

azd down