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

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

项目
12/22/2024

在本教程中，你要将一个使用 Azure Database for PostgreSQL 关系数据库服务的数据驱动 Python Web 应用（Django 或 Flask）部署到 Azure 应用服务。 Azure 应用服务支持 Linux 服务器环境中的 Python。

若要完成本教程，你需要：

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

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

Flask
Django

安装 Azure 开发人员 CLI 后，可以部署本教程所示的完全配置的示例应用，并查看它在 Azure 中的运行情况。只需在空的工作目录中运行以下命令：

azd auth login
azd init --template msdocs-flask-postgresql-sample-app
azd up

安装 Azure Developer CLI 后，可以在空的工作目录中运行以下命令，跳到本教程末尾：

azd auth login
azd init --template msdocs-django-postgresql-sample-app
azd up

示例应用程序

我们提供了使用 Flask 和 Django 框架的示例 Python 应用程序来帮助你学习本教程。若要部署这些应用程序但不在本地运行它们，请跳过本部分。

若要在本地运行应用程序，请确保在本地安装 Python 3.7 或更高版本和 PostgreSQL。然后克隆示例存储库的 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

使用 .env.sample 文件作为指南创建 .env 文件，如下所示。将 DBNAME 的值设置为本地 PostgreSQL 实例中现有数据库的名称。根据本地 PostgreSQL 实例设置相应的 DBHOST、DBUSER 和 DBPASS 值。

DBNAME=<database name>
DBHOST=<database-hostname>
DBUSER=<db-user-name>
DBPASS=<db-password>

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

DBNAME=<database name>
DBHOST=<database-hostname>
DBUSER=<db-user-name>
DBPASS=<db-password>

通过在终端提示符下运行以下命令，为应用创建 SECRET_KEY 值：python -c 'import secrets; print(secrets.token_hex())'。

将返回的值设置为 .env 文件中 SECRET_KEY 的值。

SECRET_KEY=<secret-key>

为应用创建一个虚拟环境：

Windows
macOS/Linux

py -m venv .venv
.venv\scripts\activate

python3 -m venv .venv
source .venv/bin/activate

安装依赖项：

pip install -r requirements.txt

使用以下命令运行示例应用程序：

Flask
Django

# Run database migration
flask db upgrade
# Run the app at http://127.0.0.1:5000
flask run

# Run database migration
python manage.py migrate
# Run the app at http://127.0.0.1:8000
python manage.py runserver

1. 创建应用服务和 PostgreSQL

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

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

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

Flask
Django

步骤 1：在 Azure 门户中：

在 Azure 门户顶部的搜索栏中，输入“Web 应用数据库”。
选择“市场”标题下标记为“Web 应用 + 数据库”的项目。还可以直接导航到创建向导。

步骤 2：在“创建 Web 应用 + 数据库”页上，按下面所述填写表单。

资源组 → 选择“新建”，然后使用名称 msdocs-python-postgres-tutorial。
区域 → 与你靠近的任何 Azure 区域。
名称 → msdocs-python-postgres-XYZ，其中 XYZ 是任意三个随机字符。该名称在 Azure 中必须唯一。
运行时堆栈 → Python 3.10。
数据库 → 默认已选择“PostgreSQL 灵活服务器”作为数据库引擎。默认情况下，服务器名称和数据库名称也会设置为适当的值。
托管计划 → 基本。准备就绪后，可以稍后纵向扩展到生产定价层。
选择“查看 + 创建”。
验证完成后，选择“创建”。

步骤 3：该部署需要数分钟才能完成。部署完成后，选择“转到资源”按钮。这将直接转到应用服务应用，但会创建以下资源：

资源组 → 所有已创建资源的容器。
应用服务计划 → 定义应用服务的计算资源。将创建基本层中的 Linux 计划。
应用服务 → 表示应用，且在应用服务计划中运行。
虚拟网络 → 与应用服务应用集成，并隔离后端网络流量。
Azure Database for PostgreSQL 灵活服务器 → 只能从虚拟网络内部访问。你的数据库和用户创建于此服务器上。
专用 DNS 区域 → 在虚拟网络中启用 PostgreSQL 服务器的 DNS 解析。

2.安全连接机密

创建向导已经为你生成了数据库连接字符串作为应用设置。但是，安全最佳做法是将机密完全保留在应用服务之外。你需要借助服务连接器将机密移到密钥保管库，并将应用设置更改为密钥保管库引用。

步骤 1：检索现有的连接字符串

在应用服务页面的左侧菜单中，选择“设置”>“环境变量”。
选择“AZURE_POSTGRESQL_CONNECTIONSTRING”。
在“添加/编辑应用程序设置”的“值”字段中，找到字符串末尾的“Password=”部分。
复制“Password=”后的密码字符串供以后使用。此应用设置允许连接到受专用终结点保护的 Postgres 数据库。但是，机密直接保存在应用服务应用中，这不是最好的做法。你将对此进行更改。

步骤 2：创建密钥保管库以安全管理机密

在顶部搜索栏中，键入“密钥保管库”，然后选择“市场”>“密钥保管库”。
在“资源组”中，选择“msdocs-python-postgres-tutorial”。
在“密钥保管库名称”中，键入仅包含字母和数字的名称。
在“区域”中，将其设置为资源组所在的同一位置。

步骤 3：使用专用终结点保护密钥保管库

选择“网络”选项卡。
取消选择“启用公共访问”。
选择“创建专用终结点”。
在“资源组”中，选择“msdocs-python-postgres-tutorial”。
在“名称”中，键入仅包含字母和数字的专用终结点名称。
在“区域”中，将其设置为资源组所在的同一位置。
在对话框中，在“位置”中，选择与应用服务应用相同的位置。
在“资源组”中，选择“msdocs-python-postgres-tutorial”。
在“名称”中，键入“msdocs-python-postgres-XYZVaultEndpoint”。
在“虚拟网络”中，选择“msdocs-python-postgres-XYZVnet”。
在“子网”中，选择“msdocs-python-postgres-XYZSubnet”。
选择“确定”。
依次选择“查看 + 创建”、“创建”。等待密钥保管库部署完成。应会看到“部署已完成”。

步骤 4：配置服务连接器

在顶部搜索栏中，键入“msdocs-python-postgres”，然后选择名为“msdocs-python-postgres-XYZ”的应用服务资源。
在应用服务页面的左侧菜单中，选择“设置”>“服务连接器”。已经有一个连接器，该连接器是为你创建的应用创建向导。
选中连接器旁边的复选框，然后选择“编辑”。
在“基本信息”选项卡的“PostgreSQL 数据库”下，选择创建的 PostgreSQL 数据库。
选择“身份验证”选项卡。
在“密码”中，粘贴你之前复制的密码。
选择“在密钥保管库中存储机密”。
在“密钥保管库连接”下，选择“创建新连接”。在编辑对话框顶部打开“创建连接”对话框。

步骤 5：建立密钥保管库连接

在密钥保管库连接的“创建连接”对话框中，在“密钥保管库”中选择之前创建的密钥保管库。
选择“查看 + 创建” 。
验证完成后，选择“创建”。

步骤 6：完成服务连接器配置

你将返回到“defaultConnector”的编辑对话框中。在“身份验证”选项卡中，等待创建密钥保管库连接器。完成后，“密钥保管库连接”下拉列表会自动选择相应选项。
选择“下一页:网络”。
选择“保存”。等待“更新成功”通知出现。

步骤 7：验证密钥保管库集成

在左侧菜单中，再次选择“设置”>“环境变量”。
在“AZURE_POSTGRESQL_CONNECTIONSTRING”旁边，选择“显示值”。该值应为 @Microsoft.KeyVault(...)，这意味着它是密钥保管库引用，因为密钥保管库中现在管理机密。

概括而言，该过程涉及到从应用服务的环境变量中检索 PostgreSQL 连接字符串，创建 Azure 密钥保管库以通过专用访问进行安全机密管理，并更新服务连接器以将密码存储在密钥保管库中。使用系统分配的托管标识在应用服务应用与密钥保管库之间建立了安全连接，并验证了设置（验证方式是确认连接字符串使用密钥保管库引用）。

遇到问题？检查故障排除部分。

3. 部署示例代码

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

Flask
Django

步骤 1：在新浏览器窗口中：

登录到 GitHub 帐户。
导航到 https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app。
选择“Fork”。
选择“创建分支”。

步骤 2：在 GitHub 页中，按 . 键在浏览器中打开 Visual Studio Code。

步骤 3：在浏览器上的 Visual Studio Code 中，在资源管理器中打开“azureproject/production.py”。查看生产环境中使用的环境变量，包括在配置页中看到的应用设置。

步骤 4：返回“应用服务”页，在左侧菜单中，选择“部署中心”。

步骤 5：在“部署中心”页中：

在“源”中，选择“GitHub”。默认情况下，选择 GitHub Actions 作为生成提供程序。
登录到 GitHub 帐户，并按照提示授权 Azure。
在“组织”中，选择你的帐户。
在“存储库”中，选择“msdocs-flask-postgresql-sample-app”。
在“分支”中，选择“主”。
保留所选的默认选项以添加工作流。
在“身份验证类型”下，选择“用户分配的标识”。
在顶部菜单中，选择“保存”。应用服务会将工作流文件提交到所选 GitHub 存储库中（在 .github/workflows 目录中）。

步骤 6：在“部署中心”页中：

选择“日志”。部署运行已启动。
在部署运行的日志项中，选择“生成/部署日志”。

步骤 7：你已转到 GitHub 存储库，并看到 GitHub Action 正在运行。工作流文件定义两个单独的阶段，即生成和部署阶段。等待 GitHub 运行以显示“完成”状态。此过程大约需要 5 分钟。

步骤 1：在新浏览器窗口中：

登录到 GitHub 帐户。
导航到 https://github.com/Azure-Samples/msdocs-django-postgresql-sample-app。
选择“Fork”。
选择“创建分支”。

步骤 2：在 GitHub 页中，按 . 键在浏览器中打开 Visual Studio Code。

步骤 4：返回“应用服务”页，在左侧菜单中，选择“部署中心”。

步骤 5：在“部署中心”页中：

在“源”中，选择“GitHub”。默认情况下，选择 GitHub Actions 作为生成提供程序。
登录到 GitHub 帐户，并按照提示授权 Azure。
在“组织”中，选择你的帐户。
在“存储库”中，选择“msdocs-django-postgresql-sample-app”。
在“分支”中，选择“主”。
在顶部菜单中，选择“保存”。应用服务会将工作流文件提交到所选 GitHub 存储库中（在 .github/workflows 目录中）。

步骤 6：在“部署中心”页中：

选择“日志”。部署运行已启动。
在部署运行的日志项中，选择“生成/部署日志”。

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

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

步骤 1：返回“应用服务”页，在左侧菜单中，

选择“SSH”。
选择“转到”。

步骤 2：在 SSH 终端中运行 flask db upgrade。如果该命令成功，则应用服务会成功连接到数据库。只有对 /home 中文件的更改才能在应用重启之后持久保存。不会保留 /home 外部的更改。

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

步骤 1：返回“应用服务”页，在左侧菜单中，

选择“SSH”。
选择“转到”。

步骤 2：在 SSH 终端中运行 python manage.py migrate。如果该命令成功，则应用服务会成功连接到数据库。只有对 /home 中文件的更改才能在应用重启之后持久保存。不会保留 /home 外部的更改。

提示

在 SSH 会话中，对于 Django，还可以使用 python manage.py createsuperuser 命令创建用户，就像在典型的 Django 应用中所做的那样。有关详细信息，请参阅 django django-admin 和 manage.py 的文档。使用超级用户帐户访问网站的 /admin 部分。对于 Flask，请使用 Flask-admin 之类的扩展来提供相同的功能。

5.浏览到应用

Flask
Django

步骤 1：在“应用服务”页中：

从左侧菜单中选择“概述”。
选择应用的 URL。你也可以直接导航到 https://<app-name>.azurewebsites.net。

步骤 2：在列表中添加几家餐厅。恭喜，你已在 Azure 应用服务中运行了一个 Web 应用，并安全连接到了 Azure Database for PostgreSQL。

步骤 1：在“应用服务”页中：

从左侧菜单中选择“概述”。
选择应用的 URL。你也可以直接导航到 https://<app-name>.azurewebsites.net。

步骤 2：在列表中添加几家餐厅。恭喜，你已在 Azure 应用服务中运行了一个 Web 应用，并安全连接到了 Azure Database for PostgreSQL。

主页会显示上次访问的餐馆名称，并将数据保存到 Azure 缓存中并从中检索。请记住，示例应用使用了向导为你创建的连接字符串 AZURE_REDIS_CONNECTIONSTRING。

6.流式传输诊断日志

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

Flask
Django

@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)

步骤 1：在“应用服务”页中：

从左菜单中选择“应用服务日志”。
在“应用程序日志记录”下，选择“文件系统”。
在顶部菜单中，选择“保存”。

步骤 2：在左侧菜单中，选择“日志流”。将显示应用的日志，包括平台日志和容器内部的日志。

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

7.清理资源

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

步骤 1：在 Azure 门户顶部的搜索栏中：

输入资源组名称。
选择前面创建的资源组。

步骤 2：在资源组页上，选择“删除资源组”。

步骤 3：

输入资源组名称以确认删除。
选择“删除”。

：

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

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

如果尚未执行以上操作，请在本地终端中克隆示例存储库的 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

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

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

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

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

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

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

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

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

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

在 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

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 环境变量。

conn_str = os.environ['AZURE_POSTGRESQL_CONNECTIONSTRING']
conn_str_params = {pair.split('=')[0]: pair.split('=')[1] for pair in conn_str.split(' ')}    
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': conn_str_params['dbname'],
        'HOST': conn_str_params['host'],
        'USER': conn_str_params['user'],
        'PASSWORD': conn_str_params['password'],
    }
}

CACHES = {
        "default": {  
            "BACKEND": "django_redis.cache.RedisCache",
            "LOCATION": os.environ.get('AZURE_REDIS_CONNECTIONSTRING'),
            "OPTIONS": {
                "CLIENT_CLASS": "django_redis.client.DefaultClient",
                "COMPRESSOR": "django_redis.compressors.zlib.ZlibCompressor",
        },
    }
}

应用程序代码现已配置为连接到 Azure 中的 PostgreSQL 数据库和 Redis 缓存。

在终端中运行 azd deploy。
```
azd deploy
```

4. 生成数据库架构

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

Flask
Django

在 azd 输出中，找到 SSH 会话的 URL，并在浏览器中导航到该 URL。它在输出中如下所示：
```
 Open SSH session to App Service container at: https://<app-name>.scm.azurewebsites.net/webssh/host
 
```
在 SSH 终端中运行 flask db upgrade。如果该命令成功，则应用服务会成功连接到数据库。

注意

只有对 /home 中文件的更改才能在应用重启之后持久保存。不会保留 /home 外部的更改。

在 azd 输出中，找到 SSH 会话的 URL，并在浏览器中导航到该 URL。它在输出中如下所示：
```
 Open SSH session to App Service container at: https://<app-name>.scm.azurewebsites.net/webssh/host
 
```
在 SSH 终端中运行 python manage.py migrate。如果该命令成功，则应用服务会成功连接到数据库。

注意

只有对 /home 中文件的更改才能在应用重启之后持久保存。不会保留 /home 外部的更改。

5.浏览到应用

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

 Deploying services (azd deploy)

   (✓) Done: Deploying service web
   - Endpoint: https://<app-name>.azurewebsites.net/

在列表中添加几家餐厅。
- Flask
- Django
恭喜，你已在 Azure 应用服务中运行了一个 Web 应用，并安全连接到了 Azure Database for PostgreSQL。

6.流式传输诊断日志

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

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

Flask
Django

@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.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

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

7.清理资源

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

azd down

疑难解答

下面列出了尝试完成本教程时可能遇到的问题以及解决这些问题的步骤。

无法连接到 SSH 会话

如果你无法连接到 SSH 会话，则表示应用本身已启动失败。请查看诊断日志了解详细信息。例如，如果看到类似于 KeyError: 'AZURE_POSTGRESQL_CONNECTIONSTRING' 的错误，则可能表示缺少环境变量（你可能已删除应用设置）。

运行数据库迁移时出错

如果遇到与连接数据库相关的任何错误，请检查应用设置 (AZURE_POSTGRESQL_CONNECTIONSTRING) 是否已更改。如果没有该连接字符串，则 migrate 命令将无法与数据库通信。

常见问题

此设置花费有多大？
如何使用其他工具连接到在虚拟网络后面受保护的 PostgreSQL 服务器？
本地应用开发如何处理 GitHub Actions？
如何将 Django 示例配置为在 Azure 应用服务上运行？

此设置花费有多大？

所创建资源的定价如下所示：

应用服务计划在基本层中创建，可以进行纵向扩展或缩减。请参阅应用服务定价。
PostgreSQL 灵活服务器是在最低可突发层 Standard_B1ms 中创建的，该层提供最小的存储大小，但可以纵向扩展或缩减。请参阅 Azure Database for PostgreSQL 定价。
除非配置额外的功能（例如对等互连），否则虚拟网络不会产生费用。请参阅 Azure 虚拟网络定价。
专用 DNS 区域会产生少量费用。请参阅 Azure DNS 定价。

如何使用其他工具连接到在虚拟网络后面受保护的 PostgreSQL 服务器？

要从命令行工具进行基本访问，可以从应用的 SSH 终端运行 psql。
若要从桌面工具进行连接，计算机必须位于虚拟网络中。例如，它可以是连接到其中一个子网的 Azure VM，也可以是与 Azure 虚拟网络建立了站点到站点 VPN 连接的本地网络中的计算机。
还可以将 Azure Cloud Shell 与虚拟网络集成。

本地应用开发如何与 GitHub Actions 配合使用？

以应用服务中自动生成的工作流文件为例，每个 git push 都会启动新的生成和部署运行。从 GitHub 存储库的本地克隆中，进行所需更新并推送到 GitHub。例如：

git add .
git commit -m "<some-message>"
git push origin main

如何将 Django 示例配置为在 Azure 应用服务上运行？

注意

如果使用自己的应用按照本教程中所述内容进行操作，请查看每个项目的 README.md 文件中的 requirements.txt 文件说明（Flask、Django），以了解自己需要的包。

Django 示例应用程序在 azureproject/production.py 文件中配置设置，使它可以在 Azure 应用服务中运行。将 Django 部署到生产环境时经常会做出这些更改，它们并非特定于应用服务。

Django 验证传入请求中的 HTTP_HOST 标头。示例代码使用应用服务中的 WEBSITE_HOSTNAME 环境变量将应用的域名添加到 Django 的 ALLOWED_HOSTS 设置。

# Configure the domain name using the environment variable
# that Azure automatically creates for us.
ALLOWED_HOSTS = [os.environ['WEBSITE_HOSTNAME']] if 'WEBSITE_HOSTNAME' in os.environ else []

Django 不支持在生产中提供静态文件。对于本教程，请使用 WhiteNoise 来支持提供文件。 WhiteNoise 包已与 requirements.txt 一起安装，其中间件已添加到列表中。


# WhiteNoise configuration
MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    # Add whitenoise middleware after the security middleware
    'whitenoise.middleware.WhiteNoiseMiddleware',

然后根据 Django 文档配置静态文件设置。

SESSION_ENGINE = "django.contrib.sessions.backends.cache"
STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'

有关详细信息，请参阅 Django 应用的生产设置。

后续步骤

请继续学习下一教程，了解如何使用自定义域和证书保护应用。

使用自定义域和证书进行保护

了解应用服务如何运行 Python 应用：

配置 Python 应用

通过

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

示例应用程序

1. 创建应用服务和 PostgreSQL

2.安全连接机密

3. 部署示例代码

4. 生成数据库架构

5.浏览到应用

6.流式传输诊断日志

7.清理资源

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

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

4. 生成数据库架构

5.浏览到应用

6.流式传输诊断日志

7.清理资源

疑难解答

无法连接到 SSH 会话

运行数据库迁移时出错

常见问题

此设置花费有多大？

如何使用其他工具连接到在虚拟网络后面受保护的 PostgreSQL 服务器？

本地应用开发如何与 GitHub Actions 配合使用？

如何将 Django 示例配置为在 Azure 应用服务上运行？

后续步骤

反馈

其他资源

通过

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

跳到末尾

示例应用程序

1. 创建应用服务和 PostgreSQL

2.安全连接机密

3. 部署示例代码

4. 生成数据库架构

5.浏览到应用

6.流式传输诊断日志

7.清理资源

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

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

4. 生成数据库架构

5.浏览到应用

6.流式传输诊断日志

7.清理资源

疑难解答

无法连接到 SSH 会话

运行数据库迁移时出错

常见问题

此设置花费有多大？

如何使用其他工具连接到在虚拟网络后面受保护的 PostgreSQL 服务器？

本地应用开发如何与 GitHub Actions 配合使用？

如何将 Django 示例配置为在 Azure 应用服务上运行？

后续步骤

反馈

其他资源