Перенос приложений Docker Compose на сайдкары в Службе приложений Azure

Если вы запускаете приложение Docker Compose в Службе приложений Azure, его следует перенести на боковики. Существует две основные стратегии миграции приложения Docker Compose в сайдкары.

• Миграция на основе скриптов — рекомендуется для простых настроек.
• Ручная миграция

Предпосылки

• PowerShell
• Azure CLI (Интерфейс командной строки для Azure)
• Docker (для создания и отправки изображений)

Миграция с помощью скрипта

Если файл Docker Compose прост, можно использовать официальный скрипт миграции для автоматизации процесса.

1. Скачайте скрипт миграции из репозитория GitHub примеров Azure.

2. Запустите скрипт в PowerShell, указав идентификатор подписки, имя веб-приложения, группу ресурсов, URL-адрес реестра, файл Docker Compose в кодировке Base64, имя основной службы и целевой порт.

   ./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
   

   Это поможет вам определить идентификатор подписки, имя приложения, группу ресурсов и реестр контейнеров 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 создайте соответствующий container ресурс в слоте развертывания по sitecontainers URL-адресу:

   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 для основного контейнера приложения и false для сайдкаров.

   • Для <image-name> используйте полный путь к изображению, содержащий имя сервера. Рассмотрим пример.

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

   • Повторите для всех контейнеров.

6. Переключите слот развертывания, чтобы использовать режим sidecar.

   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 сопоставляются с конфигурацией сайдкара.

Следующие поля Docker Compose не поддерживаются в сайдкарах:

Ограничения и рекомендации по миграции

В следующей таблице показаны функции, которые в настоящее время поддерживаются в приложениях Docker Compose, но не поддерживаются или имеют ограниченную поддержку в контейнерах sidecar.

Дополнительные ресурсы

• Обзор сайдкара
• Настройка сайдкаров
• Microsoft Q&A для службы приложений Azure