Миграция в Среда службы приложений версии 3 с помощью функции миграции на месте

Примечание.

Функция миграции, описанная в этой статье, используется для автоматической миграции Среда службы приложений версии 1 и 2 на Среда службы приложений версии 3. Если вы не запросили 30-дневный льготный период, просмотрите обзор льготного периода, а затем запросите льготный период, перейдя к портал Azure и перейдя в колонку миграции для каждого из ваших Среда службы приложений.

Если вы ищете информацию о параллельной миграции, см. статью "Миграция на Среда службы приложений версии 3" с помощью параллельной функции миграции. Если вы ищете сведения о вариантах миграции вручную, см . параметры миграции вручную. Сведения о том, какой вариант миграции подходит для вас, см . в дереве принятия решений по пути миграции. Дополнительные сведения о Среда службы приложений версии 3 см. в Среда службы приложений обзоре версии 3.

Служба приложений может автоматизировать миграцию Среда службы приложений версии 1 и 2 на Среда службы приложений версии 3. Существуют различные варианты миграции. Просмотрите дерево принятия решений по пути миграции, чтобы решить, какой вариант лучше всего подходит для вашего варианта использования. Среда службы приложений версии 3 предоставляет преимущества и отличиями в функциях по сравнению с более ранними версиями. Обязательно ознакомьтесь с поддерживаемыми функциями Среды службы приложений версии 3 перед миграцией, чтобы снизить риск непредвиденных проблем в работе приложения.

Функция миграции на месте автоматизирует миграцию на Среда службы приложений версии 3, обновив существующие Среда службы приложений в той же подсети. Этот вариант миграции лучше всего подходит для клиентов, которые хотят перенести Среда службы приложений версии 3 с минимальными изменениями в конфигурации сети. Кроме того, вы должны иметь возможность поддерживать около одного часа простоя приложения. Если вы не можете поддерживать простой, см. функцию миграции на стороне или параметры миграции вручную.

Внимание

Рекомендуется использовать эту функцию для сред разработки перед переносом каких-либо производственных сред, чтобы избежать непредвиденных проблем. Вы можете оставить отзыв, связанный с этой статьей или функцией, с помощью кнопок внизу страницы.

Поддерживаемые сценарии

В настоящее время функция миграции на месте не поддерживает миграцию в Среда службы приложений версии 3 в следующих регионах:

Microsoft Azure под управлением 21Vianet

• Восточный Китай 2
• Северный Китай 2

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

Настройка	Конфигурация Среды службы приложений версии 3
Среда службы приложений версии 2 с внутренней подсистемой балансировки нагрузки (ILB)	Среда службы приложений версии 3 с ILB
Внешняя (с подключением к внешней подсистеме балансировки нагрузки или Интернету с использованием общедоступного IP-адреса) Среда службы приложений версии 2	Среда службы приложений версии 3 с ELB
Среда службы приложений версии 2 с внутренней подсистемой балансировки нагрузки с суффиксом личного домена	Среда службы приложений версии 3 с ILB с суффиксом личного домена
Среда службы приложений версии 1 с ILB	Среда службы приложений версии 3 с ILB
Среда службы приложений версии 1 с ELB	Среда службы приложений версии 3 с ELB
Среда службы приложений версии 1 с внутренней подсистемой балансировки нагрузки с суффиксом личного домена	Среда службы приложений версии 3 с ILB с суффиксом личного домена
Среда службы приложений версии 2 с закреплением по зоне	Среда службы приложений версии 3 с необязательной конфигурацией избыточности зоны

Если вы хотите, чтобы новая Среда службы приложений версии 3 использовала суффикс личного домена, и в настоящее время он не используется, суффикс личного домена можно настроить в любое время после завершения миграции. Дополнительные сведения см. в статье Настройка суффикса личного домена для Среды службы приложений.

Чтобы узнать версию своей Среды службы приложений, перейдите к Среде службы приложений на портале Azure и выберите Конфигурация в разделе Параметры в области слева. Можно также использовать Обозреватель ресурсов Azure, чтобы проверить значение свойства kind для Среды службы приложений.

Ограничения функции миграции на месте

Ниже приведены ограничения при использовании функции миграции на месте:

• Новая Среда службы приложений версии 3 находится в существующей подсети, которая использовалась для прежней версии среды.
• Вы не можете изменить регион, в котором располагается Среда службы приложений.
• ElB Среда службы приложений нельзя перенести в ILB Среда службы приложений версии 3 и наоборот.
• Если существующая Среда службы приложений использует суффикс личного домена, необходимо настроить суффикс личного домена для Среды службы приложений версии 3 в процессе миграции.
  • Если вы больше не хотите использовать суффикс личного домена, его можно удалить после завершения миграции.

Среда службы приложений версии 3 не поддерживает следующие функции, которые можно использовать с текущим Среда службы приложений версии 1 или 2.

• Настройка привязки TLS/SSL на основе IP с помощью приложений.
• Среда службы приложений версии 3 не переключается на Azure DNS, если DNS-серверы, которые вы настроили в своей виртуальной сети, не могут разрешить заданное имя. Если это необходимо, убедитесь, что у вас есть инструмент переадресации на общедоступный DNS или включите Azure DNS в список своих DNS-серверов.

Функция миграции на месте не поддерживает следующие сценарии. Если ваша Среда службы приложений попадает в одну из этих категорий, см. статью Варианты миграции вручную.

• Среда службы приложений версии 1 в a Классическая виртуальная сеть
• Среда службы приложений версии 2 с ELB и SSL на основе IP
• Среда службы приложений версии 1 с ELB и SSL на основе IP
• Среда службы приложений с именем, которое не соответствует ограничениям символов. Все имя, включая суффикс домена, должно быть 64 символами или меньше. Например, my-ase-name.appserviceenvironment.net для ILB и my-ase-name.p.azurewebsites.net для ELB должны иметь 64 символов или меньше. Если вы не соответствуете ограничению символов, необходимо выполнить миграцию вручную. Ограничения символов специально для имени Среда службы приложений приведены следующим образом:
  • Ограничение Среда службы приложений имени подсистемы балансировки нагрузки: 36 символов
  • Ограничение Среда службы приложений имени ELB: 42 символа

Платформа Служба приложений проверяет Среда службы приложений для подтверждения поддержки миграции на месте. Если сценарий не проходит все проверки проверки, вы не сможете выполнить миграцию в настоящее время с помощью функции миграции на месте. Если ваша среда находится в неработоспособном или приостановленном состоянии, вы не сможете перенести, пока не сделаете необходимые обновления.

Примечание.

Среда службы приложений версии 3 не поддерживает ПРОТОКОЛ SSL IP. Если вы используете ПРОТОКОЛ SSL, необходимо удалить все привязки SSL ДЛЯ IP-адресов перед переносом на Среда службы приложений версии 3. Функция миграции будет поддерживать среду после удаления всех привязок SSL IP.

Устранение неполадок

Если Среда службы приложений не проходят проверки или вы пытаетесь выполнить шаг миграции в неправильном порядке, вы увидите одно из следующих сообщений об ошибках:

Сообщение об ошибке	Description	Рекомендация
Migrate can only be called on an ASE in ARM VNET and this ASE is in Classic VNET. (Миграцию можно вызвать только в среде ASE в виртуальной сети ARM, а эта среда ASE находится в классической виртуальной сети.)	Среда службы приложений в классических виртуальных сетям не удается перенести с помощью функции миграции на месте.	Миграция с использованием одного из вариантов миграции вручную.
ASEv3 Migration is not yet ready. (Миграция для ASE версии 3 еще не готова.)	Базовая инфраструктура не готова к поддержке Среды службы приложений версии 3.	Выполните миграцию с использованием одного из вариантов миграции вручную, если хотите провести ее немедленно. В противном случае дождитесь доступности функции миграции на месте в вашем регионе.
Migration cannot be called on this ASE, please contact support for help migrating. (Невозможно вызвать миграцию для этой среды ASE. Для получения помощи по миграции обратитесь в службу поддержки.)	Для миграции этой Среда службы приложений необходимо включить поддержку. Эта проблема может возникнуть из-за пользовательских параметров, используемых этой средой.	Откройте вариант поддержки, чтобы привлечь поддержку для устранения проблемы.
Миграцию нельзя вызвать, если на любом из сайтов включен режим SSL на основе IP.	Среда службы приложений, на которых есть сайты с включенным ПРОТОКОЛом SSL IP, нельзя перенести с помощью функции миграции.	Удалите SSL IP-адрес из всех приложений в Среда службы приложений, чтобы включить функцию миграции.
Полную миграцию нельзя вызывать перед созданием IP-адресов.	Эта ошибка возникает при попытке выполнить миграцию перед завершением шагов предварительной подготовки.	Перед попыткой миграции выполните все действия по предварительной подготовке. Ознакомьтесь с пошаговым руководством по миграции.
Миграция в ASE версии 3 запрещена для этой среды ASE.	Невозможно выполнить миграцию с помощью функции миграции.	Миграция с использованием одного из вариантов миграции вручную.
Subscription has too many App Service Environments. Please remove some before trying to create more. (В подписке слишком много сред службы приложений. Удалите некоторые из них, прежде чем создавать дополнительные среды.)	Выполняется Среда службы приложений квота для подписки.	Удалите ненужные среды или обратитесь в службу поддержки, чтобы узнать о доступных вариантах.
<ZoneRedundant><DedicatedHosts><ASEv3/ASE> недоступно в этом расположении.	Эта ошибка возникает, если вы пытаетесь перенести Среда службы приложений в регионе, который не поддерживает одну из запрошенных функций.	Выполните миграцию с использованием одного из вариантов миграции вручную, если хотите провести ее немедленно. В противном случае дождитесь поддержки этой конфигурации Среды службы приложений.
Миграция не может вызываться для этой ASE до завершения активного обновления.	Среды службы приложений нельзя перенести во время обновления платформы. Вы можете задать параметры обновления на портале Azure. Обновление занимает 8–12 часов или больше в зависимости от размера (количество экземпляров или ядер) Среда службы приложений.	Дождитесь завершения обновления и миграции.
Выполняется операция управления для Среды службы приложений.	Со Средой службы приложений выполняется операция управления. Эти операции могут включать в себя такие действия, как развертывания или обновления. Миграция блокируется до завершения этих операций.	После завершения этих операций можно выполнить миграцию.
Миграция недоступна для этой подписки.	Для миграции этой Среда службы приложений необходимо включить поддержку.	Откройте вариант поддержки, чтобы привлечь поддержку для устранения проблемы.
В настоящее время interalLoadBalancingMode не поддерживается.	Среда службы приложений, для которых задано значение InternalLoadBalancingMode, не может быть перенесено с помощью функции миграции в настоящее время. InternalLoadBalancingMode необходимо вручную изменить командой Майкрософт.	Откройте вариант поддержки, чтобы привлечь поддержку для устранения проблемы. Запросите обновление в InternalLoadBalancingMode, чтобы разрешить миграцию.

Обзор процесса миграции с помощью функции миграции на месте

Миграция на месте состоит из ряда шагов, которые должны выполняться в порядке. Для различных этапов задаются ключевые моменты. Важно понимать, что происходит во время этих действий и как они влияют на вашу среду и приложения. После проверки следующей информации, если вы готовы к миграции, выполните инструкции в пошаговом руководстве.

Убедитесь, что миграция поддерживается с помощью функции миграции на месте для Среда службы приложений

Платформа проверяет, что Среда службы приложений можно перенести с помощью функции миграции на месте. Если Среда службы приложений не проходит все проверки проверки, вы не сможете перенести на данный момент с помощью функции миграции на месте. Дополнительные сведения о возможных причинах сбоя проверки см. в разделе об устранении неполадок . Если ваша среда находится в неработоспособном или приостановленном состоянии, вы не сможете перенести, пока не сделаете необходимые обновления. Если вы не можете перенести с помощью функции миграции на месте, см . параметры миграции вручную.

Проверка также проверяет, находится ли Среда службы приложений в минимальной сборке, необходимой для миграции. Эта сборка может быть более новой, чем стандартная сборка, развернутая с помощью стандартного цикла обновления и обслуживания платформы. Минимальная сборка периодически обновляется, чтобы обеспечить доступность последних исправлений ошибок и улучшений. Если Среда службы приложений не в минимальной сборке, необходимо начать обновление самостоятельно. Это стандартный процесс, когда Среда службы приложений не влияет, но вы не можете масштабировать или вносить изменения в Среда службы приложений во время выполнения обновления. Вы не можете выполнить миграцию до завершения обновления. Обновление может занять 8–12 часов в зависимости от размера среды. Если вы планируете определенный период времени миграции, необходимо выполнить проверку 24–48 часов до запланированного времени миграции, чтобы убедиться, что при необходимости потребуется время обновления.

Создание IP-адресов для новой Среды службы приложений версии 3

Платформа создает новый входящий IP-адрес (если вы переносите Среда службы приложений ELB) и новые исходящие IP-адреса. Пока создаются эти IP-адреса, действия, выполняемые для существующей Среды службы приложений, не будут прерываться, однако вы не сможете выполнять масштабирование или вносить изменения в существующую среду. Эта процедура занимает около 15 минут.

По завершении вам будут предоставлены новые IP-адреса, которые будут использоваться в будущей Среде службы приложений версии 3. Эти новые IP-адреса не влияют на существующую среду. IP-адреса, используемые существующей средой, по-прежнему будут использоваться до тех пор, пока не завершится работа существующей среды на этапе миграции.

Обновление зависимых ресурсов с помощью новых IP-адресов

После создания новых IP-адресов у вас есть новый исходящий трафик по умолчанию к общедоступным адресам Интернета. При подготовке к миграции можно настроить любые внешние брандмауэры, маршрутизацию DNS, группы безопасности сети и любые другие ресурсы, использующие эти IP-адреса. Для elB Среда службы приложений у вас также есть новый входящий IP-адрес, который можно использовать для настройки новых конечных точек со службами, такими как Диспетчер трафика или Azure Front Door. Необходимо обновить все ресурсы, которые будут затронуты изменением IP-адреса, связанным с новой Средой службы приложений версии 3. Не переходите к следующему шагу, пока не будут выполнены все необходимые обновления. Этот шаг также является хорошим временем для просмотра изменений входящего и исходящего сетевого зависимостей при переходе на Среда службы приложений версии 3, включая изменение порта для пробы работоспособности Azure Load Balancer, которая теперь использует порт 80.

Делегирование подсети Среды службы приложений

Среда службы приложений версии 3 требует, чтобы подсеть, в которой она находится, имела одно делегирование Microsoft.Web/hostingEnvironments. Миграция не может завершиться успешно, если подсеть Среда службы приложений не делегирована или вы делегируют ее другому ресурсу.

Подтверждение изменения размера экземпляра

Планы Служба приложений преобразуются из "Изолированный" на соответствующий уровень "Изолированная версия 2" в рамках миграции. Например, I2 преобразуется в I2v2. Ваши приложения могут быть чрезмерно подготовлены после миграции, так как уровень "Изолированная версия 2" имеет больше памяти и ЦП на соответствующий размер экземпляра. Вы можете масштабировать среду по мере необходимости после завершения миграции. Дополнительные сведения см. в разделе Сведения о номере SKU.

Убедитесь, что на ваших ресурсах нет блокировок

Виртуальная сеть блокирует операции платформы во время миграции. Если у виртуальной сети есть блокировки, их необходимо удалить перед переносом. При необходимости блокировки можно считывать после завершения миграции. Блокировки могут существовать в трех различных областях: подписка, группа ресурсов и ресурс. При применении блокировки к родительской области все ресурсы в этой области наследуют ту же блокировку. Если у вас есть блокировки, примененные к подписке, группе ресурсов или области ресурсов, их необходимо удалить перед миграцией. Дополнительные сведения о блокировках и наследовании блокировок см. в разделе "Блокировка ресурсов для защиты инфраструктуры".

Убедитесь, что политики Azure не блокируют миграцию

Политика Azure можно использовать для запрета создания ресурсов и изменения определенных субъектов. Если у вас есть политика, которая блокирует создание Среда службы приложений или изменение подсетей, необходимо удалить ее перед переносом. Политику можно считывать при необходимости после завершения миграции. Дополнительные сведения о Политика Azure см. в Политика Azure обзоре.

Выбор конфигурации Среды службы приложений версии 3

Среду службы приложений версии 3 можно развернуть в зонах доступности в регионах, поддерживающих ее. Эта архитектура называется избыточностью между зонами. Избыточность между зонами можно настроить только во время создания Среды службы приложений. Если вы хотите, чтобы новая Среда службы приложений версии 3 была избыточной между зонами, включите конфигурацию в процессе миграции. Любые Среда службы приложений, использующие функцию миграции на месте, можно настроить как избыточность между зонами, если вы используете регион, поддерживающий избыточность зон для Среда службы приложений версии 3. Если у вас есть среда в регионе, который не поддерживает избыточность зоны, параметр конфигурации отключен и его нельзя настроить. Функция миграции на месте не поддерживает изменение регионов. Если вы хотите использовать другой регион, воспользуйтесь одним из вариантов миграции вручную.

Примечание.

Включение избыточности между зонами может привести к дополнительным расходам. Дополнительные сведения см. в разделе о модели ценообразования для избыточности между зонами.

Если существующий Среда службы приложений использует суффикс личного домена, вам будет предложено настроить суффикс личного домена для нового Среда службы приложений версии 3. Необходимо указать имя личного домена, управляемое удостоверение и сертификат. Дополнительные сведения о суффиксе личного домена для Среды службы приложений версии 3, включая требования, пошаговые инструкции и рекомендации, см. в статье Настройка суффикса личного домена для Среды службы приложений. Для новой среды необходимо настроить суффикс личного домена, даже если вы больше не хотите использовать его. После завершения миграции при необходимости можно удалить конфигурацию суффикса личного домена.

Если миграция включает суффикс личного домена, для Среда службы приложений версии 3 личный домен не отображается в разделе "Основные сведения" на странице обзора портала, так как это для Среда службы приложений версии 1/2. Вместо этого для Среды службы приложений версии 3 перейдите на страницу Суффикс личного домена, на которой можно проверить правильность настройки суффикса личного домена. Кроме того, в Среда службы приложений версии 2, если у вас есть суффикс личного домена, имя узла по умолчанию включает суффикс личного домена и находится в форме APP-NAME.internal.contoso.com. В Среда службы приложений версии 3 имя узла по умолчанию всегда использует суффикс домена по умолчанию и находится в форме APP-NAME.ASE-NAME.appserviceenvironment.net. Это различие связано с тем, что Среда службы приложений версии 3 сохраняет суффикс домена по умолчанию при добавлении суффикса личного домена. В Среда службы приложений версии 2 существует только один суффикс домена.

Миграция в Среду службы приложений версии 3

После выполнения предыдущих шагов следует как можно скорее продолжить миграцию.

Внимание

Так как масштабирование блокируется во время миграции, перед началом миграции следует масштабировать среду до требуемого размера. Если вы включили автоматическое масштабирование, если событие масштабирования происходит до начала миграции, необходимо ждать завершения события масштабирования перед началом миграции. Перед началом миграции необходимо отключить автоматическое масштабирование, чтобы избежать этой проблемы. Если вы хотите масштабировать среду после миграции, вы можете сделать это после завершения миграции.

Миграция требует трех-шестичасового периода обслуживания для миграции Среда службы приложений версии 2 до версии 3. В зависимости от размера среды для миграций с версии 1 на версию 3 требуется окно обслуживания продолжительностью до шести часов. Окно службы может быть расширено в редких случаях, когда требуется вмешательство команды службы вручную. Во время миграции конфигурации масштабирования и среды блокируются и происходят следующие события:

• Существующая Среда службы приложений завершает работу и заменяется новой Средой службы приложений версии 3.
• Все планы Служба приложений в Среда службы приложений преобразуются с уровня "Изолированный" в изолированный версии 2.
• Все приложения, которые находятся в Среде службы приложений, временно не работают. Следует ожидать простой продолжительностью примерно один час.
  • Если вы не можете поддерживать простой, ознакомьтесь с функцией параллельной миграции или альтернативой миграции.
• Общедоступные адреса, используемые Средой службы приложений, заменяются на IP-адреса, созданные на соответствующем шаге.

В процессе миграции доступны следующие состояния:

Состояние	Description
Проверка и подготовка миграции.	Платформа проверяет поддержку миграции и выполняет необходимые проверки.
Развертывание инфраструктуры Среда службы приложений версии 3.	Подготовка новой инфраструктуры Среда службы приложений версии 3.
Ожидание завершения инфраструктуры.	Платформа проверяет новую инфраструктуру и выполняет необходимые проверки.
Настройка сети. Период простоя миграции начался. Приложения недоступны.	Платформа удаляет старую инфраструктуру и перемещает все приложения в новую Среда службы приложений версии 3. Ваши приложения отключены и не принимают трафик.
Выполнение проверок после миграции.	Платформа выполняет необходимые проверки, чтобы обеспечить успешность миграции.
Завершение миграции.	Платформа завершает миграцию.

Как и на этапе создания IP-адресов, вы не можете масштабировать или изменять Среду службы приложений или развертывать в ней приложения во время этого процесса. По завершении миграции приложения, которые находились в прежней Среде службы приложений, запускаются в новой Среде службы приложений версии 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. Проверка поддержки миграции

Следующая команда проверяет, поддерживается ли Среда службы приложений для миграции и проверяет, находится ли Среда службы приложений в поддерживаемой версии сборки для миграции.

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"

4. Обновите зависимые ресурсы с помощью новых IP-адресов

Используя новые IP-адреса, обновите все ресурсы или сетевые компоненты, чтобы гарантировать, что новые функции среды будут выполнены после завершения миграции. Вы отвечаете за внесение всех необходимых обновлений.

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, включая требования, пошаговые инструкции и рекомендации, см. в статье суффикс личного домена для Среда службы приложений.

Примечание.

Если вы настраиваете суффикс личного домена, при добавлении разрешений сети в хранилище ключей 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/00000000-0000-0000-0000-000000000000/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

1. Проверка поддержки миграции

В портал Azure перейдите на страницу миграции для Среда службы приложений, которую вы переносите. Вы можете добраться до страницы миграции, выбрав баннер в верхней части страницы обзора для Среда службы приложений или выбрав элемент миграции в меню слева.

Выберите параметр миграции "На месте", чтобы запустить процесс миграции на месте. Если выбрать вариант параллельной миграции, вы перейдете в документацию для этого процесса миграции. Не выбирайте вариант параллельной миграции, если вы хотите использовать функцию миграции на месте.

На странице миграции платформа проверяет, поддерживается ли миграция для Среда службы приложений. Выберите " Проверить", а затем подтвердите, что вы хотите продолжить проверку. Процесс проверки занимает несколько секунд.

Если среда не поддерживается для миграции, баннер появится в верхней части страницы и содержит сообщение об ошибке с причиной. Описание сообщений об ошибках, которые могут отображаться, если вы не имеете права на миграцию, см. в разделе "Устранение неполадок".

Если вам нужно запустить обновление, чтобы обновить Среда службы приложений до поддерживаемой версии сборки, вам будет предложено запустить обновление, которое может занять 8–12 часов или больше в зависимости от размера среды. Выберите "Обновить", чтобы начать обновление. По завершении обновления вы проходите проверку и можете использовать функцию миграции для запуска миграции.

Если миграция поддерживается для Среда службы приложений, перейдите к следующему шагу процесса. На странице "Миграция" вы узнаете, как выполнить миграцию.

2. Создание IP-адресов для нового ресурса Среда службы приложений версии 3

В разделе "Получение новых IP-адресов" убедитесь, что вы понимаете последствия и нажмите кнопку "Пуск ". Этот шаг занимает около 15 минут. Вы не можете масштабировать или вносить изменения в существующие Среда службы приложений в это время.

3. Обновите зависимые ресурсы с помощью новых IP-адресов

По завершении предыдущего шага отображаются IP-адреса для нового ресурса Среда службы приложений версии 3. Используйте новые IP-адреса для обновления всех ресурсов и сетевых компонентов, чтобы новые функции среды выполнялись после завершения миграции. Вы отвечаете за внесение всех необходимых обновлений.

4. Делегируйте подсеть Среды службы приложений

Среда службы приложений версии 3 требует, чтобы подсеть была вложена в одну делегированиеMicrosoft.Web/hostingEnvironments. Предыдущие версии не требовали этого делегирования. Перед миграцией необходимо убедиться, что подсеть делегирована делегирование делегирования делегирования (при необходимости). На портале отображается ссылка на подсеть, чтобы можно было подтвердить и обновить по мере необходимости.

5. Подтверждение изменений размера экземпляра

Нажмите кнопку "Подтвердить", чтобы убедиться, что планы Служба приложений преобразуются из изолированного уровня в соответствующий уровень "Изолированная версия 2" в рамках миграции.

6. Убедитесь, что виртуальная сеть не имеет блокировок

Виртуальная сеть блокирует операции платформы во время миграции. Если у виртуальной сети есть блокировки, их необходимо удалить перед переносом. Дополнительные сведения о том, как проверить наличие блокировок подписки или группы ресурсов, см. в разделе "Настройка блокировок".

7. Выбор конфигураций

Вы можете создать новую Среда службы приложений зона ресурсов версии 3, если существующая среда находится в регионе, поддерживающем избыточность зоны.

Установите флажок "Включен", если вы хотите настроить избыточность зоны.

Если ваша среда находится в регионе, который не поддерживает избыточность зоны, флажок недоступен. Если вам нужен ресурс, избыточный между зонами Среда службы приложений версии 3, используйте один из вариантов миграции вручную и создайте ресурс в одном из регионов, поддерживающих избыточность зоны.

Если существующий Среда службы приложений использует суффикс личного домена, необходимо настроить его для нового ресурса Среда службы приложений версии 3. Параметры конфигурации для суффикса личного домена отображаются, если эта ситуация относится к вам. Вы не сможете перенести, пока не предоставьте необходимые сведения.

Если вы хотите использовать суффикс личного домена, но в настоящее время не настроено, можно настроить один после завершения миграции. Дополнительные сведения о Среда службы приложений суффиксов личного домена версии 3, включая требования, пошаговые инструкции и рекомендации, см. в статье суффикс личного домена для Среда службы приложений.

Примечание.

Если вы настраиваете суффикс личного домена, при добавлении разрешений сети в хранилище ключей Azure убедитесь, что хранилище ключей разрешает доступ из новых исходящих IP-адресов Среда службы приложений, созданных на шаге 2. Если вы обращаетесь к хранилищу ключей с помощью частной конечной точки, убедитесь, что вы правильно настроили частный доступ.

После добавления сведений о суффиксе личного домена кнопка "Миграция " доступна.

8. Переход на Среда службы приложений версии 3

Выполнив все описанные выше действия, вы можете начать миграцию. Убедитесь, что вы понимаете последствия миграции, включая то, что происходит в течение этого времени.

Этот шаг занимает три-шесть часов для миграций версии 2 до версии 3 и до шести часов для миграции версии 1 до версии 3 в зависимости от размера среды. Масштабирование и изменение существующих Среда службы приложений блокируются на этом шаге.

Примечание.

В редких случаях на портале может появиться уведомление о том, что "Миграция на Среда службы приложений версии 3 завершилась сбоем" после запуска миграции. Существует известная ошибка, которая может активировать это уведомление, даже если миграция выполняется. Проверьте журнал действий для Среда службы приложений, чтобы определить допустимость этого сообщения об ошибке. В большинстве случаев обновление страницы устраняет проблему, и сообщение об ошибке исчезает. Если сообщение об ошибке сохраняется, обратитесь в службу поддержки.

В настоящее время подробные состояния миграции доступны только при использовании Azure CLI. Дополнительные сведения см. в разделе Azure CLI для миграции на Среда службы приложений версии 3. Вы можете проверить состояние миграции с помощью интерфейса командной строки, даже если вы используете портал для миграции.

После завершения миграции у вас есть ресурс Среда службы приложений версии 3, а все приложения работают в новой среде. Версию окружения можно подтвердить, проверив страницу Конфигурация для вашей Среды службы приложений.

Если миграция включает суффикс личного домена, домен появился в разделе "Основные сведения" портала для Среда службы приложений версии 1/2, но он больше не отображается в Среда службы приложений версии 3. Вместо этого для Среда службы приложений версии 3 перейдите на страницу суффикса личного домена, чтобы убедиться, что суффикс личного домена настроен правильно. Вы также можете удалить конфигурацию, если она больше не нужна, или настроить ее, если у вас ее не было ранее.

Примечание.

Если миграция включает суффикс личного домена, конфигурация суффикса личного домена может показаться пониженной после завершения миграции из-за известной ошибки. Ваш Среда службы приложений по-прежнему должен функционировать должным образом. Состояние пониженного состояния должно разрешаться в течение 6–8 часов. Если конфигурация ухудшается через 8 часов или если суффикс личного домена не работает, обратитесь в службу поддержки.

Цены

Миграция Среды службы приложений является бесплатной. При использовании функции миграции на месте плата за предыдущие Среда службы приложений перестанет взиматься после завершения процесса миграции. Плата за новую Среда службы приложений версии 3 начинается сразу после развертывания. Дополнительные сведения о ценообразовании для Среды службы приложений версии 3 см. в Сведения о ценообразовании.

При переходе на Среда службы приложений версии 3 из предыдущих версий следует учитывать сценарии, которые могут снизить ежемесячные затраты. Рассмотрите планы резервирования и экономии для дальнейшего снижения затрат. Дополнительные сведения о возможностях экономии затрат см. в разделе "Экономия затрат" после обновления до Среда службы приложений версии 3.

Примечание.

Из-за переноса планов Службы приложений из категории «Изолированный» в «Изолированный (версия 2)» ваши приложения могут избыточно подготавливаться после миграции, поскольку в категории «Изолированный (уровень 2)» доступно больше ресурсов памяти и ЦП для каждого соответствующего размера экземпляра. По завершении миграции вы получите возможность по мере необходимости масштабировать среду. Дополнительные сведения см. в разделе Сведения о номере SKU.

Уменьшение масштаба планов Служба приложений

Номера SKU плана Служба приложений, доступные для Среда службы приложений версии 3, выполняются на уровне "Изолированный" версии 2 (Iv2). Количество ядер и объем ОЗУ фактически удвоится на соответствующий уровень по сравнению с изолированным уровнем. При миграции планы Служба приложений преобразуются в соответствующий уровень. Например, экземпляры I2 преобразуются в I2v2. Хотя I2 имеет два ядра и 7 ГБ ОЗУ, I2v2 имеет четыре ядра и 16 ГБ ОЗУ. Если вы ожидаете, что требования к емкости останутся неизменными, вы слишком подготовлены и оплачиваете вычислительные ресурсы и память, которую вы не используете. В этом сценарии вы можете уменьшить масштаб экземпляра I2v2 до I1v2 и в конечном итоге с аналогичным количеством ядер и ОЗУ, которые вы ранее сделали.

Часто задаваемые вопросы

• Как быть, если перенос Среды службы приложений в настоящее время не поддерживается?
  В настоящее время нельзя перенести с помощью функции миграции на месте. Если у вас есть неподдерживаемая среда и вы хотите немедленно выполнить миграцию, обратитесь к разделу Варианты миграции вручную.
• Разделы справки выбрать вариант миграции подходит для меня?
  Просмотрите дерево принятия решений по пути миграции, чтобы решить, какой вариант лучше всего подходит для вашего варианта использования.
• Разделы справки знать, следует ли использовать функцию миграции на месте?
  Функция миграции на месте лучше всего подходит для клиентов, которые хотят перенести Среда службы приложений версии 3 с минимальными изменениями в конфигурации сети и могут поддерживать около одного часа простоя приложения. Если вы не можете поддерживать простой, см. функцию миграции на стороне или параметры миграции вручную. Функция миграции на месте создает Среда службы приложений версии 3 в той же подсети, что и существующая среда, и использует ту же сетевую инфраструктуру. Возможно, вам придется учесть изменения входящего и исходящего IP-адреса, если у вас есть какие-либо зависимости от этих определенных IP-адресов.
• Каковая вероятность простоя во время миграции?
  Да, простой может составить около одного часа в окне обслуживания длительностью от трех до шести часов на этапе миграции, поэтому планируйте время соответствующим образом. Если у вас есть другая Среда службы приложений, на которую можно указать трафик во время миграции с помощью функции миграции на месте, можно устранить простой приложения. Если у вас нет другого Среда службы приложений и вы не можете поддерживать простой, ознакомьтесь с функцией параллельной миграции или вариантами миграции вручную.
• Нужно ли выполнять какие-либо действия в приложениях после миграции, чтобы обеспечить работу приложений в новой Среде службы приложений?
  Нет, все приложения, работающие в прежней версии среды, будут автоматически перенесены в новую среду и будут выполняться как раньше. Ввод данных пользователем не требуется.
• Что делать, если у моей Среды службы приложений есть суффикс личного домена?
  Функция миграции на месте поддерживает этот сценарий миграции.
• Что делать, если моя Среда службы приложений имеет закрепление по зоне?
  Закрепленная зона Среда службы приложений версии 2 теперь является поддерживаемым сценарием миграции с помощью функции миграции. Среда службы приложений версии 3 не поддерживает закрепление зон. При миграции на Среда службы приложений версии 3 можно настроить избыточность зоны или нет.
• Что делать, если Среда службы приложений имеет IP-адреса SSL? ПРОТОКОЛ SSL IP не поддерживается в Среда службы приложений версии 3. Перед переносом с помощью функции миграции или одного из параметров вручную необходимо удалить все привязки SSL IP-адресов. Если вы планируете использовать функцию миграции на месте, после удаления всех ssl-привязок IP-адресов передайте эту проверку и сможете продолжить автоматическую миграцию.
• Какие свойства Среды службы приложений будут изменены?
  Вы находитесь на Среда службы приложений версии 3, поэтому обязательно просмотрите функции и различия функций по сравнению с предыдущими версиями. Для Среды службы приложений с внутренней подсистемой балансировки нагрузки будет сохранен тот же IP-адрес внутренней подсистемы балансировки нагрузки. Для Среды службы приложений с выходом в Интернет будет изменен общедоступный и исходящий IP-адрес. Обратите внимание, что для Среды службы приложений с ELB ранее существовал один IP-адрес как для входящего, так и для исходящего трафика. Для Среды службы приложений версии 3 для этого используются разные IP-адреса. Дополнительные сведения см. в разделе Сеть в Среде службы приложений версии 3 руководства PCI. Чтобы ознакомиться с комплексным сравнением версий платформы "Среда службы приложений", см. Сравнение версий платформы "Среда службы приложений"
• Что происходит в случае сбоя миграции или непредвиденной проблемы во время миграции?
  Если возникла непредвиденная проблема, группы поддержки находятся под рукой. Перед касанием рабочих сред следует перенести среды разработки, чтобы узнать о процессе миграции и узнать, как это влияет на рабочие нагрузки.
• Что происходит с предыдущей версией Среды службы приложений?
  Если вы решите перенести Среда службы приложений с помощью функции миграции на месте, старая среда завершает работу, удаляется и все приложения переносятся в новую среду. Старая среда больше не доступна. Откат к старой среде невозможен.
• Что произойдет с ресурсами Сред службы приложений версий 1 и 2 после 31 августа 2024 г?
  После 31 августа 2024 года, если вы не Среда службы приложений версии 3, ваши Среда службы приложений версии 1/v2 и приложения, развернутые в них, больше не будут доступны. Среды службы приложений версий 1 и 2 размещаются в блоках масштабирования Службы приложений, которые выполняются в классической архитектуре Облачных служб, поддержка которой будет прекращена к 31 августа 2024 г. По этой причине Среды службы приложений версии 1 и 2 больше не будут доступны после этой даты. Выполните миграцию в Среду службы приложений версии 3, чтобы обеспечить запуск приложений, сохранение и резервное копирование всех ресурсов и данных, которые необходимо сохранить.

Следующие шаги

Сеть в Среде службы приложений версии 3

Использование Среды службы приложений версии 3

Суффикс личного домена