Compartir a través de


Exportación de flujos de trabajo de ISE a una aplicación lógica estándar

Los flujos de trabajo de aplicaciones lógicas estándar, que se ejecutan en Azure Logic Apps de inquilino único, ofrecen muchas funcionalidades nuevas y mejoradas. Por ejemplo, obtiene el aislamiento de proceso, la integración de red virtual y los puntos de conexión privados, así como el hospedaje de App Service Environment, el desarrollo y la depuración locales mediante Visual Studio Code, la baja latencia con flujos de trabajo sin estado, etc.

Si quiere las ventajas de los flujos de trabajo estándar, pero sus flujos de trabajo se ejecutan en un entorno de servicio de integración (ISE), ahora puede reemplazar el ISE por Azure Logic Apps de inquilino único. Este cambio tiene sentido para la mayoría de los escenarios que requieren algunas funcionalidades de ISE, como el aislamiento y la integración de red, y puede ayudar a reducir los costos de operación.

Ahora puede exportar flujos de trabajo de aplicaciones lógicas desde un ISE a una aplicación lógica estándar. Con Visual Studio Code y la extensión de Azure Logic Apps (Estándar) más reciente, puede exportar las aplicaciones lógicas como flujos de trabajo con estado a un proyecto de aplicación lógica estándar. A continuación, puede actualizar, probar y depurar localmente los flujos de trabajo para prepararlos para la reimplementación. Cuando esté listo, puede implementar directamente desde Visual Studio Code o a través de su propio proceso de DevOps.

Nota:

La funcionalidad de exportación no migra los flujos de trabajo. En su lugar, esta herramienta replica artefactos, como definiciones de flujo de trabajo, conexiones y artefactos de cuenta de integración, entre otros. Los recursos, flujos de trabajo, historial de desencadenador, historial de ejecución y otros datos de la aplicación lógica de origen permanecen intactos.

Puede controlar el proceso de exportación y el recorrido de la migración. Puede probar y validar los flujos de trabajo exportados hasta que esté satisfecho con el entorno de destino. Puede elegir cuándo deshabilitar o eliminar las aplicaciones lógicas de origen.

En este artículo se proporciona información sobre el proceso de exportación y se muestra cómo exportar los flujos de trabajo de la aplicación lógica desde un ISE a un proyecto de aplicación lógica estándar local en Visual Studio Code.

Limitaciones y problemas conocidos

  • La herramienta de exportación no exporta ninguna información de infraestructura o la configuración de la cuenta de integración.

  • La herramienta de exportación puede exportar flujos de trabajo de aplicaciones lógicas con desencadenadores que tienen la configuración de simultaneidad. Sin embargo, Azure Logic Apps de inquilino único omite esta configuración.

  • Las aplicaciones lógicas deben existir en la misma región si desea exportarlas dentro del mismo proyecto de aplicación lógica estándar.

  • De manera predeterminada, las credenciales de conexión no se clonan desde los flujos de trabajo de la aplicación lógica de origen. Para que los flujos de trabajo de la aplicación lógica se puedan ejecutar, tendrá que volver a autenticar estas conexiones después de la exportación.

  • De manera predeterminada, si un conector de Azure tiene una versión del conector integrada, la herramienta de exportación convierte automáticamente el conector de Azure en el conector integrado. No existe ninguna opción para dejar de participar en este comportamiento.

  • Si el id. de conexión tiene un formato incorrecto, se produce un error. Antes de exportar el flujo de trabajo, asegúrese de que los identificadores de conexión de los conectores coincidan con el formato siguiente:

    subscriptionId/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationServiceEnvironments/{integration-service-environment-name}/managedApis/{managed-api-name}

Tipos de operaciones exportables

Operación Tipo JSON
Desencadenador Integrado: Http, HttpWebhook, Recurrence, manual (solicitud)

Administrado: ApiConnection ApiConnectionNotification, ApiConnectionWebhook
Acción Integrado: AppendToArrayVariable, AppendToStringVariable, Compose, DecrementVariable, Foreach, Http, HttpWebhook, If, IncrementVariable, InitializeVariable, JavaScriptCode, Join, ParseJson, Response, Scope, Select, SetVariable, Switch, Table, Terminate, Until, Wait

- Administrado: ApiConnection, ApiConnectionWebhook

Requisitos previos

  • Una o varias aplicaciones lógicas para implementar en la misma suscripción y región de Azure, por ejemplo, Este de EE. UU. 2.

  • Acceso de nivel de suscripción de lector de Azure a la suscripción donde se implementan actualmente las aplicaciones lógicas.

  • Acceso de nivel de grupo de recursos de colaborador de Azure si está seleccionada la opción Implementar conectores administrados.

  • Revise y cumpla los requisitos para configurar Visual Studio Code con la extensión Azure Logic Apps (Estándar).

Nota:

Asegúrese de instalar la versión 2.0.16 o posterior para la extensión Azure Logic Apps (Estándar) para Visual Studio Code. Algunos escenarios de conversión requieren el diseñador de flujo de trabajo más reciente, que está disponible a partir de esta versión.

Agrupación de aplicaciones lógicas para la exportación

Con la extensión Azure Logic Apps (Estándar), puede combinar varios flujos de trabajo de aplicaciones lógicas hospedados por ISE en un único proyecto de aplicación lógica estándar. En Azure Logic Apps de inquilino único, un recurso de aplicación lógica estándar puede tener varios flujos de trabajo. Con este enfoque, puede validar previamente los flujos de trabajo para no perder ninguna dependencia al seleccionar las aplicaciones lógicas para la exportación.

Tenga en cuenta las siguientes recomendaciones al seleccionar las aplicaciones lógicas para la exportación:

  • Agrupe las aplicaciones lógicas en las que los flujos de trabajo comparten los mismos recursos, como artefactos, mapas y esquemas de la cuenta de integración, o use recursos a través de una cadena de procesos.

  • Para la organización y el número de flujos de trabajo por aplicación lógica, revise Procedimientos recomendados y recomendaciones.

Exportación de flujos de trabajo de ISE a un proyecto local

Selección de aplicaciones lógicas para la exportación

  1. En Visual Studio Code, inicie sesión en Azure, si aún no lo ha hecho.

  2. En la barra de actividades de Visual Studio Code, seleccione Azure para abrir la ventana de Azure (Mayús + Alt + A).

    Captura de pantalla que muestra la barra de actividad de Visual Studio Code con el icono de Azure seleccionado.

  3. En la barra de herramientas de la sección Área de trabajo, en el menú Azure Logic Apps, seleccione Exportar aplicación lógica.

    Captura de pantalla que muestra la ventana de Azure, la barra de herramientas de la sección Área de trabajo y la opción Exportar aplicación lógica seleccionada.

  4. Cuando se abra la pestaña Exportar, seleccione la suscripción de Azure y la instancia de ISE y, a continuación, seleccione Siguiente.

    Captura de pantalla en la que se muestra la pestaña Exportar con la suscripción de Azure y la instancia de ISE seleccionadas.

  5. Seleccione las aplicaciones lógicas que se deben exportar. Cada aplicación lógica seleccionada aparece en la lista Aplicaciones lógicas seleccionadas del lateral. Cuando finalice, seleccione Siguiente.

    Sugerencia

    También puede buscar aplicaciones lógicas y aplicar filtros en el grupo de recursos.

    Captura de pantalla en la que se muestra la sección

    La herramienta de exportación comienza a validar si las aplicaciones lógicas seleccionadas son aptas para la exportación.

Revisión de los resultados de validación de la exportación

  1. Una vez completada la validación de la exportación, revise los resultados expandiendo la entrada de cada aplicación lógica.

    • Las aplicaciones lógicas que tienen errores no son válidas para la exportación. Debe quitar estas aplicaciones lógicas de la lista de exportación hasta que las corrija en el origen. Para quitar una aplicación lógica de la lista, seleccione Atrás.

      Por ejemplo, SourceLogicApp2 tiene un error y no se puede exportar hasta que se corrija:

      Captura de pantalla en la que se muestra la sección

    • Las aplicaciones lógicas que superan la validación con o sin advertencias siguen siendo aptas para la exportación. Para continuar, seleccione Exportar si todas las aplicaciones se validan correctamente, o bien seleccione Exportar con advertencias si las aplicaciones tienen advertencias.

      Por ejemplo, SourceLogicApp3 tiene una advertencia, pero aun así puede continuar con la exportación:

      Captura de pantalla en la que se muestra la sección

    En la tabla siguiente se proporciona más información sobre cada icono y estado de validación:

    Icono de validación Estado de validación
    Icono de operación correcta El elemento ha superado la validación, por lo que la exportación puede continuar sin problemas que resolver.
    Icono de error Se ha producido un error en la validación del elemento, por lo que la exportación no puede continuar.

    La entrada de validación del elemento con error aparece expandida automáticamente y proporciona información sobre el error de validación.
    Icono de advertencia El elemento ha superado la validación con una advertencia, pero la exportación puede continuar con la necesidad de realizar la resolución después de la exportación.

    La entrada de validación del elemento con una advertencia aparece expandida automáticamente y proporciona información sobre la advertencia y la corrección necesaria que se debe realizar después de la exportación.
  2. Una vez que aparece la sección Finalizar exportación, en Ubicación de exportación, busque y seleccione una carpeta local para el nuevo proyecto de aplicación lógica estándar.

    Captura de pantalla en la que se muestra la sección

  3. Si el flujo de trabajo tiene conexiones administradas que quiere implementar, lo que solo se recomienda para entornos que no son de producción, seleccione Implementar conexiones administradas, que muestra los grupos de recursos existentes en la suscripción de Azure. Seleccione el grupo de recursos donde quiere implementar las conexiones administradas.

    Captura de pantalla en la que se muestra la sección

  4. En Después de los pasos de exportación, revise los pasos posteriores a la exportación necesarios, por ejemplo:

    Captura de pantalla en la que se muestra la sección “Después de los pasos de exportación” y los pasos posteriores a la exportación necesarios, si los hay.

  5. En función de su escenario, seleccione Exportar y finalizar o Exportar con advertencias y finalizar.

    La herramienta de exportación descarga el proyecto en la ubicación de la carpeta seleccionada, expande el proyecto en Visual Studio Code e implementa las conexiones administradas, si ha seleccionado esa opción.

    Captura de pantalla en la que se muestra la sección

  6. Una vez completado este proceso, Visual Studio Code abre una nueva área de trabajo. Ahora puede cerrar la ventana de exportación con seguridad.

  7. En el proyecto de aplicación lógica estándar, abra y revise el archivo README.md para conocer los pasos posteriores a la exportación necesarios.

    Captura de pantalla en la que se muestra un nuevo proyecto de aplicación lógica estándar con el archivo README.md abierto.

Pasos posteriores a la exportación

Pasos para la corrección

Algunos flujos de trabajo de aplicaciones lógicas exportadas requieren la ejecución de pasos de corrección posteriores a la exportación en la plataforma Estándar.

  1. En el proyecto de aplicación lógica estándar, abra el archivo README.md y revise los pasos de corrección de los flujos de trabajo exportados. La herramienta de exportación genera el archivo README.md, que contiene todos los pasos posteriores a la exportación necesarios.

  2. Antes de realizar cambios en el flujo de trabajo de la aplicación lógica de origen, asegúrese de probar el nuevo recurso y los flujos de trabajo de la aplicación lógica estándar.

Configuración y acciones de la cuenta de integración

Si exporta acciones que dependen de una cuenta de integración, debe configurar manualmente la aplicación lógica estándar con un vínculo de referencia a la cuenta de integración que contiene los artefactos necesarios. Para obtener más información, consulte Vinculación de la cuenta de integración a una aplicación lógica estándar.

Si tiene una cuenta de integración Estándar que se crea desde dentro de un ISE, puede exportar esa cuenta de integración a una cuenta de integración Premium existente.

Acciones y configuraciones de Batch

Si exporta acciones que usan acciones de Batch con varias configuraciones almacenadas en una cuenta de integración, debe configurar manualmente las acciones de Batch con los valores correctos después de la exportación. Para más información, consulte Envío, recepción y procesamiento por lotes de mensajes en Azure Logic Apps.

Estructura de carpetas del proyecto

Una vez finalizado el proceso de exportación, el proyecto de aplicación lógica estándar contiene nuevas carpetas y archivos junto con la mayoría del resto de elementos de un proyecto de aplicación lógica estándar típico.

En la tabla siguiente se describen estas nuevas carpetas y archivos que ha agregado el proceso de exportación:

Carpeta Archivo Descripción
.development\deployment LogicAppStandardConnections.parameters.json Archivo de parámetros de plantilla de Azure Resource Manager para implementar conectores administrados
LogicAppStandardConnections.template.json Definición de plantilla de Azure Resource Manager para implementar conectores administrados
LogicAppStandardInfrastructure.parameters.json Archivo de parámetros de plantilla de Azure Resource Manager para implementar un recurso de aplicación lógica estándar
LogicAppStandardInfrastructure.template.json Definición de plantilla de Azure Resource Manager para implementar un recurso de aplicación lógica estándar
.logs\export exportReport.json Archivo sin formato de resumen del informe de exportación, que incluye todos los pasos necesarios para la corrección posterior a la exportación
exportValidation.json Archivo sin formato del informe de validación, que incluye los resultados de la validación de cada aplicación lógica exportada.
README.md Archivo Markdown con un resumen de los resultados de la exportación, incluidas las aplicaciones lógicas creadas y todos los pasos siguientes necesarios.

Pasos siguientes