Compartir vía

Migración de una instancia de API Management que no es de red virtual a la plataforma de proceso stv2

  • Artículo

SE APLICA A: Desarrollador | Básico | Estándar | Premium

En este artículo se proporcionan pasos para migrar una instancia de API Management hospedada en la plataforma de proceso local stv1 a la plataforma stv2 cuando la instancia no se inserta (implementada) en una red virtual externa o interna. En este escenario, migre la instancia mediante Azure Portal o la API REST Migración a stv2. Averigüe si necesita hacerlo.

Si necesita migrar una instancia de API Management insertada con red virtual hospedada en la plataforma stv1, consulte Migración de una instancia de API Management insertada con red virtual a la plataforma stv2.

Importante

Se está retirando la compatibilidad con las instancias de API Management hospedadas en la plataforma stv1. En Azure global, la fecha de retirada es el 31 de agosto de 2024. En Azure Government y en Azure operado por 21Vianet (Azure en China), la fecha de retirada es el 24 de febrero de 2025. Si tiene instancias hospedadas en la plataforma stv1, mígrelas a la plataforma stv2 antes de la fecha de retirada para evitar interrupciones del servicio.

Precaución

  • La migración de la instancia de API Management a una nueva infraestructura es una operación de larga duración.
  • En función del proceso de migración, es posible que haya un tiempo de inactividad temporal durante la migración y es posible que tenga que actualizar las dependencias de red después de la migración para llegar a la instancia de API Management. Planifique su migración en consecuencia.
  • La migración a stv2 no es reversible.

¿Qué ocurre durante la migración?

La migración de la plataforma de API Management desde stv1 a stv2 implica actualizar solo el proceso subyacente y no tiene ningún impacto en la configuración del servicio o api persistente en la capa de almacenamiento. Para una instancia que no está implementada en una red virtual:

  • Puede elegir si la dirección IP virtual de la instancia cambiará o si se conserva la dirección IP virtual original.
  • El proceso de actualización implica la creación de un nuevo proceso en paralelo al proceso anterior.
  • El estado de API Management en el portal será Actualizando.
  • Si decide conservar la dirección IP virtual, la migración incluye un paso adicional para mover la dirección IP virtual del proceso anterior al nuevo proceso durante el cual las API no responderán.
  • Azure administra el DNS del punto de conexión de administración y actualiza el nuevo proceso inmediatamente después de la migración correcta.
  • La puerta de enlace predeterminada y el DNS del portal apuntan al nuevo proceso inmediatamente.
  • Si decide que la instancia de API Management reciba una nueva dirección IP virtual, deberá actualizar las dependencias de red para usar la nueva dirección IP virtual.

Requisitos previos

Migración de la instancia a la plataforma stv2

Opciones de dirección IP pública

Puede elegir si la dirección IP virtual de API Management cambiará o si se conserva la dirección IP virtual original.

  • Nueva dirección IP virtual: si elige este modo, las solicitudes de API siguen respondiendo durante la migración. La configuración de infraestructura (como dominios personalizados, ubicaciones y certificados de CA) se bloqueará durante 30 minutos. Después de la migración, deberá actualizar las dependencias de red, como DNS, reglas de firewall y redes virtuales para usar la nueva dirección IP virtual.

  • Conservar la dirección IP: si conserva la dirección IP virtual, las solicitudes de API no responderán durante aproximadamente 15 minutos mientras la dirección IP se migre a la nueva infraestructura. La configuración de infraestructura (como dominios personalizados, ubicaciones y certificados de CA) se bloqueará durante 45 minutos. No se requiere ninguna otra configuración después de la migración.

Dirección IP precreada para la migración

En el caso de las instancias de API Management a las que se puede acceder mediante una dirección IP pública, API Management crea previamente una dirección IP pública para el proceso de migración. Busque la dirección IP precreada en la salida JSON de las propiedades de la instancia de API Management. En customProperties, la dirección IP precreada es el valor de la propiedad Microsoft.WindowsAzure.ApiManagement.Stv2MigrationPreCreatedIps. Para una implementación de varias regiones, el valor es una lista separada por comas de direcciones IP precreadas.

Use la dirección IP precreada (o direcciones) para ayudarle a administrar el proceso de migración:

  • Al migrar y conservar la dirección VIP, la dirección IP precreada se asigna temporalmente a la nueva implementación de stv2, antes de asignar la dirección IP original a la implementación de stv2. Si tiene reglas de firewall que limitan el acceso a la instancia de API Management, por ejemplo, puede agregar la dirección IP precreada a la lista de permitidos para conservar la continuidad del acceso de cliente durante la migración. Una vez completada la migración, puede quitar la dirección IP precreada de la lista de permitidos.
  • Al migrar y generar una nueva dirección VIP, la dirección IP precreada se asigna a la nueva implementación de stv2 durante la migración y se conserva una vez completada la migración. Use la dirección IP precreada para actualizar las dependencias de red, como DNS y reglas de firewall, para apuntar a la nueva dirección IP.

Pasos de migración

  1. Vaya a la instancia de API Management en Azure Portal.

  2. En el menú izquierdo, en Configuración, seleccione Migración de plataforma.

  3. En la página Migración de plataforma, seleccione una de las dos opciones de migración:

    • Nueva dirección IP virtual La dirección IP virtual de la instancia de API Management cambiará automáticamente. El servicio no tendrá tiempo de inactividad, pero después de la migración tendrá que actualizar las dependencias de red, como DNS, reglas de firewall y redes virtuales para usar la nueva dirección VIP.

    • Conservar la dirección IP: la dirección IP virtual de la instancia de API Management no cambiará. La instancia tendrá un tiempo de inactividad de hasta 15 minutos.

      Captura de pantalla de la migración de la plataforma de API Management en el portal

  4. Revise las instrucciones para el proceso de migración y prepare su entorno.

  5. Una vez completados los pasos de preparación, seleccione He leído y comprendido el impacto del proceso de migración. Seleccione Migrar.

Comprobación de la migración

Para comprobar que la migración se realizó correctamente, cuando el estado cambie a En línea, compruebe la versión de la plataforma de la instancia de API Management. Después de una migración correcta, el valor es stv2 o stv2.1.

Revertir automáticamente si se produce un error en la migración

Si se produce un error durante el proceso de migración, la instancia revertirá automáticamente a la plataforma stv1. Si la migración se completa correctamente (la versión de la plataforma de la instancia se muestra como stv2 o stv2.1 y el estado como En línea), no se puede revertir a la stv1 plataforma.

Para obtener ayuda si se produce un error en la migración, póngase en contacto con Soporte técnico de Azure.

Si necesita la capacidad de revertir manualmente, la recomendación es implementar una nueva instancia de stv2 en paralelo con la instancia original de API Management.

Actualización de las dependencias de red

Después de la migración se realiza correctamente a una nueva dirección de IP virtual, actualice las dependencias de red, como el DNS, las reglas de firewall y las redes virtuales, para usar el nuevo espacio de direcciones VIP o subred.

Ayuda y soporte técnico

Estamos aquí para ayudarle a migrar a la stv2 plataforma con interrupciones mínimas en los servicios.

Si tiene alguna pregunta, obtenga respuestas de expertos de la comunidad en Microsoft Q&A. Si tiene un plan de soporte técnico y necesita ayuda técnica, cree una solicitud de soporte técnico.

  1. En Resumen, escriba una descripción del problema, por ejemplo, "retirada de stv1".
  2. En Tipo de problema, seleccione Técnico.
  3. En Suscripción, seleccione la suscripción.
  4. En Servicio, seleccione Mis servicios y, a continuación, seleccione Servicio API Management.
  5. En Recurso, seleccione el recurso de Azure para el que va a crear una solicitud de soporte técnico.
  6. En Tipo de problema, seleccione Administración y supervisión.
  7. En Subtipo de problema, seleccione Actualizar, escalar o cambios de SKU.

Preguntas más frecuentes

  • ¿Qué información necesitamos para elegir una ruta de migración?

    • ¿Cuál es el modo de red de la instancia de API Management?
    • ¿Están configurados los dominios personalizados?
    • ¿Está implicado un firewall?
    • ¿Hay dependencias conocidas tomadas por ascendentes o descendentes en las direcciones IP implicadas?
    • ¿Es una implementación de varias regiones?
    • ¿Se puede modificar la instancia existente o se requiere una configuración paralela?
    • ¿Puede haber tiempo de inactividad?
    • ¿Se puede realizar la migración en horas no comerciales?

  • ¿Cuáles son los requisitos previos para la migración?

    En el caso de las instancias que no son insertadas en la red virtual, no se requieren requisitos previos. Si migra la conservación de la dirección IP pública, esto hará que la instancia de API Management deje de responder durante aproximadamente 15 minutos. Es posible que no haya un tiempo de inactividad si elige la opción Nueva dirección IP virtual que hace que API Management esté disponible en una nueva dirección IP. Las instancias configuradas con un dominio personalizado mediante un registro A o tener dependencias de red en la dirección IP virtual pública tendrán un tiempo de inactividad cuando se solicite una nueva dirección IP virtual.

  • ¿La migración provocará un tiempo de inactividad?

    En el caso de las instancias no insertadas en la red virtual, solo hay un tiempo de inactividad de aproximadamente 15 minutos si decide conservar la dirección IP original. Sin embargo, no hay tiempo de inactividad si migra con una nueva dirección IP y no tiene dependencias de red en la nueva dirección IP. Las dependencias de red incluyen un nombre de dominio personalizado sin un CNAME, una lista de direcciones IP permitidas, reglas de firewall y redes virtuales.

  • ¿Puede que se produzcan pérdidas de datos o de configuración durante la migración?

    stv1 para la migración de stv2 implica actualizar la plataforma de proceso solo y no se cambia la capa de almacenamiento interna. Por lo tanto, toda la configuración es segura durante el proceso de migración. Esto incluye la identidad administrada asignada por el sistema, que si está habilitada, se conserva.

  • ¿Cómo confirmar que la migración se ha completado y realizado correctamente?

    La migración se considera completa y correcta cuando el estado de la página de información general aparece como En línea junto con la versión de la plataforma que es stv2 o stv2.1. Compruebe también que el estado de red de la hoja de red aparece en verde para toda la conectividad necesaria.

  • ¿Puedo realizar la migración mediante el portal?

    Sí, la hoja Migración de plataforma en Azure Portal le guía por las opciones de las instancias insertadas que no son de red virtual.

  • ¿Puedo conservar la dirección IP de la instancia?

    Sí, se puede conservar la dirección IP, pero habrá un tiempo de inactividad de aproximadamente 15 minutos.

  • ¿Hay una ruta de migración sin modificar la instancia existente?

    Sí, necesita una migración en paralelo. Esto significa crear una nueva instancia de API Management en paralelo con la instancia actual y copiar la configuración en la nueva instancia.

  • ¿Qué ocurre si la migración falla?

    Si la instancia de API Management no muestra la versión de la plataforma como stv2 o stv2.1 y el estado como En línea después de iniciar la migración, es probable que se produzca un error. El servicio se revierte automáticamente a la instancia anterior y no se realizan cambios. Si tiene problemas (por ejemplo, si el estado es Actualizando durante más de 2 horas), póngase en contacto con Soporte técnico de Azure.

  • ¿Qué funcionalidad no está disponible durante la migración?

    Para las instancias que no son de red virtual insertadas:

    • Si optó por conservar la dirección IP original: las solicitudes de API no responden durante aproximadamente 15 minutos mientras la dirección IP se migra a la nueva infraestructura. La configuración de infraestructura (como dominios personalizados, ubicaciones y certificados de CA) se bloquea durante 45 minutos.
    • Si optó por migrar a una nueva dirección IP: las solicitudes de API siguen respondiendo durante la migración. La configuración de infraestructura (como dominios personalizados, ubicaciones y certificados de CA) se bloquea durante 30 minutos. Después de la migración, deberá actualizar las dependencias de red, como DNS, reglas de firewall y redes virtuales para usar la nueva dirección IP virtual.

  • ¿Cuánto tiempo durará la migración?

    La duración esperada para toda la migración es de aproximadamente 45 minutos. El indicador para comprobar si la migración ya se ha realizado es comprobar si el estado de la instancia vuelve a En línea y no a Actualizando. Si indica Actualizando durante más de 2 horas, póngase en contacto con Soporte técnico de Azure.

  • ¿Puedo revertir la migración si es necesario?

    Si se produce un error durante el proceso de migración, la instancia se revertirá automáticamente a la plataforma stv1. Sin embargo, después de que el servicio se migre correctamente, no se puede revertir a la plataforma stv1.

  • ¿Se requiere algún cambio en las zonas DNS privadas o de dominios personalizados?

    En el caso de las instancias no insertadas de red virtual, no se requieren cambios si se conserva la dirección IP. Si opta por una nueva dirección IP, se deben actualizar los dominios personalizados que hacen referencia a la dirección IP.

  • Mi instancia de stv1 se implementa en varias regiones de Azure (varias regiones). ¿Cómo puedo actualizar a stv2?

    Para una API Management que no se inserte en una red virtual, siga los pasos de migración mediante el portal o la CLI de Azure. Todas las regiones se migrarán a stv2.

  • ¿Qué debemos tener en cuenta para las puertas de enlace autohospedadas?

    No es necesario hacer nada en las puertas de enlace autohospedadas. Solo tiene que migrar las instancias de API Management que se ejecutan en Azure que se ven afectadas por la retirada de la plataforma stv1. Tenga en cuenta que podría haber una nueva dirección IP para el punto de conexión de configuración de la instancia de API Management y se deben actualizar las restricciones de red ancladas a la dirección IP.

  • ¿Cómo se ve afectado el portal para desarrolladores por la migración?

    No hay ningún impacto en el portal para desarrolladores. Si se usan dominios personalizados, el registro DNS debe actualizarse con la dirección IP efectiva, después de la migración. Sin embargo, si los dominios predeterminados están en uso, se actualizan automáticamente en la migración correcta. No hay tiempo de inactividad para el portal para desarrolladores durante la migración.

  • ¿Hay algún impacto en el costo una vez que migramos a stv2?

    El modelo de facturación sigue siendo el mismo para stv2 y no se incurrirá en ningún costo más después de la migración.

  • ¿Qué permisos de RBAC son necesarios para la migración de stv1 a stv2?

    El usuario o proceso que realiza la migración necesita acceso de escritura a la instancia de API Management.

Contenido relacionado