Migración a App Service Environment v3 usando la característica de migración local
Nota:
La característica de migración que se describe en este artículo se usa para la migración automatizada en contexto (misma subred) de App Service Environment v1 y v2 a App Service Environment v3. Si no ha solicitado un período de gracia de 30 días, revise la información general del período de gracia y después solicite un período de gracia; para ello, vaya a Azure Portal y visite la hoja Migración para cada uno de los entornos de App Service.
Si busca información sobre la característica de migración en paralelo, consulte Migración a App Service Environment v3 mediante la característica de migración en paralelo. Si busca información sobre las opciones de migración manual, consulte Opciones de migración manual. Para obtener ayuda para decidir qué opción de migración es adecuada para usted, consulte Árbol de decisión ruta de migración. Para obtener más información sobre App Service Environment v3, consulte Introducción a App Service Environment v3.
App Service puede automatizar la migración de un entorno de App Service Environment v1 y v2 a un entorno de App Service Environment v3. Hay diferentes opciones de migración. Revise el árbol de decisión de ruta de migración para decidir qué opción es mejor para su caso de uso. App Service Environment v3 proporciona ventajas y diferencias en las características con respecto a versiones anteriores. Asegúrese de revisar las características compatibles de App Service Environment v3 antes de migrar para reducir el riesgo de un problema inesperado en la aplicación.
La característica de migración local automatiza la migración a App Service Environment v3 mediante la actualización de App Service Environment existente en la misma subred. Esta opción de migración es mejor para los clientes que quieran migrar a App Service Environment v3 con cambios mínimos en sus configuraciones de red. También debe ser capaz de admitir aproximadamente una hora de tiempo de inactividad de la aplicación. Si no puede admitir tiempo de inactividad, consulte la característica de migración del lado o las opciones de migración manual.
Importante
Se recomienda usar primero esta característica en entornos de desarrollo para poder migrar los entornos de producción a fin de asegurarse de que no haya ningún problema inesperado. Proporcione comentarios relacionados con este artículo o la característica mediante los botones que se encuentran en la parte inferior de la página.
Escenarios admitidos
En este momento, la característica de migración local no admite migraciones a App Service Environment v3 en las regiones siguientes:
Microsoft Azure operado por 21Vianet
- Este de China 2
- Norte de China 2
Las siguientes configuraciones de App Service Environment se pueden migrar mediante la característica de migración local. La tabla proporciona la configuración de App Service Environment v3 cuando usa la característica de migración local en función del entorno de App Service Environment existente. Todos los entornos de App Service Environment que se admitan se pueden migrar a un entorno de App Service Environment v3 con redundancia de zona mediante la característica de migración local, siempre que el entorno esté en una región que admita redundancia de zona. Puede configurar la redundancia de zona durante el proceso de migración.
| Configuración | Configuración de App Service Environment v3 |
|---|---|
| App Service Environment v2 de equilibrador de carga interno (ILB) | App Service Environment v3 de ILB |
| Externo (ELB/Internet con dirección IP pública) App Service Environment v2 | App Service Environment v3 de ELB |
| App Service Environment v2 de ILB con un sufijo de dominio personalizado | App Service Environment v3 de ILB con un sufijo de dominio personalizado |
| App Service Environment v1 de ILB | App Service Environment v3 de ILB |
| App Service Environment v1 de ELB | App Service Environment v3 de ELB |
| App Service Environment v1 de ILB con un sufijo de dominio personalizado | App Service Environment v3 de ILB con un sufijo de dominio personalizado |
| App Service Environment v2 anclado a una zona | App Service Environment v3 con configuración opcional de redundancia de zona |
Si quiere que el nuevo entorno de App Service Environment v3 use un sufijo de dominio personalizado y no está usando uno actualmente, dicho sufijo de dominio personalizado se puede configurar en cualquier momento una vez se complete la migración. Para obtener más información, consulte Configuración del sufijo de dominio personalizado para App Service Environment.
Para encontrar la versión de App Service Environment, vaya al entorno de App Service Environment en Azure Portal y seleccione la opción Configuración en Configuración en el lado izquierdo. También puede usar Azure Resource Explorer y revisar el valor de la propiedad kind para su entorno de App Service Environment.
Limitaciones de características de migración local
A continuación se muestran algunas limitaciones cuando se usa la característica de migración local:
- El nuevo entorno de App Service Environment v3 se encuentra en la subred existente que se usó para el entorno anterior.
- No se puede cambiar la región en la que se encuentra App Service Environment.
- Los entornos de App Service Environment de ELB no se pueden migrar a App Service Environment v3 de ILB y viceversa.
- Si el entorno existente de App Service Environment usa un sufijo de dominio personalizado, debe configurar uno para el entorno de App Service Environment v3 durante el proceso de migración.
- Si ya no quiere usar un sufijo de dominio personalizado, puede quitarlo una vez se complete la migración.
App Service Environment v3 no admite las siguientes características que puede usar con la versión 1 o v2 actual de App Service Environment.
- Configuración de un enlace TLS/SSL basado en IP con las aplicaciones.
- App Service Environment v3 no vuelve a Azure DNS si los servidores DNS personalizados configurados de la red virtual no pueden resolver un nombre determinado. Si este comportamiento es necesario, asegúrese de que tiene un reenviador a un DNS público o de incluir Azure DNS en la lista de servidores DNS personalizados.
La característica de migración local no admite los siguientes escenarios. Consulte las opciones de migración manual si el entorno de App Service Environment se incluye en una de estas categoría.
- App Service Environment v1 en una red virtual clásica
- App Service Environment v2 de ELB con direcciones SSL de IP
- App Service Environment v1 de ELB con direcciones SSL de IP
- App Service Environment con un nombre que no cumple los límites de caracteres. El nombre completo, incluido el sufijo de dominio, debe tener 64 caracteres o menos. Por ejemplo: my-ase-name.appserviceenvironment.net para ILB y my-ase-name.p.azurewebsites.net para ELB deben tener 64 caracteres o menos. Si no cumple el límite de caracteres, debe migrar manualmente. Los límites de caracteres específicos para el nombre de App Service Environment son los siguientes:
- Límite de caracteres de nombre de App Service Environment de ILB: 36 caracteres
- Límite de caracteres de nombre de App Service Environment de ELB: 42 caracteres
La plataforma de App Service revisa el entorno de App Service Environment para confirmar la compatibilidad con la migración local. Si el escenario no pasa todas las comprobaciones de validación, no podrá migrar en este momento mediante la característica de migración local. Si el entorno está en un estado incorrecto o suspendido, no podrá migrar hasta que realice las actualizaciones necesarias.
Nota
App Service Environment v3 no admite SSL de IP. Si usa SSL de IP, deberá quitar todos los enlaces SSL de IP antes de migrar a App Service Environment v3. La característica de migración admitirá el entorno una vez que se quiten todos los enlaces SSL de IP.
Solución de problemas
Si App Service Environment no supera las comprobaciones de validación o intenta realizar un paso de migración en el orden incorrecto, puede ver uno de los siguientes mensajes de error:
| Mensaje de error | Descripción | Recomendación |
|---|---|---|
| Solo se puede llamar a la migración en un ASE en una red virtual de ARM y si dicho ASE está en la red virtual clásica. | Los entornos de App Service Environment de redes virtuales clásicas no se pueden migrar mediante la característica de migración local. | Migrar mediante una de las opciones de migración manual. |
| La migración de ASEv3 aún no está lista. | La infraestructura subyacente no está lista para admitir App Service Environment v3. | Migre con una de las opciones de migración manual si desea migrar inmediatamente. De lo contrario, espere a que la característica de migración local esté disponible en su región. |
| No se puede llamar a la migración en este ASE; póngase en contacto con el soporte técnico para obtener ayuda para la migración. | Tiene que contar con la ayuda del soporte técnico para migrar este entorno de App Service Environment. Este problema puede deberse a la configuración personalizada que usa este entorno. | Abra un caso de soporte técnico para comunicarse con el soporte técnico para resolver el problema. |
| No se puede llamar a la migración si la opción SSL de IP está habilitada en alguno de los sitios. | Los entornos de App Service Environment que tienen sitios con la opción SSL de IP habilitada no se pueden migrar mediante la característica de migración. | Quite el SSL de IP de todas las aplicaciones de App Service Environment para habilitar la característica de migración. |
| No se puede llamar a la migración completa antes de que se generen direcciones IP. | Este error aparece si intenta migrar antes de finalizar los pasos de premigración. | Asegúrese de completar todos los pasos previos a la migración antes de intentar migrar. Consulte la guía paso a paso para la migración. |
| No se permite la migración a ASEv3 para este ASE. | No podrá realizar la migración mediante la característica de migración. | Migrar mediante una de las opciones de migración manual. |
| La suscripción tiene demasiados entornos de App Service Environment. Quite algunos entornos antes de intentar crear más. | Se cumple la cuota de App Service Environment para la de suscripción. | Elimine entornos innecesarios o póngase en contacto con el soporte técnico para revisar las opciones. |
<ZoneRedundant><DedicatedHosts><ASEv3/ASE> no está disponible en esta ubicación. |
Este error se muestra si está intentando migrar un entorno de App Service Environment en una región que no admite una de las características solicitadas. | Migre con una de las opciones de migración manual si desea migrar inmediatamente. De lo contrario, espere a que la característica de migración admita esta configuración de App Service Environment. |
| No se puede llamar a la migración en este ASE hasta que finalice la actualización activa. | Las instancias de App Service Environment no se pueden migrar durante las actualizaciones de la plataforma. Puede establecer las preferencias de actualización en Azure Portal. Las actualizaciones tardan entre 8 y 12 horas o más en función del tamaño (número de instancias o núcleos) de App Service Environment. | Espere hasta que finalice la actualización y, a continuación, migre. |
| La operación de administración de App Service Environment está en curso. | App Service Environment está realizando una operación de administración. Entre estas operaciones se pueden incluir actividades como implementaciones o actualizaciones. La migración se bloquea hasta que se completan estas operaciones. | Puede migrar una vez completadas estas operaciones. |
| La migración no está disponible para esta suscripción. | Tiene que contar con la ayuda del soporte técnico para migrar este entorno de App Service Environment. | Abra un caso de soporte técnico para comunicarse con el soporte técnico para resolver el problema. |
| El InteralLoadBalancingMode no se admite actualmente. | Los entornos de App Service Environment que tienen InternalLoadBalancingMode establecido en determinados valores no se pueden migrar mediante la característica de migración en este momento. El equipo de Microsoft debe cambiar manualmente InternalLoadBalancingMode. | Abra un caso de soporte técnico para comunicarse con el soporte técnico para resolver el problema. Solicite una actualización a InternalLoadBalancingMode para permitir la migración. |
Información general sobre el proceso de migración mediante la característica de migración local
La migración local consta de una serie de pasos que se deben seguir en orden. Aquí se indican los puntos clave para un subconjunto de los pasos. Es importante comprender lo que ocurre durante estos pasos y cómo se verán afectados el entorno y las aplicaciones. Después de revisar la información siguiente y cuando esté a punto para migrar, siga la guía paso a paso.
Compruebe que la migración se admite mediante la característica de migración local para App Service Environment.
La plataforma valida que App Service Environment se puede migrar mediante la característica de migración local. Si App Service Environment no supera todas las comprobaciones de validación, no se puede migrar en este momento mediante la característica de migración local. Consulte la sección solución de problemas para obtener más información sobre las posibles causas de error de validación. Si el entorno está en un estado incorrecto o suspendido, no podrá migrar hasta que realice las actualizaciones necesarias. Si no puede migrar mediante la característica de migración local, consulte las opciones de migración manual.
La validación también comprueba si App Service Environment está en la compilación mínima necesaria para la migración. Esta compilación puede ser más reciente que la compilación estándar que se implementa con el ciclo de actualización y mantenimiento rutinarios de la plataforma. La compilación mínima se actualiza periódicamente para asegurarse de que hay disponibles las últimas correcciones de errores y mejoras. Si App Service Environment no está en la compilación mínima, debe iniciar la actualización usted mismo. Esta actualización es un proceso estándar en el que App Service Environment no se ve afectado, pero no puede escalar ni realizar cambios en app Service Environment mientras la actualización está en curso. No se puede migrar hasta que finalice la actualización. Las actualizaciones pueden tardar entre 8 y 12 horas en completarse o más en función del tamaño de su entorno. Si planea un período de tiempo específico para la migración, debe ejecutar la comprobación de validación 24-48 horas antes del tiempo de migración planeado para asegurarse de que tiene tiempo para una actualización si es necesario.
Generación de direcciones IP para el nuevo entorno de App Service Environment v3
La plataforma crea la nueva IP de entrada (si está migrando un entorno de App Service Environment de ELB) y las nuevas direcciones IP de salida. Mientras se crean estas IP, la actividad con el entorno de App Service Environment existente no se interrumpe, pero no podrá escalar ni realizar cambios en este entorno. Este proceso tarda unos 15 minutos en completarse.
Cuando haya finalizado, se le darán las nuevas IP que usará el futuro entorno de App Service Environment v3. Estas nuevas IP no afectan de ninguna manera en el entorno existente. Las IP que usa el entorno existente se siguen utilizando hasta que este se apague durante el paso de migración.
Actualización de recursos dependientes con IP nuevas
Una vez creadas las nuevas direcciones IP, tiene la nueva salida predeterminada a las direcciones públicas de Internet. Como preparación para la migración, puede ajustar los firewalls externos, el enrutamiento DNS, los grupos de seguridad de red y cualquier otro recurso que dependa de estas direcciones IP. En el caso de los entornos de App Service Environment de ELB, también tiene la nueva dirección IP de entrada que puede usar para configurar nuevos puntos de conexión con servicios como Traffic Manager o Azure Front Door. Es responsabilidad suya actualizar todos los recursos que se verán afectados por el cambio de dirección IP asociado al nuevo entorno de App Service Environment v3. No avance al paso siguiente hasta que haya realizado todas las actualizaciones necesarias. Este paso también es un buen momento para revisar los cambios en las dependencias de red entrantes y salientes al pasar a App Service Environment v3, incluido el cambio de puerto para el sondeo de estado de Azure Load Balancer, que ahora usa el puerto 80.
Delegación de la subred de App Service Environment
En App Service Environment v3 es necesario que la subred en la que se encuentra tenga una sola delegación de Microsoft.Web/hostingEnvironments. La migración no se puede realizar correctamente si la subred de App Service Environment no está delegada o la delega en un recurso diferente.
Confirmación de cambios de tamaño de instancia
Los planes de App Service se convierten de Aislado al nivel Aislado v2 correspondiente como parte de la migración. Por ejemplo, I2 se convierte en I2v2. Es posible que las aplicaciones se aprovisionen en exceso después de la migración, ya que el nivel Aislado v2 tiene más memoria y CPU por tamaño de instancia correspondiente. Tiene la oportunidad de escalar el entorno según sea necesario una vez completada la migración. Para obtener más información, revise los detalles de la SKU.
Asegúrese de que no haya bloqueos en los recursos
Los bloqueos de la red virtual bloquean las operaciones de la plataforma durante la migración. Si la red virtual tiene bloqueos, debe quitarlos antes de migrar. Los bloqueos se pueden volver a añadir si hace falta una vez completada la migración. Los bloqueos pueden existir en tres ámbitos diferentes: suscripción, grupo de recursos y recurso. Cuando se aplica un bloqueo en un ámbito primario, todos los recursos heredan el mismo bloqueo. Si tiene bloqueos aplicados en el ámbito de suscripción, grupo de recursos o recurso, debe quitarlos antes de llevar a cabo la migración. Para más información sobre los bloqueos y la herencia de bloqueos, consulte Bloqueo de los recursos para proteger la infraestructura.
Asegúrese de que no hay ninguna migración de bloqueo de directivas de Azure
Azure Policy se puede usar para denegar la creación y modificación de recursos a determinadas entidades de seguridad. Si tiene una directiva que bloquea la creación de entornos de App Service o la modificación de subredes, debe quitarla antes de migrar. La directiva se puede leer si es necesario una vez completada la migración. Para más información sobre Azure Policy, consulte información general de Azure Policy.
Elija las configuraciones de App Service Environment v3
El entorno de App Service Environment v3 se puede implementar en zonas de disponibilidad en las regiones que lo admiten. Esta arquitectura se conoce como redundancia de zona. La redundancia de zona solo se puede configurar durante la creación de App Service Environment. Si quiere que el nuevo entorno de App Service Environment v3 tenga redundancia de zona, habilite la configuración durante el proceso de migración. Cualquier entorno de App Service Environment que use la característica de migración local para migrar se puede configurar como redundante de zona siempre que use una región que admita redundancia de zona para App Service Environment v3. Si el entorno existente está en una región que no admite redundancia de zona, la opción de configuración se deshabilita y no podrá configurarla. La característica de migración local no admite el cambio de regiones. Si desea quiere usar otra región, use una de las opciones de migración manuales.
Nota
La habilitación de la redundancia de zona puede conllevar cargos adicionales. Para obtener más información, revise el modelo de precios de redundancia de zona.
Si el entorno existente de App Service Environment usa un sufijo de dominio personalizado, se le solicitará que configure uno para el nuevo entorno de App Service Environment v3. Debe proporcionar el nombre de dominio personalizado, la identidad administrada y el certificado. Para obtener más información sobre el sufijo de dominio personalizado de App Service Environment v3, incluidos los requisitos, las instrucciones paso a paso y los procedimientos recomendados, consulte Configuración del sufijo de dominio personalizado para App Service Environment. Debe configurar un sufijo de dominio personalizado para el nuevo entorno, aunque ya no quiera usarlo. Una vez se complete la migración, puede quitar la configuración del sufijo de dominio personalizado si es necesario.
Si la migración incluye un sufijo de dominio personalizado, en el caso de App Service Environment v3, el dominio personalizado no se muestra en la sección Essentials de la página Información general del portal, ya que es para App Service Environment v1 o v2. En lugar de esto, en el caso de App Service Environment v3, vaya a la página Sufijo de dominio personalizado, donde podrá confirmar que el sufijo de dominio personalizado está configurado correctamente. Además, en App Service Environment v2, si tiene un sufijo de dominio personalizado, el nombre de host predeterminado incluye el sufijo de dominio personalizado y tiene el formato APP-NAME.internal.contoso.com. En App Service Environment v3, el nombre de host predeterminado siempre usa el sufijo de dominio predeterminado y tiene el formato APP-NAME.ASE-NAME.appserviceenvironment.net. Esta diferencia se debe a que App Service Environment v3 mantiene el sufijo de dominio predeterminado al agregar un sufijo de dominio personalizado. Con App Service Environment v2, solo hay un sufijo de dominio único.
Migración a App Service Environment v3
Después de completar los pasos anteriores, debe continuar con la migración lo antes posible.
Importante
Dado que el escalado se bloquea durante la migración, debe escalar el entorno al tamaño deseado antes de iniciar la migración. Si tiene habilitado el escalado automático, y se produce un evento de escalado antes de que se inicie la migración, tendrá que esperar hasta que se complete el evento de escalado antes de iniciar la migración. Debe deshabilitar el escalado automático antes de iniciar la migración para evitar este problema. Si necesita escalar el entorno después de la migración, puede hacerlo una vez completada la migración.
La migración requiere una ventana de servicio de tres a seis horas para las migraciones de entornos de App Service Environment v2 a v3. Se requiere un período de servicio de hasta seis horas en función del tamaño del entorno para las migraciones de v1 a v3. La ventana de servicio se puede extender en casos poco frecuentes en los que se requiere la intervención manual del equipo de servicio. Durante la migración, se bloquean las configuraciones de escalado y entorno, y se producen los siguientes eventos:
- El entorno nuevo de App Service Environment v3 apaga y reemplaza al entorno de App Service Environment existente.
- Todos los planes de App Service en el entorno de App Service Environment se convierten del nivel Aislado a Aislado v2.
- Todas las aplicaciones que están en el entorno de App Service Environment están temporalmente fuera de servicio. Debe esperar aproximadamente una hora de tiempo de inactividad durante este período.
- Si no puede admitir tiempo de inactividad, consulte la característica de migración en paralelo o las alternativas de migración.
- Las direcciones públicas que usa el entorno de App Service Environment cambian a las IP que se generan en el paso de generación de IP.
Los siguientes estados están disponibles durante el proceso de migración:
| Estado | Descripción |
|---|---|
| Validación y preparación de la migración. | La plataforma está validando la compatibilidad con la migración y realizando comprobaciones necesarias. |
| Implementación de la infraestructura de App Service Environment v3. | La nueva infraestructura App Service Environment v3 se está aprovisionando. |
| Esperando a que se complete la infraestructura. | La plataforma valida la nueva infraestructura y realiza comprobaciones necesarias. |
| Configuración de conexión en red. Se ha iniciado el período de tiempo de inactividad de la migración. No se puede acceder a las aplicaciones. | La plataforma elimina la infraestructura antigua y mueve todas las aplicaciones a la nueva instancia de App Service Environment v3. Las aplicaciones están inactivas y no aceptan tráfico. |
| Ejecución de validaciones posteriores a la migración. | La plataforma realiza comprobaciones necesarias para asegurarse de que la migración se ha realizado correctamente. |
| Finalización de la migración. | La plataforma está finalizando la migración. |
Al igual que en el paso de generación de IP, durante este proceso no puede escalar o modificar el entorno de App Service Environment ni implementar aplicaciones en él. Una vez completada la migración, las aplicaciones que estaban en el entorno antiguo de App Service Environment se ejecutan en el entorno nuevo de App Service Environment v3.
Uso de la característica de migración local
Requisitos previos
Asegúrese de que comprende cómo afecta la migración a App Service Environment v3 a las aplicaciones. Revise el proceso de migración para comprender la escala de tiempo del proceso y dónde y cuándo tendrá que participar. Revise también las preguntas más frecuentes, que pueden responder a algunas de sus preguntas.
Asegúrese de que no hay bloqueos en la red virtual, el grupo de recursos, el recurso o la suscripción. Los bloqueos bloquean las operaciones de plataforma durante la migración.
Asegúrese de que no haya directivas de Azure que bloqueen las acciones necesarias para la migración, incluidas las modificaciones de subred y las creaciones de recursos de Azure App Service. Las directivas que bloquean las modificaciones y las creaciones de recursos pueden provocar que la migración se bloquee o produzca un error.
Dado que el escalado se bloquea durante la migración, debe escalar el entorno al tamaño deseado antes de iniciar la migración. Si necesita escalar el entorno después de la migración, puede hacerlo una vez completada la migración. Si tiene habilitado el escalado automático, y se produce un evento de escalado antes de que se inicie la migración, esta se bloqueará hasta que se complete el evento de escalado. Debe deshabilitar el escalado automático antes de iniciar la migración para evitar este problema.
Se recomienda usar Azure Portal para la experiencia de migración local. Si decide usar la CLI de Azure para llevar a cabo la migración, siga los pasos descritos aquí en orden y conforme a lo indicado, ya que realiza llamadas de API de REST de Azure. Se recomienda usar la CLI de Azure para realizar estas llamadas de API. Para obtener información acerca de otros métodos, consulte Referencia de API de REST de Azure.
Para esta guía, instale la CLI de Azure o use Azure Cloud Shell y utilice un shell de Bash.
Nota:
Se recomienda usar un shell de Bash para ejecutar los comandos proporcionados en esta guía. Es posible que los comandos no sean compatibles con las convenciones de PowerShell y los caracteres de escape.
1. Obtención del id. de App Service Environment
Ejecute los comandos siguientes para obtener el identificador de App Service Environment y almacenarlo como una variable de entorno. Reemplace los marcadores de posición del nombre y los grupos de recursos por los valores de App Service Environment que quiera migrar. ASE_RG y VNET_RG son los mismos si la red virtual y App Service Environment están en el mismo grupo de recursos.
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. Validación de la compatibilidad de la migración
El siguiente comando comprueba si su App Service Environment es compatible para la migración y valida que su App Service Environment se encuentra en la versión de compilación compatible para la migración.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=validation"
Si no hay errores, se admite la migración y puede continuar con el paso siguiente.
Si necesita iniciar una actualización para actualizar App Service Environment a la versión de compilación admitida, ejecute el siguiente comando. Ejecute este comando solo si produce un error en el paso de validación y se le indica que actualice App Service Environment.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=PreMigrationUpgrade"
3. Generación de direcciones IP para el nuevo recurso de App Service Environment v3
Ejecute el comando siguiente para crear nuevas direcciones IP. Este paso tarda unos 15 minutos en completarse. No modifique la escala ni realice cambios en la instancia existen de App Service Environment durante este tiempo.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=premigration"
Ejecute el comando siguiente para comprobar el estado de este paso:
az rest --method get --uri "${ASE_ID}?api-version=2021-02-01" --query properties.status
Si el paso está en curso, obtiene el estado Migrating. Una vez que obtenga el estado Ready, ejecute el comando siguiente para ver las nuevas direcciones IP. Si no ve las nuevas direcciones IP inmediatamente, espere unos minutos e inténtelo de nuevo.
az rest --method get --uri "${ASE_ID}/configurations/networking?api-version=2021-02-01"
4. Actualización de recursos dependientes con IP nuevas
Mediante el uso de las nuevas IP, actualice sus recursos o los componentes de red para asegurarse de que el nuevo entorno funciona según lo previsto una vez que se complete la migración. Es responsable de realizar las actualizaciones necesarias.
5. Delegación de la subred de App Service Environment
En App Service Environment v3 es necesario que la subred en la que se encuentra tenga una sola delegación de Microsoft.Web/hostingEnvironments. En las versiones anteriores no es necesaria esta delegación. Tiene que confirmar que la subred se ha delegado correctamente y actualizar la delegación (si es necesario) antes de migrar. Puede actualizar la delegación si ejecuta el comando siguiente o si va hasta la subred en Azure Portal.
az network vnet subnet update --resource-group $VNET_RG --name <subnet-name> --vnet-name <vnet-name> --delegations Microsoft.Web/hostingEnvironments
6. Confirme que no hay bloqueos en la red virtual
Los bloqueos de la red virtual bloquean las operaciones de la plataforma durante la migración. Si la red virtual tiene bloqueos, debe quitarlos antes de migrar. Si es necesario, puede volver a agregar los bloqueos una vez completada la migración.
Use el siguiente comando para comprobar si la red virtual tiene bloqueos:
az lock list --resource-group $VNET_RG --resource <vnet-name> --resource-type Microsoft.Network/virtualNetworks
Elimine los bloqueos existentes con el siguiente comando:
az lock delete --resource-group $VNET_RG --name <lock-name> --resource <vnet-name> --resource-type Microsoft.Network/virtualNetworks
Para ver los comandos relacionados para comprobar si la suscripción o el grupo de recursos tiene bloqueos, consulte la Referencia de la CLI de Azure para bloqueos.
7. Prepare las configuraciones
Puede hacer que la zona del nuevo recurso App Service Environment v3 sea redundante si el entorno existente está en una región que admita la redundancia de zona. La redundancia de zona se puede configurar estableciendo la propiedad zoneRedundant en true.
Si el App Service Environment existente usa un sufijo de dominio personalizado, debe configurar uno para el nuevo recurso App Service Environment v3 durante el proceso de migración. Se produce un error en la migración si no configura un sufijo de dominio personalizado y usa uno actualmente. También se produce un error en la migración si intenta agregar un sufijo de dominio personalizado durante la migración a un entorno que no tiene uno configurado. Para obtener más información sobre el sufijos de dominio personalizado de App Service Environment v3, incluidos los requisitos, las instrucciones paso a paso y los procedimientos recomendados, consulte Sufijo de dominio personalizado para App Service Environment.
Nota:
Si va a configurar un sufijo de dominio personalizado, al agregar los permisos de red en el almacén de claves de Azure, asegúrese de que el almacén de claves permite el acceso desde las nuevas direcciones IP de salida de App Service Environment que se generaron en el paso 3. Si accede al almacén de claves mediante un punto de conexión privado, asegúrese de que ha configurado el acceso privado correctamente.
Si la migración no incluye un sufijo de dominio personalizado y no habilita la redundancia de zona, puede pasar a la migración.
Para establecer estas configuraciones, cree un archivo denominado parameters.json con los detalles siguientes en función de su escenario. No incluya las propiedades para un sufijo de dominio personalizado si esta característica no se aplica a la migración. Preste atención al valor de la propiedad zoneRedundant, ya que esta configuración es irreversible después de la migración. Establezca el valor de la propiedad kind en función de la versión de App Service Environment existente. Los valores posibles para la propiedad kind son ASEV1 y ASEV2.
Si va a migrar sin un sufijo de dominio personalizado y habilita la redundancia de zona, use el código siguiente:
{
"type": "Microsoft.Web/hostingEnvironments",
"name": "sample-ase-migration",
"kind": "ASEV2",
"location": "westcentralus",
"properties": {
"zoneRedundant": true
}
}
Si usa una identidad administrada asignada por el usuario para la configuración del sufijo de dominio personalizado y habilita la redundancia de zona, use el código siguiente:
{
"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"
}
}
}
Si usa una identidad administrada asignada por el sistema para la configuración del sufijo de dominio personalizado y no habilita la redundancia de zona, use el código siguiente:
{
"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. Migración manual a App Service Environment v3 y comprobación del estado
Una vez completados todos los pasos anteriores, puede iniciar la migración. Asegúrese de comprender las implicaciones de la migración.
Este paso tarda de tres a seis horas para las migraciones de v2 a v3 y hasta seis horas para las migraciones de v1 a v3, en función del tamaño del entorno. Durante ese tiempo, hay aproximadamente una hora de tiempo de inactividad de la aplicación. El escalado, la implementación y las modificaciones en la instancia existente de App Service Environment se bloquean durante este paso.
Incluya el parámetro body en el comando siguiente si va a habilitar la redundancia de zona o está configurando un sufijo de dominio personalizado. Si ninguna de esas configuraciones se aplica a la migración, puede quitar el parámetro del comando.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=fullmigration" --body @parameters.json
Ejecute los comandos siguientes para comprobar el estado detallado de la migración. Para obtener información sobre los estados, consulte las descripciones de estado de migración.
El primer comando obtiene el id. de la operación para la migración. Copie el valor de la propiedad ID.
az rest --method get --uri "${ASE_ID}/operations?api-version=2022-03-01"
Reemplace el marcador de posición del id. de la operación en el siguiente comando por el valor ha copiado. Este comando devuelve el estado detallado de la migración. Puede ejecutar este comando con la frecuencia necesaria para obtener el estado más reciente.
az rest --method get --uri "${ASE_ID}/operations/<operation-id>/details/default?api-version=2022-09-01"
Una vez que obtenga el estado Ready, la migración habrá terminado y tendrá un recurso App Service Environment v3. Las aplicaciones se ejecutan ahora en el nuevo entorno.
Para obtener los detalles del nuevo entorno, ejecute el comando siguiente o vaya a Azure Portal.
az appservice ase show --name $ASE_NAME --resource-group $ASE_RG
1. Validación de la compatibilidad de la migración
En Azure Portal, vaya a la página Migración de la instancia de App Service Environment a la que está migrando. Para acceder a la página Migración, seleccione el mensaje de la parte superior de la página Información general de la instancia de App Service Environment o seleccione el elemento Migración del menú izquierdo.
Seleccione la opción de migración "En contexto" para iniciar el proceso de migración local. Si selecciona la opción para migración en paralelo, se le lleva a la documentación de ese proceso de migración. No seleccione la opción de migración en paralelo si desea usar la característica de migración local.
En la página Migración, la plataforma valida si se admite la migración de la instancia de App Service Environment. Seleccione Validar y confirme que desea continuar con la validación. El proceso de validación requiere algunos segundos.
Si el entorno no es compatible con la migración, aparece un mensaje en la parte superior de la página con un mensaje de error con un motivo. Consulte la sección Solución de problemas para ver descripciones de los mensajes de error que pueden aparecer si no es apto para la migración.
Si necesita iniciar una actualización para actualizar App Service Environment a la versión de compilación admitida, se le pedirá que inicie la actualización, lo que puede tardar entre 8 y 12 horas o más en función del tamaño de su entorno. Seleccione Actualizar para iniciar la actualización. Una vez completada la actualización, se pasa la validación y se puede usar la característica de migración para iniciar la migración.
Si la migración es compatible con su instancia de App Service Environment, continúe con el paso siguiente del proceso. La página Migración le guía a lo largo de la serie de pasos necesarios para realizar la migración.
2. Generación de direcciones IP para el nuevo recurso de App Service Environment v3
En Obtener nuevas direcciones IP, confirme que comprende las implicaciones e inicie el proceso y seleccione el botón Inicio. Este paso tarda unos 15 minutos en completarse. No puede modificar la escala ni realizar cambios en la instancia existente de App Service Environment durante este tiempo.
3. Actualización de recursos dependientes con IP nuevas
Al terminar el paso anterior, aparecen las direcciones IP del nuevo recurso App Service Environment v3. Con las nuevas IP puede actualizar los recursos y los componentes de red para que el nuevo entorno funcione según lo previsto una vez que se complete la migración. Es responsable de realizar las actualizaciones necesarias.
4. Delegación de la subred de App Service Environment
En App Service Environment v3 es necesario que la subred en la que se encuentra tenga una sola delegación de Microsoft.Web/hostingEnvironments. En las versiones anteriores no es necesaria esta delegación. Tiene que confirmar que la subred se ha delegado correctamente y actualizar la delegación (si es necesario) antes de migrar. El portal muestra un vínculo a la subred para que pueda confirmar y actualizar según sea necesario.
5. Confirmación de cambios de tamaño de instancia
Seleccione el botón Confirmar para confirmar que entiende que sus planes de App Service se convierten del nivel Aislado al correspondiente nivel Aislado v2 como parte de la migración.
6. Confirmación de que la red virtual no tiene bloqueos
Los bloqueos de la red virtual bloquean las operaciones de la plataforma durante la migración. Si la red virtual tiene bloqueos, debe quitarlos antes de migrar. Para más información sobre cómo comprobar si la suscripción o el grupo de recursos tiene bloqueos, consulte Configuración de bloqueos.
7. Elija las configuraciones
Puede hacer que la zona del nuevo recurso App Service Environment v3 sea redundante si el entorno existente está en una región que admita la redundancia de zona.
Active la casilla Habilitado si quiere configurar la redundancia de zona.
Si el entorno está en una región que no admite redundancia de zona, la casilla no está disponible. Si necesita un recurso App Service Environment v3 con redundancia de zona, use una de las opciones de migración manual y cree el recurso en una de las regiones que admite la redundancia de zona.
Si el App Service Environment existente usa un sufijo de dominio personalizado, deberá configurar uno para el nuevo recurso App Service Environment v3. Las opciones de configuración de un sufijo de dominio personalizado aparecen si esta situación se aplica a usted. No puede migrar hasta que proporcione la información necesaria.
Si quiere usar un sufijo de dominio personalizado, pero no tiene configurado actualmente uno, puede configurar uno una vez completada la migración. Para obtener más información sobre el sufijos de dominio personalizado de App Service Environment v3, incluidos los requisitos, las instrucciones paso a paso y los procedimientos recomendados, consulte Sufijo de dominio personalizado para App Service Environment.
Nota:
Si va a configurar un sufijo de dominio personalizado, al agregar los permisos de red en el almacén de claves de Azure, asegúrese de que el almacén de claves permite el acceso desde las nuevas direcciones IP de salida de App Service Environment que se generaron en el paso 2. Si accede al almacén de claves mediante un punto de conexión privado, asegúrese de que ha configurado el acceso privado correctamente.
Después de agregar los detalles del sufijo de dominio personalizado, el botón Migrar está disponible.
8. Migración a App Service Environment v3
Una vez completados todos los pasos anteriores, puede iniciar la migración. Asegúrese de comprender las implicaciones de la migración, incluido lo que ocurre durante este tiempo.
Este paso tarda de tres a seis horas para las migraciones de v2 a v3 y hasta seis horas para las migraciones de v1 a v3, en función del tamaño del entorno. El escalado y las modificaciones en la instancia existente de App Service Environment se bloquean durante este paso.
Nota:
En raras ocasiones, es posible que vea una notificación en el portal que indica "Error de migración a App Service Environment v3" después de iniciar la migración. Hay un error conocido que podría desencadenar esta notificación, incluso si la migración está progresando. Compruebe el registro de actividad de App Service Environment para determinar la validez de este mensaje de error. En la mayoría de los casos, al actualizar la página se resuelve el problema y el mensaje de error desaparece. Si el mensaje de error persiste, póngase en contacto con el soporte técnico para obtener ayuda.
En este momento, los estados detallados de la migración solo están disponibles cuando se usa la CLI de Azure. Para obtener más información, consulte la sección CLI de Azure para migrar a App Service Environment v3. Puede comprobar el estado de la migración con la CLI incluso si usa el portal para realizar la migración.
Una vez completada la migración, tiene un recurso App Service Environment v3 y todas las aplicaciones se ejecutan en el nuevo entorno. Para confirmar la versión del entorno, vea la página Configuración de App Service Environment.
Si la migración incluye un sufijo de dominio personalizado, el dominio aparecía en la sección Información esencial de la página Información general del portal para App Service Environment v1/v2, pero ya no aparece en App Service Environment v3. Alternativamente, en el caso de App Service Environment v3, vaya a la página Sufijo de dominio personalizado, para confirmar que el sufijo de dominio personalizado está configurado correctamente. También puede quitar la configuración si ya no lo necesita o configurar uno si no lo tenía anteriormente.
Nota:
Si la migración incluye un sufijo de dominio personalizado, su configuración podría mostrarse como degradada una vez completada la migración debido a un error conocido. App Service Environment debería seguir funcionando con normalidad. El estado degradado se debería resolver automáticamente en un plazo de 6 a 8 horas. Si la configuración sigue degradada después de 8 horas o si el sufijo del dominio personalizado no funciona, póngase en contacto con el soporte técnico.
Precios
La migración del entorno de App Service Environment no conlleva ningún costo. Cuando se usa la característica de migración local, se deja de cobrar por la instancia anterior de App Service Environment en cuanto se cierra durante el proceso de migración. Empiece a cobrarse por la nueva instancia de App Service Environment v3 en cuanto se implemente. Para obtener más información sobre los precios de App Service Environment v3, vea los detalles sobre precios.
Al migrar al entorno de App Service Environment v3 de versiones anteriores, hay escenarios que debe tener en cuenta que pueden reducir el costo mensual. Considere reservas y planes de ahorro para reducir aún más los costos. Para obtener información sobre las oportunidades de ahorro de costos, consulte Oportunidades de ahorro de costos después de actualizar a App Service Environment v3.
Nota:
Debido a la conversión de planes de App Service de Aislado a Aislado v2, es posible que las aplicaciones se aprovisionen en exceso después de la migración, ya que el nivel Aislado v2 tiene más memoria y CPU por tamaño de instancia correspondiente. Tendrá la oportunidad de escalar el entorno según sea necesario una vez completada la migración. Para obtener más información, revise los detalles de la SKU.
Reducción vertical de los planes de App Service
Las SKU del plan de App Service disponibles para el entorno de App Service Environment v3 se ejecutan en el nivel Aislado v2 (Iv2). El número de núcleos y la cantidad de RAM se duplican eficazmente por nivel correspondiente en comparación con el nivel Aislado. Al migrar, los planes de App Service se convierten en el nivel correspondiente. Por ejemplo, las instancias de I2 se convierten en I2v2. Aunque I2 tiene dos núcleos y 7 GB de RAM, I2v2 tiene cuatro núcleos y 16 GB de RAM. Si espera que los requisitos de capacidad permanezcan iguales, está sobreaprovisionando y paga por proceso y memoria que no está usando. En este escenario, puede reducir verticalmente la instancia de I2v2 a I1v2 y terminar con un número similar de núcleos y RAM al que tenía anteriormente.
Preguntas más frecuentes
- ¿Qué ocurre si la migración de mi entorno de App Service Environment no es compatible actualmente?
No podrá realizar la migración local mediante la característica de migración en este momento. Si tiene un entorno no compatible y quiere migrar inmediatamente, consulte las opciones de migración manual. - ¿Cómo puedo elegir qué opción de migración es adecuada para mí?
Revise el árbol de decisión de ruta de migración para decidir qué opción es mejor para su caso de uso. - ¿Cómo sé si debo usar la característica de migración local?
La característica de migración local es mejor para los clientes que quieran migrar a App Service Environment v3 con cambios mínimos en sus configuraciones de red y pueden admitir aproximadamente una hora de tiempo de inactividad de la aplicación. Si no puede admitir tiempo de inactividad, consulte la característica de migración del lado o las opciones de migración manual. La característica de migración local crea la instancia de App Service Environment v3 en la misma subred que el entorno existente y usa la misma infraestructura de red. Es posible que tenga que tener en cuenta los cambios de dirección IP entrante y saliente si tiene dependencias en estas direcciones IP específicas. - ¿Experimentaré tiempo de inactividad durante la migración?
Sí, debe esperar aproximadamente una hora de tiempo de inactividad durante la ventana de servicio de tres horas en el paso de migración, por lo que deberá realizar los planes oportunos. Si tiene un entorno de App Service diferente al que puede apuntar el tráfico mientras migra mediante la característica de migración local, puede eliminar el tiempo de inactividad de la aplicación. Si no tiene otro entorno de App Service y no puede admitir el tiempo de inactividad, consulte la característica de migración en paralelo o las opciones de migración manual. - ¿Tendré que hacer algo con mis aplicaciones después de la migración para que se ejecuten en el entorno nuevo de App Service Environment?
No, todas las aplicaciones que se ejecutan en el entorno anterior se migrarán automáticamente al nuevo entorno y se ejecutarán igual que antes. No se necesita ninguna entrada de usuario. - ¿Qué ocurre si mi entorno de App Service Environment tiene un sufijo de dominio personalizado?
La característica de migración local admite este escenario de migración. - ¿Qué ocurre si mi entorno de App Service Environment está anclado a una zona?
App Service Environment v2 con anclaje de zona es ahora un escenario compatible para la migración usando la característica de migración. App Service Environment v3 no admite el anclaje de zona. Al migrar a App Service Environment v3, puede optar por configurar la redundancia de zona o no. - ¿Qué ocurre si mi App Service Environment tiene direcciones SSL IP? SSL de IP no se admite en App Service Environment v3. Es necesario quitar todos los enlaces SSL de IP antes de migrar mediante la característica de migración o una de las opciones manuales. Si piensa usar la característica de migración local, una vez que quite todos los enlaces SSL de IP, pase esa comprobación de validación y pueda continuar con la migración automatizada.
- ¿Qué propiedades de mi entorno de App Service Environment cambiarán?
Está en un entorno de App Service Environment v3, por lo que debe asegurarse de revisar las características y diferencias en las características en comparación con las versiones anteriores. En el caso de App Service Environment de ILB, conservará la misma dirección IP de ILB. En el caso de App Service Environment accesible desde Internet, la IP pública y la dirección IP de salida cambiarán. Tenga en cuenta que, para App Service Environment de ELB, accesible desde Internet, anteriormente había una única IP tanto de entrada como de salida. En el caso de App Service Environment v3 estas son independientes. Para obtener más información, vea Redes de App Service Environment v3. Para obtener una comparación completa de las versiones de App Service Environment, consulte comparación de versiones de App Service Environment. - ¿Qué ocurre si se produce un error en la migración o hay un problema inesperado durante esta?
Si hay un problema inesperado, los equipos de soporte técnico estarán a su disposición. Debe migrar entornos de desarrollo antes de tocar cualquier entorno de producción para obtener información sobre el proceso de migración y ver cómo afecta a las cargas de trabajo. - ¿Qué ocurre con mi entorno antiguo de App Service Environment?
Si decide migrar un App Service Environment mediante la característica de migración local, el entorno anterior se apaga, elimina y todas las aplicaciones se migran a un nuevo entorno. El entorno antiguo ya no es accesible. No es posible realizar la reversión al entorno anterior. - ¿Qué ocurrirá con mis recursos App Service Environment v1/v2 después del 31 de agosto de 2024?
Después del 31 de agosto de 2024, si no cambia a App Service Environment v3, sus App Service Environment v1/v2s y las aplicaciones implementadas en ellas ya no estarán disponibles. App Service Environment v1/v2 se hospeda en unidades de escalado de App Service que se ejecutan en una arquitectura de Cloud Services (clásica) que se retirará el 31 de agosto de 2024. Por este problema, App Service Environment v1/v2 ya no estará disponible después de esa fecha. Migre a App Service Environment v3 para mantener las aplicaciones en ejecución, o guarde o realice una copia de seguridad de los recursos o datos que necesite mantener.