使用自定义容器将自定义软件迁移到 Azure 应用服务

Azure 应用服务在 Windows 上提供预定义的应用程序堆栈，例如在 IIS 上运行的 ASP.NET 或 Node.js。 预配置的 Windows 环境锁定了操作系统，不允许对其进行以下操作：

• 管理访问。
• 软件安装。
• 全局程序集缓存更改。

有关详细信息，请参阅 Azure 应用服务上的操作系统功能。

可以从 Visual Studio 部署自定义配置的 Windows 映像，以进行应用所需的 OS 更改。 因此，可以轻松迁移需要自定义 OS 和软件配置的本地应用。 本教程演示如何将使用 Windows 字体库中安装的自定义字体的 ASP.NET 应用迁移到应用服务。 你将自定义配置的 Windows 映像从 Visual Studio 部署到 Azure 容器注册表，然后在应用服务中运行它。

先决条件

为完成此教程：

• 注册 Docker 中心帐户
• 安装用于 Windows 的 Docker。
• 将 Docker 切换为运行 Windows 容器。
• 安装 Visual Studio 2022，其中包含 ASP.NET 和 Web 开发以及 Azure 开发工作负载 。 如果已安装 Visual Studio 2022：
  • 通过选择“帮助”>“检查更新”，在 Visual Studio 中安装最新更新。
  • 在 Visual Studio 中，通过选择“工具”>“获取工具和功能”，添加工作负载。

在本地设置应用

下载示例

在此步骤中，将设置本地 .NET 项目。

• 下载示例项目 。
• 提取（解压缩）custom-font-win-container-master.zip 文件。

示例项目包括一个简单的 ASP.NET 应用程序，该应用程序使用安装在 Windows 字体库中的自定义字体。 不需要安装字体。 但是，此示例是一个与基础 OS 集成的应用示例。 要将此类应用迁移到应用服务，需要重新构建代码以移除集成，或通过自定义 Windows 容器将其按原样迁移。

安装字体

在 Windows 资源管理器中，导航到“custom-font-win-container-master/CustomFontSample”，右键单击“FrederickatheGreat-Regular.ttf”，然后选择“安装” 。

运行应用

在 Visual Studio 中打开 custom-font-win-container-master/CustomFontSample.sln 文件。

键入 Ctrl+F5 在不调试的情况下运行应用。 该应用将显示在默认浏览器中。

此应用使用已安装的字体，因此无法在应用服务沙盒中运行。 但是，可以改为使用 Windows 容器对其进行部署，因为可以在 Windows 容器中安装该字体。

配置 Windows 容器

在解决方案资源管理器中，右键单击“CustomFontSample”项目，选择“添加”>“容器业务流程支持” 。

选择“Docker Compose”>“确定” 。

现在，项目设置为在 Windows 容器中运行。 Dockerfile 添加到 CustomFontSample 项目，docker-compose 项目添加到解决方案。

在解决方案资源管理器中，打开 Dockerfile。

需要使用受支持的父映像。 通过将 FROM 行替换为以下代码，更改父映像：

FROM mcr.microsoft.com/dotnet/framework/aspnet:4.7.2-windowsservercore-ltsc2019

在该文件的末尾，添加以下行并保存文件：

RUN ${source:-obj/Docker/publish/InstallFont.ps1}

可以在 CustomFontSample 项目中找到 InstallFont.ps1。 它是一个安装该字体的简单脚本。 可在 PowerShell 库中找到更复杂的脚本版本。

发布到 Azure 容器注册表

Azure 容器注册表可以存储用于容器部署的映像。 可以将应用服务配置为使用 Azure 容器注册表中托管的映像。

打开发布向导

在解决方案资源管理器中，右键单击“CustomFontSample”项目，选择“发布” 。

创建注册表并发布

在发布向导中，选择“容器注册表”>“新建 Azure 容器注册表”>“发布” 。

使用 Azure 帐户登录

在“新建 Azure 容器注册表”对话框中，选择“添加帐户”，然后登录到你的 Azure 订阅。 如果已登录，请从下拉列表中选择包含所需订阅的帐户。

配置注册表

根据下表中建议的值配置新的容器注册表。 完成后，选择“创建”。

终端窗口随即打开并显示映像部署进度。 等待部署完成。

登录 Azure

登录到 Azure 门户。

创建 Web 应用

在左侧菜单中，选择“创建资源”>“Web”>“用于容器的 Web 应用” 。

配置应用基本信息

在“基本信息”选项卡中，根据下表来配置设置，然后选择“下一步: Docker”。

“基本信息”选项卡应如下所示：

配置 Windows 容器

在“Docker”选项卡中，按下表所示配置自定义 Windows 容器，并选择“查看 + 创建”。

完成应用创建

选择“创建”，等待 Azure 创建所需的资源。

浏览到 Web 应用

Azure 操作完成后，会显示通知框。

1. 选择“转到资源”。

2. 在应用页中，选择“URL”下的链接。

如果会打开一个如以下页面所示的新浏览器页面：

等待几分钟，然后重试，直到主页显示你所需的美观字体：

恭喜！ 你已通过 Windows 容器将 ASP.NET 应用程序迁移到 Azure 应用服务。

查看容器启动日志

加载 Windows 容器可能需要一些时间。 若要查看进度，请通过将 <app-name> 替换为你的应用的名称，转到以下 URL。

https://<app-name>.scm.chinacloudsites.cn/api/logstream

流式传输的日志如下所示：

14/09/2018 23:16:19.889 INFO - Site: fonts-win-container - Creating container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest.
14/09/2018 23:16:19.928 INFO - Site: fonts-win-container - Create container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest succeeded. Container Id 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:23.405 INFO - Site: fonts-win-container - Start container succeeded. Container: 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Configuring container
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container start-up and configuration completed successfully

Azure 应用服务使用 Docker 容器技术同时托管内置映像和自定义映像。 若要查看内置映像的列表，请运行 Azure CLI 命令 'az webapp list-runtimes --os linux'。 如果这些映像无法满足需要，可以生成并部署自定义映像。

本教程介绍如何执行下列操作：

完成本教程会导致 Azure 帐户中产生一点容器注册表费用，并且可能会因为容器托管时间超过一个月而产生其他费用。

设置初始环境

本教程需要 2.0.80 或更高版本 Azure CLI。 如果你使用的是 Azure 本地 Shell，则最新版本已安装。

• 具有活动订阅的 Azure 帐户。 创建帐户。

可以使用本地 Azure CLI。

• 如果需要，请安装 Azure CLI 来运行 CLI 参考命令。

• 本地 Azure CLI，请了解如何安装 Azure CLI。 如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。 有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。

  • 通过使用 az login 命令登录到 Azure CLI。 若要完成身份验证过程，请遵循终端中显示的步骤。 有关其他登录选项，请参阅使用 Azure CLI 登录。

  • 出现提示时，请在首次使用时安装 Azure CLI 扩展。 有关扩展详细信息，请参阅使用 Azure CLI 的扩展。

  • 运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本，请运行 az upgrade。

• 安装 Docker，用于构建 Docker 映像。 安装 Docker 可能需要重启计算机。

安装 Docker 后，请打开终端窗口，验证是否已安装 Docker：

docker --version

克隆或下载示例应用

可以通过 git 克隆或下载操作获取此教程的示例。

使用 git 进行克隆

克隆示例存储库：

git clone https://github.com/Azure-Samples/docker-django-webapp-linux.git --config core.autocrlf=input

请确保包括 --config core.autocrlf=input 参数，以确保 Linux 容器中使用的文件中的行尾正确：

然后，导航到以下文件夹：

cd docker-django-webapp-linux

从 GitHub 下载

可以访问 https://github.com/Azure-Samples/docker-django-webapp-linux，依次选择“克隆”和“下载 ZIP”，而不使用 git 克隆。

将 ZIP 文件解压缩到名为 docker-django-webapp-linux 的文件夹中。

然后，在 docker-django-webapp-linux 文件夹中打开一个终端窗口。

（可选）检查 Docker 文件

示例中名为 Dockerfile 的文件，描述了 Docker 映像并包含配置说明：

FROM tiangolo/uwsgi-nginx-flask:python3.6

RUN mkdir /code
WORKDIR /code
ADD requirements.txt /code/
RUN pip install -r requirements.txt --no-cache-dir
ADD . /code/

# ssh
ENV SSH_PASSWD "root:Docker!"
RUN apt-get update \
        && apt-get install -y --no-install-recommends dialog \
        && apt-get update \
 && apt-get install -y --no-install-recommends openssh-server \
 && echo "$SSH_PASSWD" | chpasswd 

COPY sshd_config /etc/ssh/
COPY init.sh /usr/local/bin/

RUN chmod u+x /usr/local/bin/init.sh
EXPOSE 8000 2222

#CMD ["python", "/code/manage.py", "runserver", "0.0.0.0:8000"]
ENTRYPOINT ["init.sh"]

• 第一组命令在环境中安装应用的要求。
• 第二组命令创建 SSH 服务器来实现容器和主机之间的安全通信。
• 最后一行 ENTRYPOINT ["init.sh"] 调用 init.sh 来启动 SSH 服务和 Python 服务器。

在本地生成和测试映像

1. 运行以下命令生成映像：

   docker build --tag appsvc-tutorial-custom-image .
   

2. 本地运行 Docker 容器来测试生成是否有效：

   docker run -it -p 8000:8000 appsvc-tutorial-custom-image
   

   此 docker run 命令通过 -p 参数后跟映像名称来指定端口。 -it 允许通过 Ctrl+C 来停止。

   提示

   如果在 Windows 上运行时显示错误“standard_init_linux.go:211: exec 用户进程导致‘无此类文件或目录’”，则表示 init.sh 文件包含 CR-LF 行尾而不是预期的 LF 行尾。 如果使用 git 克隆示例存储库，但省略了 --config core.autocrlf=input 参数，就会发生此错误。 在这种情况下，请使用 `--config`` 参数再次克隆存储库。 如果已编辑 init.sh 并以 CRLF 结尾进行保存，也可能会发生此错误。 在这种情况下，请仅以 LF 结尾再次保存文件。

3. 浏览到 http://localhost:8000，验证 Web 应用和容器是否正常运行。

   

I. 创建用户分配的托管标识

应用服务可以使用默认托管标识或用户分配的托管标识向容器注册表进行身份验证。 本教程使用用户分配的托管标识。

II. 创建容器注册表

III. 将示例映像推送到 Azure 容器注册表

在本部分，你会将映像推送到 Azure 容器注册表，供应用服务稍后使用。

1. 在生成示例映像的本地终端中，使用 docker login 命令登录到容器注册表：

   docker login <registry-name>.azurecr.io --username <registry-username>
   

   将 <registry-name> 和 <registry-username> 替换为前面步骤中的值。 出现提示时，键入在上一步骤中获取的某个密码。

   在本部分余下的所有步骤中都使用相同的注册表名称。

2. 成功登录后，将本地 Docker 映像标记到注册表：

   docker tag appsvc-tutorial-custom-image <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

3. 使用 docker push 命令将映像推送到注册表：

   docker push <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

   第一次上传映像可能需要几分钟时间，因为它包含基本映像。 后续上传速度通常较快。

   在等待期间，可以完成下一部分中的步骤，将应用服务配置为从注册表部署。

IV. 为注册表的托管标识授权

创建的托管标识尚未获得从容器注册表拉取映像的授权。 在此步骤中，你将启用授权。

V. 创建 Web 应用

VI. 配置 Web 应用

在此步骤中，按如下方式配置 Web 应用：

• 示例容器在端口 8000 上侦听 Web 请求；将应用配置为向端口 8000 发送请求。
• 告知应用使用托管标识从容器注册表拉取映像。
• 配置从容器注册表进行持续部署（或者，每次将映像推送到注册表都会触发应用拉取新映像的操作）。 Web 应用无需此配置即可从容器注册表拉取映像，但此配置可以让 Web 应用知道何时将新映像推送到了注册表。 如果不完成此配置，则必须通过重启 Web 应用来手动触发映像拉取。

VII. 浏览到 Web 应用

首次访问时，应用可能需要一些时间来响应，因为应用服务必须从注册表中拉取整个映像。 如果浏览器超时，刷新页面即可。 拉取初始映像后，后续测试的运行速度将快得多。

VIII. 访问诊断日志

IX. 修改应用程序代码并重新部署

在本部分中，你将对 Web 应用代码进行更改，重新生成映像，然后将其推送到容器注册表。 然后，应用服务会自动从注册表中拉取更新后的映像，以更新运行的 Web 应用。

1. 在本地 docker-django-webapp-linux 文件夹中，打开文件 app/templates/app/index.html 。

2. 更改第一个 HTML 元素，使其与以下代码相匹配。

   <nav class="navbar navbar-inverse navbar-fixed-top">
     <div class="container">
       <div class="navbar-header">
         <a class="navbar-brand" href="#">Azure App Service - Updated Here!</a>
       </div>
     </div>
   </nav>
   

3. 保存所做更改。

4. 更改为 docker-django-webapp-linux 文件夹，然后重新生成映像：

   docker build --tag appsvc-tutorial-custom-image .
   

5. 将映像的标记更新为最新：

   docker tag appsvc-tutorial-custom-image <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

   将 <registry-name> 替换为注册表的名称。

6. 将映像推送到注册表：

   docker push <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

7. 映像推送完成后，Webhook 会通知应用服务有关推送的信息，应用服务会尝试在更新的映像中进行拉取。 等待几分钟，然后浏览到 https://<app-name>.chinacloudsites.cn 来验证是否已部署更新。

X. 使用 SSH 连接到容器

SSH 实现容器和客户端之间的安全通信。 若要启用到容器的 SSH 连接，必须针对该连接配置自定义映像。 容器运行后，你可以打开 SSH 连接。

为 SSH 配置容器

本教程中使用的示例应用在 Dockerfile 中已有必要的配置，该配置将安装 SSH 服务器并设置登录凭据。 本部分仅供参考。 若要连接到容器，请跳到下一部分。

ENV SSH_PASSWD "root:Docker!"
RUN apt-get update \
        && apt-get install -y --no-install-recommends dialog \
        && apt-get update \
  && apt-get install -y --no-install-recommends openssh-server \
  && echo "$SSH_PASSWD" | chpasswd 

Dockerfile 还将 sshd_config 文件复制到 /etc/ssh/ 文件夹，并在容器上公开端口 2222 ：

COPY sshd_config /etc/ssh/

# ...

EXPOSE 8000 2222

端口 2222 是一个仅供内部使用的端口，仅可供专用虚拟网络的桥网络中的容器访问。

最后，入口脚本 init.sh 启动 SSH 服务器。

#!/bin/bash
service ssh start

打开到容器的 SSH 连接

XI. 清理资源

az group delete --name msdocs-custom-container-tutorial