将 Docker Compose 应用迁移到 Azure 应用服务中的 sidecar 容器

如果在 Azure 应用服务中运行 Docker Compose 应用，则应将其迁移到 sidecars。 将 Docker Compose 应用迁移到 sidecars 有两个主要策略。

• 基于脚本的迁移 - 建议用于简单设置。
• 手动迁移

先决条件

• PowerShell
• Azure CLI
• Docker （用于生成和推送映像）

使用脚本进行迁移

如果 Docker Compose 文件非常简单，则可以使用官方迁移脚本自动执行该过程。

1. 从 Azure 示例 GitHub 存储库下载迁移脚本。

2. 在 PowerShell 中运行脚本，提供订阅 ID、Web 应用名称、资源组、注册表 URL、base64 编码的 Docker Compose 文件、主服务名称和目标端口。

   ./update-webapp.ps1 `
     -subscriptionId "<subscriptionId>" `
     -webAppName "<webAppName>" `
     -resourceGroup "<resourceGroup>" `
     -registryUrl "<registryUrl>" `
     -base64DockerCompose "<base64DockerCompose>" `
     -mainServiceName "<mainServiceName>" `
     -targetPort "<targetPort>"
   

   如果注册表需要身份验证，脚本会提示你以交互方式提供 dockerRegistryServerUsername 和 dockerRegistryServerPassword。

手动迁移

1. 登录到 Azure 并设置订阅。

   az login
   az account set --subscription <your-subscription-id>
   

2. 收集所需的详细信息。

   az account show --query id --output tsv
   az webapp list --query "[].{name:name}" --output tsv
   az group list --query "[].{name:name}" --output tsv
   az acr list --query "[].{name:name}" --output tsv
   

   它们将帮助你标识订阅 ID、应用名称、资源组和 Azure 容器注册表。

3. 创建部署槽位。 在将槽切换到生产环境之前，将验证迁移的挎斗。

   az webapp deployment slot create --name <webapp-name> --resource-group <resource-group> --slot <slot-name>
   

4. 从生产应用解码现有的 Docker Compose 配置。

   az webapp config show --name <webapp-name> --resource-group <resource-group> --query linuxFxVersion
   

   从输出复制 base64 部件，并在 PowerShell 中解码它：

   [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String("<base64value>"))
   

5. 对于 Compose 文件中的每个服务，请在 sitecontainers URL 路径下的部署槽中创建相应的 container 资源：

   az rest --method PUT \
     --url https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Web/sites/<webapp-name>/slots/<slot-name>/sitecontainers/<container-name>?api-version=2023-12-01 \
     --body '{"name":"<container-name>", "properties":{"image":"<image-name>", "isMain": <true/false>, "targetPort": <port>}}'
   

   • 使用 Docker Compose 属性和挎斗配置的映射来帮助完成映射。

   • 在 <container-name> 中使用您想要的容器名称。

   • 将主应用容器的 isMain 设置为 true，将挎斗的设置为 false。

   • 对于 <image-name>，请使用包含服务器名称的映像的完整路径。 例如：

     "image":"myregistry.azurecr.io/myapp/backend:latest"
     

   • 对所有容器重复此步骤。

6. 将部署槽切换为使用挎斗模式。

   az webapp config set --name <webapp-name> --resource-group <resource-group> --slot <slot-name> --linux-fx-version "sitecontainers"
   

7. 重启部署槽位，然后在部署槽中验证迁移的应用的功能。

   az webapp restart --name <webapp-name> --resource-group <resource-group> --slot <slot-name>
   

8. 验证后，将槽交换到生产环境：

   az webapp deployment slot swap --name <webapp-name> --resource-group <resource-group> --slot <slot-name> --target-slot production
   

Docker Compose 属性和挎斗配置的映射

以下 Docker Compose 字段对应于 sidecar 配置：

挎斗不支持以下 Docker Compose 字段：

迁移限制和注意事项

下表显示了 Docker Compose 应用中当前支持的功能，这些功能在挎斗中不受支持或支持有限。

更多资源

• Sidecar 概述
• 配置挎斗
• 适用于 Azure 应用服务的 Microsoft Q&A