Edición de la configuración de host y aplicación para las aplicaciones lógicas estándar en Azure Logic Apps de inquilino único

Se aplica a: Azure Logic Apps (estándar)

En Azure Logic Apps de inquilino único, la configuración de aplicación de una aplicación lógica Estándar especifica las opciones de configuración global que afectan a todos los flujos de trabajo de esa aplicación lógica. Sin embargo, esta configuración solo se aplica cuando estos flujos de trabajo se ejecutan en el entorno de desarrollo local. Los flujos de trabajo que se ejecutan localmente pueden acceder a esta configuración de aplicación como variables de entorno local, usadas por las herramientas de desarrollo local para los valores que a menudo pueden cambiar entre entornos. Por ejemplo, estos valores pueden incluir cadenas de conexión. Al implementar en Azure, la configuración de aplicación se omite y no se incluye con la implementación.

La aplicación lógica también tiene la configuración de host, que especifica los valores y la configuración del entorno de ejecución que se aplican a todos los flujos de trabajo de esa aplicación lógica, por ejemplo, los valores predeterminados para el rendimiento, la capacidad, el tamaño de los datos, entre otros, tanto si se ejecutan localmente como en Azure.

Configuración de aplicación, parámetros e implementación

En Azure Logic Apps multiinquilino, la implementación depende de las plantillas de Azure Resource Manager (plantillas de ARM), que combinan y controlan el aprovisionamiento de recursos para las aplicaciones lógicas y la infraestructura. Este diseño supone un desafío cuando tiene que mantener variables de entorno para aplicaciones lógicas en varios entornos de desarrollo, pruebas y producción. Todo lo que hay en una plantilla de ARM se define en la implementación. Si necesita cambiar solo una variable, tendrá que volver a implementarlo todo.

En Azure Logic Apps de inquilino único, la implementación es más fácil porque puede separar el aprovisionamiento de recursos entre las aplicaciones y la infraestructura. Puede usar parámetros para abstraer los valores que pueden cambiar entre entornos. Al definir los parámetros que se usarán en los flujos de trabajo, primero puede centrarse en el diseño de los flujos de trabajo y, a continuación, insertar las variables específicas del entorno más adelante. Puede llamar a las variables de entorno de ejecución y hacer referencia a estas mediante la configuración y los parámetros de la aplicación. De este modo, no tiene que volver a implementar con tanta frecuencia.

La configuración de aplicación se integra con Azure Key Vault. Puede hacer referencia directamente a cadenas seguras, como claves y cadenas de conexión. De forma similar a las plantillas de Azure Resource Manager (plantillas de ARM), donde puede definir variables de entorno en el momento de la implementación, puede definir la configuración de aplicación dentro de la definición de flujo de trabajo de la aplicación lógica. A continuación, puede capturar valores de infraestructura generados dinámicamente, como puntos de conexión, cadenas de almacenamiento, etc. Sin embargo, la configuración de aplicación tiene limitaciones de tamaño y no se puede hacer referencia a ella desde determinadas áreas de Azure Logic Apps.

Para obtener más información sobre cómo configurar las aplicaciones lógicas para la implementación, consulte la siguiente documentación:

• Creación de parámetros para los valores que cambian en los flujos de trabajo entre entornos de Azure Logic Apps de inquilino único
• Introducción a la implementación de DevOps para aplicaciones lógicas basadas en inquilino único
• Configuración de la implementación de DevOps para aplicaciones lógicas basadas en inquilino único

Estructura del proyecto de Visual Studio Code

En Visual Studio Code, el proyecto de aplicación lógica tiene uno de los siguientes tipos:

• Basado en paquete de extensiones (Node.js), que es el tipo predeterminado.
• Basado en paquetes NuGet (.NET), que se puede convertir desde el tipo predeterminado.

En función de estos tipos, el proyecto incluye carpetas y archivos ligeramente diferentes. Un proyecto basado en NuGet incluye una carpeta .bin que contiene paquetes y otros archivos de biblioteca. Un proyecto basado en paquetes no incluye la carpeta .bin ni otros archivos. Algunos escenarios requieren un proyecto basado en NuGet para que la aplicación se ejecute, por ejemplo, si quiere desarrollar y ejecutar operaciones integradas personalizadas. Para obtener más información sobre cómo convertir el proyecto para que use NuGet, consulte Habilitación de la creación de conectores integrados.

Para el proyecto basado en paquetes predeterminado, el proyecto tiene una estructura de carpetas y archivos similar a la del ejemplo siguiente:

MyBundleBasedLogicAppProjectName
| .vscode
| Artifacts
  || Maps 
     ||| MapName1
     ||| ...
  || Schemas
     ||| SchemaName1
     ||| ...
| WorkflowName1
  || workflow.json
  || ...
| WorkflowName2
  || workflow.json
  || ...
| workflow-designtime
| .funcignore
| connections.json
| host.json
| local.settings.json

En el nivel raíz del proyecto, puede encontrar los siguientes archivos y carpetas con otros elementos:

Referencia de la configuración de aplicación: local.settings.json

En Visual Studio Code, en el nivel de raíz del proyecto de aplicación lógica, el archivo local.settings.json contiene opciones de configuración global que afectan a todos los flujos de trabajo de esa aplicación lógica mientras se ejecuta en el entorno de desarrollo local. Cuando los flujos de trabajo se ejecutan localmente, se accede a esta configuración como variables de entorno local, y sus valores a menudo pueden cambiar entre los distintos entornos donde se ejecutan los flujos de trabajo. Para ver y administrar esta configuración, consulte Administración de la configuración de aplicación: local.settings.json.

La configuración de aplicación de Azure Logic Apps funciona de forma similar a la configuración de aplicación de Azure Functions o Azure Web Apps. Si ha usado estos otros servicios antes, es posible que ya esté familiarizado con la configuración de aplicación. Para obtener más información, consulte Referencia de configuración de aplicación de Azure Functions y Uso de Azure Functions Core Tools: archivo de configuración local.

Para que el flujo de trabajo se ejecute correctamente, se requieren algunas opciones de configuración de la aplicación.

Administración de la configuración de aplicación: local.settings.json

Para agregar, actualizar o eliminar la configuración de la aplicación, seleccione y revise las secciones siguientes para Azure Portal, Visual Studio Code, la CLI de Azure o la plantilla de ARM (Bicep). Para ver la configuración de aplicación específica de las aplicaciones lógicas, revise la guía de referencia de la configuración de aplicación disponible: local.settings.json.

az logicapp config appsettings list --name MyLogicApp --resource-group MyResourceGroup

az logicapp config appsettings set --name MyLogicApp --resource-group MyResourceGroup --settings CUSTOM_LOGIC_APP_SETTING=12345 

Referencia de la configuración de host: host.json

En Visual Studio Code, en el nivel de raíz del proyecto de aplicación lógica, el archivo de metadatos host.json contiene la configuración del entorno de ejecución y los valores predeterminados que se aplican a todos los flujos de trabajo de un recurso de aplicación lógica, ya sea que se ejecuten localmente o en Azure. Para ver y administrar esta configuración, consulte Administración de la configuración de host: host.json. También puede encontrar información relacionada sobre los límites en la documentación Límites y configuración de Azure Logic Apps.

Rendimiento de la orquestación de trabajos

Esta configuración afecta al rendimiento y la capacidad de Azure Logic Apps de inquilino único para ejecutar operaciones de flujo de trabajo.

Los siguientes valores se usan para detener de forma manual y eliminar inmediatamente los flujos de trabajo especificados en la aplicación lógica estándar.

En el ejemplo siguiente se muestra la sintaxis de estos valores en los que cada identificador de flujo de trabajo va seguido de dos puntos (:) y separados por un punto y coma (;):

"Jobs.CleanupJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2:",
"Jobs.SuspendedJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2>:"

Desencadenadores basados en periodicidad

Simultaneidad de desencadenadores

La siguiente configuración solo funciona para los flujos de trabajo que comienzan con un desencadenador basado en periodicidad para conectores integrados basados en proveedores de servicios. En el caso de un flujo de trabajo que comienza con un desencadenador basado en funciones, puede intentar configurar el procesamiento por lotes donde se admita. Sin embargo, el procesamiento por lotes no siempre es la solución correcta. Por ejemplo, con los desencadenadores de Azure Service Bus, un lote podría mantener los mensajes más allá de la duración del bloqueo. Como resultado, cualquier acción, como completar o abandonar, produce un error en dichos mensajes.

Retención del historial y duración de ejecución

Ejecutar acciones

Entradas y salidas

Paginación

Fragmentación

Almacenamiento de contenido en línea o uso de blobs

Bucles Para cada uno

Bucles Until

variables

Operaciones HTTP integradas

Operaciones de webhook HTTP integradas

Operaciones de Azure Storage integradas

Blob Storage

Table Storage y Queue Storage

Recurso compartido de archivos

Operaciones de Azure Functions integradas

Operaciones de Azure Service Bus integradas

Operaciones SFTP integradas

Operaciones de conectores administrados

Directiva de reintentos para todas las demás operaciones

Limitaciones

• Tamaño máximo de contenido

  De manera predeterminada, los desencadenadores integrados, como HTTP o Solicitud, se limitan al tamaño del mensaje descrito en Limits and configuration reference - Messages (Referencia de configuración y límites: mensajes). Para manipular archivos mayores que el límite, pruebe a cargar el contenido como un blob en Azure Blob Storage y, a continuación, obtenga el contenido mediante el conector de Azure Blob.

Administración de la configuración de host: host.json

Puede agregar, actualizar o eliminar la configuración de host, que especifica los valores y la configuración del entorno de ejecución que se aplican a todos los flujos de trabajo de esa aplicación lógica, por ejemplo, los valores predeterminados para el rendimiento, la capacidad, el tamaño de los datos, entre otros, tanto si se ejecutan localmente como en Azure. Para la configuración de host específica de las aplicaciones lógicas, revise la guía de referencia de la configuración de implementación y de entorno de ejecución disponible: host.json.

Azure Portal: host.json

Para revisar la configuración de host de la aplicación lógica basada en inquilino único en Azure Portal, siga estos pasos:

1. En el cuadro de búsqueda de Azure Portal, busque y abra la aplicación lógica.

2. En el menú de la aplicación lógica, en Herramientas de desarrollo, seleccione Herramientas avanzadas.

3. En la página Herramientas avanzadas, seleccione Ir, que abre el entorno de Kudu para la aplicación lógica.

4. En la barra de herramientas de Kudu, abra el menú Consola de depuración y seleccione CMD.

5. Detenga la aplicación lógica en Azure Portal.

   1. En el menú de la aplicación lógica, seleccione Introducción.

   2. En la barra de herramientas del panel Información general, seleccione Detener.

6. En el menú de la aplicación lógica, en Herramientas de desarrollo, seleccione Herramientas avanzadas.

7. En el panel Herramientas avanzadas, seleccione Ir, que abre el entorno de Kudu para la aplicación lógica.

8. En la barra de herramientas de Kudu, abra el menú Consola de depuración y seleccione CMD.

   Se abre una ventana de consola, por lo que puede desplazarse a la carpeta wwwroot mediante el símbolo del sistema. O bien, puede examinar la estructura de directorios que aparece encima de la ventana de la consola.

9. Examine la siguiente ruta de acceso a la carpeta wwwroot: ...\home\site\wwwroot.

10. Encima de la ventana de la consola, en la tabla de directorios, junto al archivo host.json, seleccione Editar.

11. Una vez abierto el archivo host.json, revise los valores de configuración de host que se hayan agregado anteriormente para la aplicación lógica.

    Para obtener más información sobre la configuración de host, revise la guía de referencia de la configuración de host disponible: host.json.

Para agregar una configuración, siga estos pasos:

1. Antes de agregar o editar la configuración, detenga la aplicación lógica en Azure Portal.

   1. En el menú de la aplicación lógica, seleccione Introducción.
   2. En la barra de herramientas del panel Información general, seleccione Detener.

2. Vuelva al archivo host.json. En el objeto extensionBundle, agregue el objeto extensions, que incluye los objetos workflow y settings, por ejemplo:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

3. En el objeto settings, agregue una lista plana con la configuración de host que desea usar para todos los flujos de trabajo de la aplicación lógica, tanto si esos flujos de trabajo se ejecutan localmente como en Azure, por ejemplo:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

4. Cuando haya terminado, recuerde seleccionar la opción Guardar.

5. Ahora, reinicie la aplicación lógica. Vuelva a la página Información general de la aplicación lógica y seleccione Reiniciar.

Visual Studio Code: host.json

Para revisar la configuración de host de la aplicación lógica en Visual Studio Code, siga estos pasos:

1. En el proyecto de aplicación lógica, en el nivel de raíz del proyecto, busque y abra el archivo host.json.

2. En el objeto extensions, en workflows y settings, revise los valores de configuración de host que se hayan agregado anteriormente para la aplicación lógica. De lo contrario, el objeto extensions no aparecerá en el archivo.

   Para obtener más información sobre la configuración de host, revise la guía de referencia de la configuración de host disponible: host.json.

Para agregar una configuración de host, siga estos pasos:

1. En el archivo host.json, en el objeto extensionBundle, agregue el objeto extensions, que incluye los objetos workflow y settings, por ejemplo:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

2. En el objeto settings, agregue una lista plana con la configuración de host que desea usar para todos los flujos de trabajo de la aplicación lógica, tanto si esos flujos de trabajo se ejecutan localmente como en Azure, por ejemplo:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

Pasos siguientes

• Creación de parámetros para los valores que cambian en los flujos de trabajo entre entornos de Azure Logic Apps de inquilino único
• Configuración de la implementación de DevOps para Azure Logic Apps de inquilino único