Использование функции миграции на месте для миграции Среда службы приложений версии 1 и 2 в Среда службы приложений версии 3
Примечание.
Функция миграции, описанная в этой статье, используется для автоматической миграции Среда службы приложений версии 1 и 2 на Среда службы приложений версии 3. Если вы ищете информацию о параллельной миграции, см. статью "Миграция на Среда службы приложений версии 3" с помощью параллельной функции миграции. Если вы ищете сведения о вариантах миграции вручную, см . параметры миграции вручную. Сведения о том, какой вариант миграции подходит для вас, см . в дереве принятия решений по пути миграции. Дополнительные сведения о Среда службы приложений версии 3 см. в Среда службы приложений обзоре версии 3.
Вы можете автоматически перенести Среда службы приложений версии 1 и 2 в Среда службы приложений версии 3 с помощью функции миграции на месте. Дополнительные сведения о процессе миграции и о том, поддерживает ли Среда службы приложений миграцию в настоящее время, см. в обзоре функции миграции на месте.
Внимание
Мы рекомендуем использовать эту функцию для сред разработки перед переносом любых рабочих сред, чтобы избежать непредвиденных проблем. Укажите любые отзывы, связанные с этой статьей или функцией, с помощью кнопок в нижней части страницы.
Необходимые компоненты
Убедитесь, что миграция на Среда службы приложений версии 3 влияет на приложения. Просмотрите процесс миграции, чтобы понять процесс временная шкала и где и когда необходимо принять участие. Также ознакомьтесь с часто задаваемыми вопросами, которые могут ответить на некоторые вопросы.
Убедитесь, что в виртуальной сети, группе ресурсов, ресурсе или подписке нет блокировок. Блокирует операции платформы во время миграции.
Убедитесь, что политики Azure не блокируют действия, необходимые для миграции, включая изменения подсети и создание ресурсов службы приложение Azure. Политики, которые блокируют изменения и создания ресурсов, могут привести к сбою или сбою миграции.
Так как масштабирование блокируется во время миграции, перед началом миграции следует масштабировать среду до требуемого размера. Если вы хотите масштабировать среду после миграции, вы можете сделать это после завершения миграции.
Рекомендуется использовать портал Azure для интерфейса миграции на месте. Если вы решили использовать Azure CLI для миграции, выполните действия, описанные здесь, и как записано, так как вы выполняете вызовы REST API Azure. Рекомендуется использовать Azure CLI для выполнения этих вызовов API. Дополнительные сведения о других методах см . в справочнике по REST API Azure.
В этом руководстве установите Azure CLI или используйте Azure Cloud Shell и используйте оболочку Bash.
Примечание.
Мы рекомендуем использовать оболочку Bash для выполнения команд, приведенных в этом руководстве. Команды могут быть несовместимы с соглашениями PowerShell и escape-символами.
1. Получите идентификатор Среды службы приложений
Выполните следующие команды, чтобы получить идентификатор Среда службы приложений и сохранить его в качестве переменной среды. Замените заполнители для имен и групп ресурсов значениями для Среда службы приложений, которые требуется перенести. ASE_RGи VNET_RG совпадают, если виртуальная сеть и Среда службы приложений находятся в одной группе ресурсов.
ASE_NAME=<Your-App-Service-Environment-name>
ASE_RG=<Your-ASE-Resource-Group>
VNET_RG=<Your-VNet-Resource-Group>
ASE_ID=$(az appservice ase show --name $ASE_NAME --resource-group $ASE_RG --query id --output tsv)
2. Проверка поддержки миграции
Следующая команда проверка указывает, поддерживается ли Среда службы приложений для миграции. Если вы получаете сообщение об ошибке либо ваша Среда службы приложений находится в неработоспособном или приостановленном состоянии, вы не сможете выполнить миграцию в это время. Сведения о возможных сообщениях об ошибках, которые можно получить, см. в разделе "Устранение неполадок". Если среда не поддерживается для миграции с помощью функции миграции на месте или вы хотите выполнить миграцию в Среда службы приложений версии 3 без использования функции миграции на месте, см. параметры миграции вручную. Эта команда также проверяет, находится ли Среда службы приложений в поддерживаемой версии сборки для миграции. Если ваша Среда службы приложений не включена в поддерживаемую версию сборки, необходимо начать обновление самостоятельно, что может занять 8–12 часов или больше в зависимости от размера среды. Дополнительные сведения об обновлении предварительной миграции см. в статье Проверка поддержки миграции с помощью функции миграции на месте для Среда службы приложений.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=validation"
Если ошибок нет, это значит, что ваша миграция поддерживается и вы можете перейти к следующему шагу.
Если необходимо запустить обновление для обновления Среда службы приложений до поддерживаемой версии сборки, выполните следующую команду. Выполните эту команду только в случае сбоя шага проверки, и вы получите инструкции по обновлению Среда службы приложений.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=PreMigrationUpgrade"
3. Создание IP-адресов для нового ресурса Среда службы приложений версии 3
Выполните следующую команду, чтобы создать новые IP-адреса. Этот шаг занимает около 15 минут. Не масштабируйте и не вносите изменения в существующую Среду службы приложений в это время.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=premigration"
Выполните следующую команду, чтобы проверка состояние этого шага:
az rest --method get --uri "${ASE_ID}?api-version=2021-02-01" --query properties.status
Если шаг выполняется, вы получите состояние Migrating. После получения состояния Readyвыполните следующую команду, чтобы просмотреть новые IP-адреса. Если вы не видите новые IP-адреса сразу, подождите несколько минут и повторите попытку.
az rest --method get --uri "${ASE_ID}/configurations/networking?api-version=2021-02-01"
Примечание.
Из-за известной ошибки при миграции Среда службы приложений ELB входящий IP-адрес может измениться еще раз после завершения шага миграции. Будьте готовы обновить зависимые ресурсы снова с новым входящий IP-адрес после завершения шага миграции. Эта ошибка устранена и будет исправлена как можно скорее. Откройте случай поддержки, если у вас возникли вопросы или проблемы с этой проблемой или нужна помощь в процессе миграции.
4. Обновите зависимые ресурсы с помощью новых IP-адресов
Используя новые IP-адреса, обновите все ресурсы или сетевые компоненты, чтобы гарантировать, что новые функции среды будут выполнены после завершения миграции. Вы отвечаете за внесение всех необходимых обновлений.
Этот шаг также является хорошим временем для просмотра изменений зависимостей входящего и исходящего трафика сети при переходе на Среда службы приложений версии 3. Эти изменения включают изменение порта для Azure Load Balancer, которое теперь использует порт 80. Не выполняйте миграцию, пока не завершите этот шаг.
5. Делегируйте подсеть Среды службы приложений
Среда службы приложений версии 3 требует, чтобы подсеть, в которой она находится, имела одно делегирование Microsoft.Web/hostingEnvironments. Предыдущие версии не требовали этого делегирования. Перед миграцией необходимо убедиться, что подсеть делегирована делегирование делегирования делегирования (при необходимости). Вы можете обновить делегирование, выполнив следующую команду или перейдя в подсеть в портал Azure.
az network vnet subnet update --resource-group $VNET_RG --name <subnet-name> --vnet-name <vnet-name> --delegations Microsoft.Web/hostingEnvironments
6. Убедитесь, что блокировки в виртуальной сети отсутствуют.
Виртуальная сеть блокирует операции платформы во время миграции. Если у виртуальной сети есть блокировки, их необходимо удалить перед переносом. При необходимости можно добавить блокировки после завершения миграции.
Блокировки могут существовать в трех область: подписка, группа ресурсов и ресурс. При применении блокировки к родительской области все ресурсы в этой области наследуют ту же блокировку. Если у вас есть блокировки, примененные к подписке, группе ресурсов или область ресурсов, их необходимо удалить перед миграцией. Дополнительные сведения о блокировках и наследовании блокировок см. в разделе "Блокировка ресурсов для защиты инфраструктуры".
Используйте следующую команду, чтобы проверка, если у виртуальной сети есть блокировки:
az lock list --resource-group $VNET_RG --resource <vnet-name> --resource-type Microsoft.Network/virtualNetworks
Удалите все существующие блокировки с помощью следующей команды:
az lock delete --resource-group $VNET_RG --name <lock-name> --resource <vnet-name> --resource-type Microsoft.Network/virtualNetworks
Связанные команды для проверка, если у вашей подписки или группы ресурсов есть блокировки, см. справочник по Azure CLI для блокировок.
7. Подготовка конфигураций
Вы можете создать новую Среда службы приложений зона ресурсов версии 3, если существующая среда находится в регионе, поддерживающем избыточность зоны. Вы можете настроить избыточность зоны, задав zoneRedundant для свойства значение true.
Избыточность между зонами является необязательной конфигурацией. Его можно задать только во время создания нового ресурса Среда службы приложений версии 3. Вы не можете удалить его позже. Дополнительные сведения см. в разделе Выбор конфигурации Среды службы приложений версии 3. Если вы не хотите настраивать избыточность между зонами, не включайте параметр zoneRedundant.
Если существующий Среда службы приложений использует суффикс личного домена, необходимо настроить его для нового ресурса Среда службы приложений версии 3 во время процесса миграции. Миграция завершается ошибкой, если вы не настроите суффикс личного домена и используете его сейчас. Миграция также завершается ошибкой, если вы пытаетесь добавить суффикс личного домена во время миграции в среду, которая не настроена. Дополнительные сведения о Среда службы приложений суффиксов личного домена версии 3, включая требования, пошаговые инструкции и рекомендации, см. в статье суффикс личного домена для Среда службы приложений.
Примечание.
Если вы настраиваете суффикс личного домена, при добавлении разрешений сети в хранилище ключей Azure убедитесь, что хранилище ключей разрешает доступ с новых исходящих IP-адресов Среда службы приложений, созданных на шаге 3. Если вы обращаетесь к хранилищу ключей с помощью частной конечной точки, убедитесь, что вы правильно настроили частный доступ.
Если миграция не предусматривает использование суффикса личного домена и вы не включаете избыточность между зонами, можно перейти к миграции.
Чтобы задать эти конфигурации, создайте файл с именем parameters.json со следующими сведениями на основе вашего сценария. Не включайте свойства суффикса личного домена, если эта функция не применяется к миграции. Обратите внимание на значение zoneRedundant свойства, так как эта конфигурация необратима после миграции. Задайте значение свойства на основе существующей kind версии Среда службы приложений. Допустимые значения для kind свойства: ASEV1 и ASEV2.
Если вы выполняете миграцию без суффикса личного домена и включаете избыточность зоны, используйте следующий код:
{
"type": "Microsoft.Web/hostingEnvironments",
"name": "sample-ase-migration",
"kind": "ASEV2",
"location": "westcentralus",
"properties": {
"zoneRedundant": true
}
}
Если вы используете управляемое удостоверение, назначаемое пользователем для конфигурации суффикса личного домена, и вы включаете избыточность зоны, используйте следующий код:
{
"type": "Microsoft.Web/hostingEnvironments",
"name": "sample-ase-migration",
"kind": "ASEV2",
"location": "westcentralus",
"properties": {
"zoneRedundant": true,
"customDnsSuffixConfiguration": {
"dnsSuffix": "internal.contoso.com",
"certificateUrl": "https://contoso.vault.azure.net/secrets/myCertificate",
"keyVaultReferenceIdentity": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/asev3-migration/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ase-managed-identity"
}
}
}
Если для конфигурации суффикса личного домена используется управляемое удостоверение, назначаемое системой, и вы не включаете избыточность зоны, используйте следующий код:
{
"type": "Microsoft.Web/hostingEnvironments",
"name": "sample-ase-migration",
"kind": "ASEV2",
"location": "westcentralus",
"properties": {
"customDnsSuffixConfiguration": {
"dnsSuffix": "internal.contoso.com",
"certificateUrl": "https://contoso.vault.azure.net/secrets/myCertificate",
"keyVaultReferenceIdentity": "SystemAssigned"
}
}
}
8. Миграция на Среда службы приложений версии 3 и состояние проверка
Выполнив все описанные выше действия, вы можете начать миграцию. Убедитесь, что вы понимаете последствия миграции.
Этот шаг занимает три-шесть часов для миграций версии 2 до версии 3 и до шести часов для миграции версии 1 до версии 3 в зависимости от размера среды. В течение этого времени в течение одного часа простоя приложения. Масштабирование, развертывание и изменение существующих Среда службы приложений блокируются на этом шаге.
body Включите параметр в следующую команду, если вы включаете избыточность зоны и/или настраиваете суффикс личного домена. Если ни в чем из этих конфигураций не применяется к миграции, можно удалить параметр из команды.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=fullmigration" --body @parameters.json
Выполните следующие команды, чтобы проверка подробное состояние миграции. Сведения о состояниях см. в описаниях состояния миграции.
Первая команда получает идентификатор операции для миграции. Скопируйте значение ID свойства.
az rest --method get --uri "${ASE_ID}/operations?api-version=2022-03-01"
Замените заполнитель идентификатора операции в следующей команде значением, скопированным. Эта команда возвращает подробное состояние миграции. Эту команду можно выполнять как можно чаще, чтобы получить последнее состояние.
az rest --method get --uri "${ASE_ID}/operations/<operation-id>/details/default?api-version=2022-09-01"
После получения состояния миграции Readyвыполняется миграция и у вас есть ресурс Среда службы приложений версии 3. Теперь приложения работают в новой среде.
Получите сведения о новой среде, выполнив следующую команду или перейдя в портал Azure.
az appservice ase show --name $ASE_NAME --resource-group $ASE_RG
Примечание.
Из-за известной ошибки для миграции Среда службы приложений ELB входящий IP-адрес может измениться после завершения этапа миграции. Проверьте IP-адреса Среда службы приложений версии 3 и внесите необходимые обновления, если с момента создания IP-адресов были изменены. Откройте случай поддержки, если у вас возникли вопросы или проблемы с этой проблемой или нужна помощь с подтверждением новых IP-адресов.
1. Проверка поддержки миграции
В портал Azure перейдите на страницу миграции для Среда службы приложений, которую вы переносите. Вы можете добраться до страницы миграции, выбрав баннер в верхней части страницы обзора для Среда службы приложений или выбрав элемент миграции в меню слева.
На странице миграции платформа проверяет, поддерживается ли миграция для Среда службы приложений. Выберите " Проверить", а затем подтвердите, что вы хотите продолжить проверку. Процесс проверки занимает несколько секунд.
Если среда не поддерживается для миграции, баннер появится в верхней части страницы и содержит сообщение об ошибке с причиной. Описание сообщений об ошибках, которые могут отображаться, если вы не имеете права на миграцию, см. в разделе "Устранение неполадок".
Если в настоящее время Среда службы приложений не поддерживается для миграции, или ваша среда находится в неработоспособном или приостановленном состоянии, вы не можете использовать функцию миграции. Если среда не поддерживается для миграции с помощью функции миграции на месте или вы хотите перейти на Среда службы приложений версии 3 без использования функции миграции на месте, см. параметры миграции вручную.
Если вам нужно запустить обновление, чтобы обновить Среда службы приложений до поддерживаемой версии сборки, вам будет предложено запустить обновление, которое может занять 8–12 часов или больше в зависимости от размера среды. Выберите "Обновить", чтобы начать обновление. По завершении обновления вы проходите проверку и можете использовать функцию миграции для запуска миграции.
Если миграция поддерживается для Среда службы приложений, перейдите к следующему шагу процесса. На странице "Миграция" вы узнаете, как выполнить миграцию.
2. Создание IP-адресов для нового ресурса Среда службы приложений версии 3
В разделе "Получение новых IP-адресов" убедитесь, что вы понимаете последствия и нажмите кнопку "Пуск ". Этот шаг занимает около 15 минут. Вы не можете масштабировать или вносить изменения в существующие Среда службы приложений в это время.
3. Обновите зависимые ресурсы с помощью новых IP-адресов
По завершении предыдущего шага отображаются IP-адреса для нового ресурса Среда службы приложений версии 3. Используйте новые IP-адреса для обновления всех ресурсов и сетевых компонентов, чтобы новые функции среды выполнялись после завершения миграции. Вы отвечаете за внесение всех необходимых обновлений.
Этот шаг также является хорошим временем для просмотра изменений входящего и исходящего сетевого зависимостей при переходе на Среда службы приложений версии 3. Эти изменения включают изменение порта для Azure Load Balancer, которое теперь использует порт 80. Не переходите к следующему шагу, пока не подтвердите, что вы сделали эти обновления.
4. Делегируйте подсеть Среды службы приложений
Среда службы приложений версии 3 требует, чтобы подсеть была вложена в одну делегированиеMicrosoft.Web/hostingEnvironments. Предыдущие версии не требовали этого делегирования. Перед миграцией необходимо убедиться, что подсеть делегирована делегирование делегирования делегирования (при необходимости). На портале отображается ссылка на подсеть, чтобы можно было подтвердить и обновить по мере необходимости.
5. Подтверждение изменений размера экземпляра
Планы Служба приложений преобразуются из изоляции на соответствующий уровень "Изолированная версия 2". Например, I2 преобразуется в I2v2. После миграции приложения могут быть перегружены, так как уровень изолированной версии 2 имеет больше памяти и ЦП на соответствующий размер экземпляра. Вы можете масштабировать среду по мере необходимости после завершения миграции. Дополнительные сведения см. в сведениях о ценах.
6. Убедитесь, что виртуальная сеть не имеет блокировок
Виртуальная сеть блокирует операции платформы во время миграции. Если у виртуальной сети есть блокировки, их необходимо удалить перед переносом. При необходимости можно добавить блокировки после завершения миграции.
Блокировки могут существовать в трех область: подписка, группа ресурсов и ресурс. При применении блокировки к родительской области все ресурсы в этой области наследуют ту же блокировку. Если у вас есть блокировки, примененные к подписке, группе ресурсов или область ресурсов, их необходимо удалить перед миграцией. Дополнительные сведения о блокировках и наследовании блокировок см. в разделе "Блокировка ресурсов для защиты инфраструктуры".
Дополнительные сведения о том, как проверка, если у вашей подписки или группы ресурсов есть блокировки, см. в разделе "Настройка блокировок".
7. Выбор конфигураций
Вы можете создать новую Среда службы приложений зона ресурсов версии 3, если существующая среда находится в регионе, поддерживающем избыточность зоны. Избыточность между зонами является необязательной конфигурацией. Его можно задать только во время создания нового ресурса Среда службы приложений версии 3. Вы не можете удалить его позже. Дополнительные сведения см. в разделе Выбор конфигурации Среды службы приложений версии 3.
Выберите поле "Включенная проверка", если вы хотите настроить избыточность зоны.
Если ваша среда находится в регионе, который не поддерживает избыточность зоны, проверка box недоступна. Если вам нужен ресурс, избыточный между зонами Среда службы приложений версии 3, используйте один из вариантов миграции вручную и создайте ресурс в одном из регионов, поддерживающих избыточность зоны.
Если существующий Среда службы приложений использует суффикс личного домена, необходимо настроить его для нового ресурса Среда службы приложений версии 3. Параметры конфигурации для суффикса личного домена отображаются, если эта ситуация относится к вам. Вы не сможете перенести, пока не предоставьте необходимые сведения.
Если вы хотите использовать суффикс личного домена, но в настоящее время не настроено, можно настроить один после завершения миграции. Дополнительные сведения о Среда службы приложений суффиксов личного домена версии 3, включая требования, пошаговые инструкции и рекомендации, см. в статье суффикс личного домена для Среда службы приложений.
Примечание.
Если вы настраиваете суффикс личного домена, при добавлении разрешений сети в хранилище ключей Azure убедитесь, что хранилище ключей разрешает доступ из новых исходящих IP-адресов Среда службы приложений, созданных на шаге 2. Если вы обращаетесь к хранилищу ключей с помощью частной конечной точки, убедитесь, что вы правильно настроили частный доступ.
После добавления сведений о суффиксе личного домена кнопка "Миграция " доступна.
8. Переход на Среда службы приложений версии 3
Выполнив все описанные выше действия, вы можете начать миграцию. Убедитесь, что вы понимаете последствия миграции, включая то, что происходит в течение этого времени.
Этот шаг занимает три-шесть часов для миграций версии 2 до версии 3 и до шести часов для миграции версии 1 до версии 3 в зависимости от размера среды. Масштабирование и изменение существующих Среда службы приложений блокируются на этом шаге.
Примечание.
В редких случаях на портале может появиться уведомление о том, что "Миграция на Среда службы приложений версии 3 завершилась сбоем" после запуска миграции. Существует известная ошибка, которая может активировать это уведомление, даже если миграция выполняется. Проверьте журнал действий для Среда службы приложений, чтобы определить допустимость этого сообщения об ошибке. В большинстве случаев обновление страницы устраняет проблему, и сообщение об ошибке исчезает. Если сообщение об ошибке сохраняется, обратитесь в службу поддержки.
В настоящее время подробные состояния миграции доступны только при использовании Azure CLI. Дополнительные сведения см. в разделе Azure CLI для миграции на Среда службы приложений версии 3. Вы можете проверка состояние миграции с помощью интерфейса командной строки, даже если вы используете портал для миграции.
После завершения миграции у вас есть ресурс Среда службы приложений версии 3, а все приложения работают в новой среде. Версию окружения можно подтвердить, проверив страницу Конфигурация для вашей Среды службы приложений.
Примечание.
Из-за известной ошибки при миграции Среда службы приложений ELB входящий IP-адрес может измениться после завершения шага миграции. Проверьте IP-адреса Среда службы приложений версии 3 и внесите необходимые обновления, если с момента создания IP-адресов были изменены. Откройте случай поддержки, если у вас возникли вопросы или проблемы с этой проблемой или нужна помощь с подтверждением новых IP-адресов.
Если миграция включает суффикс личного домена, домен появился в разделе "Основные сведения" портала для Среда службы приложений версии 1/2, но он больше не отображается в Среда службы приложений версии 3. Вместо этого для Среда службы приложений версии 3 перейдите на страницу суффикса личного домена, чтобы убедиться, что суффикс личного домена настроен правильно. Вы также можете удалить конфигурацию, если она больше не нужна, или настроить ее, если у вас ее не было ранее.
Примечание.
Если миграция включает суффикс личного домена, конфигурация суффикса личного домена может показаться пониженной после завершения миграции из-за известной ошибки. Ваш Среда службы приложений по-прежнему должен функционировать должным образом. Состояние пониженного состояния должно разрешаться в течение 6–8 часов. Если конфигурация ухудшается через 8 часов или если суффикс личного домена не работает, обратитесь в службу поддержки.
