在 Azure 中生成容器化的 Python Web 应用

本文是 5 部分教程系列的第 3 部分，介绍如何容器化和部署 Python Web 应用以Azure 应用服务。在第 2 部分中，你在本地构建并运行了容器映像。本文介绍如何直接在 Azure 容器注册表中生成相同的Python Web 应用，而无需在本地安装 Docker。在 Azure 中生成映像通常比在本地生成更快、更轻松，然后将其推送到注册表。基于云的映像生成还无需在开发环境中运行 Docker。

Azure 应用服务允许从 Docker 中心、Azure 容器注册表和 Azure DevOps 等平台使用 CI/CD 管道部署和运行容器化 Web 应用。 Docker 映像进入Azure 容器注册表后，即可将其部署到Azure 应用服务。

先决条件

在开始之前，请确保已完成本系列教程的第 2 部分，其中包括：

克隆示例存储库（Django 或 Flask）。
为Azure资源创建资源组。
在本地运行容器化应用以验证它是否正常工作。

还需要：

一个处于活动状态的 Azure 订阅。如果没有帐户，请创建一个免费帐户。
在本地安装Azure CLI（对于Azure CLI步骤），或访问Azure Cloud Shell。
已安装 Docker 扩展的 Visual Studio Code（用于 VS Code 步骤）。

重要

该示例 Dockerfile 使用 python:3.8-slim 作为基础镜像。 2024 年 10 月，Python 3.8 已达到生命周期结束，不再收到安全更新。更新 Dockerfile 以使用 python:3.12-slim 或 python:3.13-slim 用于生产部署。

此服务关系图突出显示了本文中介绍的组件。

Azure CLI
VS Code

创建 Azure 容器注册表

如果已有Azure 容器注册表，请跳过此步骤，然后继续执行下一步。否则，请使用Azure CLI创建新的Azure 容器注册表。

可以在Azure Cloud Shell或安装了Azure CLI的本地开发环境中运行Azure CLI命令。

注意

使用与本教程系列的第 2 部分相同的名称。

使用 az acr create 命令创建Azure容器注册表。

Bash
PowerShell

#!/bin/bash
# Use the resource group that you created in part 2 of this tutorial series.
RESOURCE_GROUP_NAME='msdocs-web-app-rg'
# REGISTRY_NAME must be unique within Azure and contain 5-50 alphanumeric characters.
# If the name is already taken, you'll receive an error. Choose a different name and retry.
REGISTRY_NAME='msdocscontainerregistryname'

echo "Creating Azure Container Registry $REGISTRY_NAME..."
az acr create -g $RESOURCE_GROUP_NAME -n $REGISTRY_NAME --sku Standard

# PowerShell syntax
# Use the resource group that you created in part 2 of this tutorial series.
$RESOURCE_GROUP_NAME='msdocs-web-app-rg'
# REGISTRY_NAME must be unique within Azure and contain 5-50 alphanumeric characters.
# If the name is already taken, you'll receive an error. Choose a different name and retry.
$REGISTRY_NAME='msdocscontainerregistryname'

Write-Output "Creating Azure Container Registry $REGISTRY_NAME..."
az acr create -g $RESOURCE_GROUP_NAME -n $REGISTRY_NAME --sku Standard

在命令的 JSON 输出中，找到 loginServer 该值。此值表示完全限定的注册表名称（全部小写），并包含注册表名称。

示例输出：

{
  "loginServer": "msdocscontainerregistryname.azurecr.io",
  "name": "msdocscontainerregistryname",
  ...
}

如果在本地计算机上使用Azure CLI，请运行 az acr login 命令以登录到容器注册表。
```
az acr login -n $REGISTRY_NAME
```
该 -n 参数接受短注册表名称（例如） msdocscontainerregistryname或完全限定的注册表名称（msdocscontainerregistryname.azurecr.io）。该命令使用Azure CLI凭据通过Azure 容器注册表对 Docker 进行身份验证。

预期输出：
```
Login Succeeded
```
注意

如果使用Azure Cloud Shell，则无需运行az acr login命令，因为Cloud Shell会话会自动处理身份验证。

在 Azure 容器注册表中生成映像

可以通过各种方法直接在 Azure 中生成容器映像：

Azure Cloud Shell使你能够完全在云中构建映像，而独立于本地环境。
或者，可以使用 VS Code 或Azure CLI从本地设置Azure中创建映像，而无需在本地运行 Docker。

你可以在本地开发环境中使用已安装的 Azure CLI或在Azure Cloud Shell中运行 Azure CLI 命令。

在控制台中，从本教程系列的第 2 部分转到克隆存储库的根文件夹。

使用 az acr build 命令生成容器映像。

本地开发：

az acr build -r $REGISTRY_NAME -g $RESOURCE_GROUP_NAME -t msdocspythoncontainerwebapp:latest .

Azure Cloud Shell：

如果使用Azure Cloud Shell，请指定GitHub存储库 URL 而不是本地路径（.）：

# For Django sample:
az acr build -r $REGISTRY_NAME -g $RESOURCE_GROUP_NAME -t msdocspythoncontainerwebapp:latest https://github.com/Azure-Samples/msdocs-python-django-container-web-app.git

# For Flask sample:
az acr build -r $REGISTRY_NAME -g $RESOURCE_GROUP_NAME -t msdocspythoncontainerwebapp:latest https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.git

最后一个参数（. 或 Git URL）是 Docker 生成上下文，该目录包含 Docker 用于生成映像的 Dockerfile 和应用程序文件。

使用 az acr repository list 命令确认容器映像是否已创建。
```
az acr repository list -n $REGISTRY_NAME
```
预期输出：
```
[
  "msdocspythoncontainerwebapp"
]
```

创建 Azure 容器注册表

如果已有Azure 容器注册表，则可以跳过此步骤。否则，请使用 VS Code 创建新的Azure 容器注册表。

重要

本部分中的步骤假定你之前已完成本教程系列第 2 部分的 VS Code 部分。

在 VS Code 中的 Docker 扩展中，转到 REGISTRIES 并选择Azure以连接到Azure 容器注册表。
在 VS Code 中，选择 F1 或 Ctrl+Shift+P 以打开命令面板。然后键入“注册表”并选择 Azure 容器注册表：创建注册表 任务。

或者，在 Docker 扩展 REGISTRIES 部分中，右键单击订阅，然后选择 创建注册表。此操作将启动同样的创建注册表任务。
按照提示输入以下值：
- 注册表名称：输入唯一名称，例如 msdocscontainerregistryname。注册表名称在Azure中必须全局唯一，并且包含 5-50 个字母数字字符。如果名称已被采用，请选择其他名称。
- SKU：选择标准。
- 资源组：使用现有资源组。
在 Docker 扩展的“REGISTRIES”部分中，找到创建的注册表，右键单击并选择 “查看属性”。

在输出中，找到 loginServer 值 - 完全限定的注册表名称（例如， msdocscontainerregistryname.azurecr.io）。

示例输出：
```
{
  "loginServer": "msdocscontainerregistryname.azurecr.io",
  "name": "msdocscontainerregistryname",
  ...
}
```

在 Azure 容器注册表中生成映像

可以通过各种方法直接在 Azure 中生成容器映像：

Azure Cloud Shell使你能够完全在云中构建映像，而独立于本地环境。
或者，可以使用 VS Code 或Azure CLI从本地设置Azure中创建映像，而无需在本地运行 Docker。

这些步骤要求在 Web 应用的工作文件夹中打开 VS Code。

在 Docker 扩展中，单击 REGISTRIES ，然后单击 Azure 连接到 Azure 容器注册表。
选择 F1 或 CTRL+SHIFT+P 打开命令面板，键入“注册表”，然后选择 Azure 容器注册表：在 Azure 任务中生成映像。

如果未看到该任务，请确保 Azure 出现在 Docker 扩展中的注册表下面。你还可以右键单击 Dockerfile，然后选择在 Azure 中构建镜像来运行任务。
输入以下值，并按照提示创建映像。
- 标记映像：使用映像名称“msdocspythoncontainerwebapp:latest”。
- 注册表提供程序：选择 Azure。
- 订阅：选择用于创建 Azure 容器注册表的订阅。
- 注册表：选择创建的注册表或有权访问的注册表。
- 基本 OS 映像：选择 Linux。
查看输出窗口，了解生成的进度和相关信息。如果收到凭据错误，请在 Docker 扩展的 REGISTRIES 部分中右键单击注册表，然后选择刷新。
确认 Azure 容器注册表中的映像。
1. 在 Docker 扩展的 REGISTRIES 部分中，找到创建的容器映像。可能需要关闭并重新打开 VS Code 才能查看映像。
2. 确认名称和标记是最新的。
CLI 验证（可选）：

使用Azure CLI验证映像：
```
az acr repository list -n $REGISTRY_NAME
```
预期输出：
```
[
  "msdocspythoncontainerwebapp"
]
```

下一步

部署 Web 应用

反馈

此页面是否有帮助？

Last updated on 2026-06-23

在 Azure 中生成容器化的 Python Web 应用

先决条件

创建 Azure 容器注册表

在 Azure 容器注册表中生成映像

下一步

反馈

其他资源