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

本文是有关如何将 Python Web 应用容器化和部署到 Azure 应用服务的教程的一部分。 通过应用服务，可以使用 Docker 中心、Azure 容器注册表和 Visual Studio Team Services 运行容器化 Web 应用，并通过持续集成/持续部署（CI/CD）功能进行部署。 本教程的这一部分介绍如何在云中生成容器化 Python Web 应用。

在本教程的上一 可选 部分中，已在本地生成并运行容器映像。 相反，在本教程的这一部分中，你将在 Azure 容器注册表 上将 Python Web 应用容器化为 Docker 镜像。 在 Azure 中生成映像通常比在本地生成更快、更容易，然后将映像推送到注册表。 此外，在云端构建不需要 Docker 在开发环境中运行。

Docker 映像进入 Azure 容器注册表后，即可将其部署到 Azure 应用服务。

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

创建 Azure 容器注册表

如果已有可以使用的 Azure 容器注册表，请转到下一步。 如果没有，请创建一个。

Azure CLI

可以在 Azure Cloud Shell 中或装有 Azure CLI 的工作站上运行 Azure CLI 命令。 在 Cloud Shell 中运行时，请跳过 步骤 3。

1. 使用“az group create”命令创建资源组（如果需要）。 如果您已经在本教程的 2 部分为 MongoDB 设置了 Azure Cosmos DB 帐户，并在本地生成和测试了容器，请将 RESOURCE_GROUP_NAME 环境变量设置为您用于该帐户的资源组名称，然后继续执行下一步。

   RESOURCE_GROUP_NAME='msdocs-web-app-rg'
   LOCATION='eastus'
   
   az group create -n $RESOURCE_GROUP_NAME -l $LOCATION
   

   LOCATION 应为 Azure 位置值。 选择你附近的位置。 可以使用以下命令列出 Azure 位置值：az account list-locations -o table。

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

   REGISTRY_NAME='<your Azure Container Registry name>'
   
   az acr create -g $RESOURCE_GROUP_NAME -n $REGISTRY_NAME --sku Basic
   

   REGISTRY_NAME在 Azure 中必须是唯一的，并且包含 5-50 个字母数字字符。

   在命令的 JSON 输出中，查找 loginServer 值，该值是完全限定的注册表名称（所有小写），应包括指定的注册表名称。

3. 如果在本地运行 Azure CLI，请使用 az acr login 命令登录到注册表。

   az acr login -n $REGISTRY_NAME
   

   该命令将“azurecr.io”添加到名称，以创建完全限定的注册表名称。 如果成功，你将看到消息“登录成功”。

   注意

   Cloud Shell 中不需要或不支持 az acr login 命令。

VS Code

这些步骤需要 VS Code 的 Docker 扩展。

1. 选择 F1 或 Ctrl+Shift+P 打开命令面板。 然后键入“注册表”并选择 Azure 容器注册表：创建注册表 任务。

   或者，在 Docker 扩展 REGISTRIES 部分中，右键单击订阅，然后选择 创建注册表。 此 UI 操作启动相同的创建注册表任务。

2. 按照提示输入以下值：

   • 注册表名称：注册表名称在 Azure 中必须唯一，并且包含 5-50 个字母数字字符。

   • SKU：选择标准。

   • 资源组：使用现有组或创建新组。

   • 位置：如果您使用现有资源组，请选择匹配的区域。 否则，该位置是创建包含注册表的资源组的位置。

   

3. 在 Docker 扩展的“REGISTRIES”部分中，找到创建的注册表，右键单击并选择 “查看属性”。

   在输出中查找 loginServer 键值对。 该值是注册表的完全限定名称。

   

Azure 门户

登录到 Azure 门户 并按照以下步骤创建 Azure 容器注册表。

1. 搜索“容器注册表”，然后在结果 市场 下选择 容器注册表。

2. 在“创建容器注册表 窗体的”基本信息“选项卡下，输入以下值：

   • 资源组：使用现有组或创建新组。
   • 注册表名称：注册表名称在 Azure 中必须唯一，并且包含 5-50 个字母数字字符。
   • 位置：如果使用现有资源组，请选择要匹配的位置。 否则，该位置是创建包含注册表的资源组的位置。
   • SKU：选择标准。

   

   完成后，选择审阅 + 创建。 完成验证后，选择创建。

3. 部署完成后，转到新注册表，找到完全限定的名称。

   1. 在 服务菜单上，选择 概述。
   2. 复制登录服务器值。 它应该是具有“azurecr.io”的完全限定名称。

   

4. 需要管理员帐户才能将容器映像从注册表部署到用于容器的 Azure Web 应用。

   1. 在 服务菜单上，选择 访问密钥。
   2. 为管理员用户选择已启用。

   

   使用 Azure 门户部署容器映像时，需要使用注册表 管理员帐户，如本教程所示。 管理员帐户仅在创建应用服务期间使用。 创建应用程序服务后，托管标识用于从注册表拉取映像，并且可以禁用管理员帐户。

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

可以通过多种方式直接在 Azure 中生成容器映像。 首先，可以使用 Azure Cloud Shell 来生成映像，而无需使用本地环境。 还可以使用 VS Code 或 Azure CLI 从本地环境生成 Azure 中的容器映像。 在云中生成映像不需要 Docker 在本地环境中运行。 如果需要，可以按照本教程第 2 部分中的克隆或下载示例应用中的说明获取示例 Flask 或 Django Web 应用。

Azure CLI

可以在安装了 Azure CLI 的工作站上运行 Azure CLI 命令，也可以在 Azure Cloud Shell中运行。 在 Cloud Shell 中运行时，请跳过 步骤 1。

1. 如果要在本地运行 Azure CLI，并且尚未使用 az acr login 命令登录到注册表，请使用该命令登录到注册表。

   az acr login -n $REGISTRY_NAME
   

   如果访问注册表的订阅不同于创建注册表的订阅，请使用 --suffix 开关。

   注意

   不需要 az acr login 命令，并且 Cloud Shell 中不受支持。

2. 使用 az acr build 命令生成映像。

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

   在此命令中：

   • 命令末尾的点 （“.”） 指示要生成的源代码的位置。 如果未在示例应用根目录中运行此命令，请指定代码的路径。

     您可以选择指定示例 GitHub 存储库的路径，而不是环境中的代码路径：https://github.com/Azure-Samples/msdocs-python-django-container-web-app 或 https://github.com/Azure-Samples/msdocs-python-flask-container-web-app。

   • 如果不使用 -t（与 --image 相同）选项，则命令会将本地上下文生成排入队列，而不会将其推送到注册表。 在不推送的情况下生成映像可用于检查映像是否已生成。

3. 使用 az acr repository list 命令确认已创建容器映像。

   az acr repository list -n $REGISTRY_NAME
   

VS Code

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

1. 在 Docker 扩展中，转到 REGISTRIES 并连接到 Azure。

   

2. 选择 F1 或 CTRL+SHIFT+P 打开命令面板，键入“注册表”，然后选择 Azure 容器注册表：在 Azure 任务中生成映像。

   如果未看到该任务，请确保 Azure 出现在 Docker 扩展中的注册表下面。 你还可以右键单击 Dockerfile，然后选择在 Azure 中构建镜像来运行任务。

3. 按照提示输入以下值来生成映像。

   • 标记映像：使用映像名称“msdocspythoncontainerwebapp:latest”。
   • 注册表：选择上面创建的注册表或有权访问的注册表。
   • 基本 OS 映像：选择 Linux。

   

   查看输出窗口，了解生成的进度和相关信息。 如果收到凭据错误，请在 Docker 扩展的 REGISTRIES 部分中右键单击注册表，然后选择刷新。

4. 确认 Azure 容器注册表中的映像。

   1. 在 Docker 扩展的 REGISTRIES 部分中，找到创建的容器映像。

   2. 确认名称并标记“最新”。

   

Azure 门户

登录到 Azure 门户 以完成这些步骤。

1. 打开 Azure Cloud Shell。

   

2. 使用 az acr build 命令生成映像。

   az acr build \
     -r <registry-name> \
     -g <resource-group> \
     -t msdocspythoncontainerwebapp:latest \
     <repo-path>
   

   命令中的最后一个参数是存储库的完全限定路径。 对 Django 示例应用使用 https://github.com/Azure-Samples/msdocs-python-django-container-web-app.git，并为 Flask 示例应用使用 https://github.com/Azure-Samples/msdocs-python-flask-container-web-app.git。

3. 使用 az acr repository list 命令确认已创建容器映像。

   az acr repository list -n <registry-name>
   

下一步

部署 Web 应用