Creación de los parámetros entre entornos que se usarán para las entradas de flujo de trabajo de Azure Logic Apps

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

En Azure Logic Apps, puede abstraer los valores que pueden cambiar en los flujos de trabajo en los entornos de desarrollo, prueba y producción definiendo parámetros. Al usar parámetros en lugar de variables de entorno específico, inicialmente puede centrarse más en el diseño de los flujos de trabajo e insertar las variables de entorno específico más adelante.

En este artículo se explica cómo crear, usar y editar parámetros para flujos de trabajo de aplicaciones lógicas de consumo multiinquilino y para flujos de trabajo de aplicaciones lógicas estándar de un solo inquilino. También aprenderá a administrar variables de entorno.

Para más información sobre el entorno multiinquilino frente al de inquilino único de Azure Logic Apps, consulte Inquilino único frente a multiinquilino y entorno del servicio de integración para Azure Logic Apps.

Requisitos previos

• Una cuenta y una suscripción de Azure. Si aún no tiene una, regístrese para obtener una cuenta de Azure gratuita.

• Un flujo de trabajo de aplicación lógica de consumo o estándar

  Si aún no tiene un flujo de trabajo de aplicación lógica, consulte Creación de un ejemplo de flujo de trabajo de aplicación lógica de Consumo mediante Azure Portal o Creación de un ejemplo de flujo de trabajo de aplicación lógica del plan Estándar mediante Azure Portal.

  Nota:

  Actualmente, solo puede crear parámetros para flujos de trabajo de aplicación lógica de consumo mediante Azure Portal. Solo puede crear parámetros para flujos de trabajo de aplicación lógica estándar mediante Azure Portal o Visual Studio Code.

Parámetros para flujos de trabajo de aplicaciones lógicas de consumo frente a estándar

Para los flujos de trabajo de aplicación lógica de consumo y estándar, puede definir parámetros mediante el diseñador. Después de definir el parámetro, puede hacer referencia al mismo desde cualquier flujo de trabajo o conexión que se encuentre en el mismo recurso de aplicación lógica.

En flujos de trabajo de aplicación lógica de consumo multiinquilino, después de crear y usar parámetros en el diseñador, se deben definir y establecer las variables de entorno en la plantilla de Resource Manager (plantilla de ARM) y en los archivos de parámetros de plantilla. En este escenario, tendrá que definir y establecer los parámetros en la implementación lo que significa que, aunque solo tenga que cambiar una variable, tendrá que volver a implementar la plantilla de ARM de la aplicación lógica.

En flujos de trabajo de aplicaciones lógicas estándar de un solo inquilino, puede trabajar con variables de entorno tanto en tiempo de ejecución como en la implementación mediante parámetros and en la configuración de la aplicación. La configuración de la aplicación contiene opciones de configuración globales para todos los flujos de trabajo de el mismo recurso de aplicación lógica. Para obtener más información, consulte Edición de la configuración de host y aplicación para aplicaciones lógicas basadas en un solo inquilino.

Nota:

En los flujos de trabajo de la aplicación lógica estándar, no se admiten los tipos de datos seguros, como securestring y secureobject. Sin embargo, como opción alternativa, puede usar la configuración de la aplicación con Azure Key Vault. De ese modo, puede hacer referencia directamente a cadenas seguras, como claves y cadenas de conexión. De forma similar a las plantillas de ARM, donde puede definir variables de entorno en el momento de la implementación, puede definir la configuración de la 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.

Pero la configuración de la aplicación tiene límites de tamaño y no se puede hacer referencia a ella desde determinadas áreas de Azure Logic Apps. Los parámetros ofrecen una gama más amplia de casos de uso que la configuración de la aplicación, como la compatibilidad con tamaños grandes del valor y objetos complejos.

Por ejemplo, si usa Visual Studio Code como herramienta de desarrollo local para ejecutar flujos de trabajo localmente, en el proyecto de aplicación lógica, puede definir parámetros mediante el archivo parameters.json. Después, puede hacer referencia a cualquier parámetro de este archivo de parámetros desde cualquier flujo de trabajo del archivo workflow.json del proyecto o desde cualquier objeto de conexión en el archivo connections.json del proyecto. En la lista siguiente se describen algunos casos de uso comunes:

• Tener un archivo de parámetros de prueba que incluya todos los valores que se usan durante las pruebas. Durante la implementación, puede reemplazar el archivo de parámetros de prueba por el archivo de parámetros de producción.

• Parametrizar distintas partes del archivo connections.json. A continuación, puede comprobar el archivo connections.json en el control de código fuente y, después, administrar todas las conexiones mediante el archivo parameters.json.

• Parametrizar objetos complejos, como el objeto JSON authentication. Por ejemplo, puede reemplazar el valor del objeto authentication por una cadena que contenga una expresión de parámetros única, como @parameters('api-auth').

• Revisar y editar la configuración de la aplicación en el archivo local.settings.json del proyecto. A continuación, puede hacer referencia a esta configuración de la aplicación en los parámetros.

Nota

Como recomendación general, considere la posibilidad de usar parámetros, y no la configuración de la aplicación, como la manera predeterminada de parametrizar los valores. De este modo, cuando necesite almacenar claves o cadenas seguras, puede seguir la recomendación para hacer referencia a la configuración de la aplicación a partir de los parámetros. Si quiere, puede usar ambas opciones en la solución mediante parámetros para hacer referencia a la configuración de la aplicación.

Definición, uso y edición de parámetros

Consumo

Azure portal

1. En Azure Portal, abra el flujo de trabajo de aplicación lógica. En Flujos de trabajo, seleccione y abra el flujo de trabajo en el diseñador.

2. En la barra de herramientas del diseñador, seleccione Parámetros.

   

3. En el panel Parámetros seleccione Añadir parámetro.

4. Proporcione la información siguiente sobre el parámetro que se creará:

   Propiedad	Obligatorio	Descripción
   Nombre	Sí	Nombre del parámetro que se va a crear.
   Tipo	Sí	Tipo de datos del parámetro, como Array, Bool, Float, Int, Object, Secure Object, Secure String, and String.
   Valor predeterminado	Sí	Valor predeterminado del parámetro. Debe especificar el valor del parámetro predeterminado porque la lógica de flujo de trabajo, la información de conexión y los valores de parámetro no existen en una única ubicación. El diseñador debe poder resolver el valor del parámetro antes de cargarlo. Importante: Para los tipos de datos Secure Object y Secure String, evite establecer un valor predeterminado porque el valor se almacena como texto sin formato.
   Valor real	No	Valor real del parámetro.

   En el ejemplo siguiente se muestra una definición para un parámetro de cadena:

   

5. Si tiene más parámetros que agregar, seleccione Agregar parámetro. De lo contrario, cierre el panel de parámetros, pero asegúrese de guardar el flujo de trabajo para guardar la nueva definición de parámetro.

6. Para hacer referencia al parámetro desde un desencadenador o una acción que se encuentra en el mismo flujo de trabajo, siga estos pasos:

   1. En el diseñador, abra el flujo de trabajo que quiera y expanda el desencadenador o la acción.

   2. En la propiedad donde quiere usar el parámetro, haga clic dentro del cuadro de edición de esa propiedad.

   3. En la lista de contenido dinámico que se abre, en Parámetros, seleccione el parámetro creado anteriormente, por ejemplo:

      

7. Para ver o editar los parámetros en un flujo de trabajo de aplicación lógica, siga estos pasos:

   1. Abra el flujo de trabajo de aplicación lógica en el diseñador. En la barra de herramientas del diseñador, seleccione Parámetros.

      Se abre el panel Parámetros y se muestran todos los parámetros definidos para esos flujos de trabajo.

   2. Realice las modificaciones, cierre el panel de parámetros y guarde el flujo de trabajo de la aplicación lógica.

Estándar

Azure Portal

1. En Azure Portal, abra el recurso de aplicación lógica. En Flujos de trabajo, abra el flujo de trabajo en el diseñador.

2. En la barra de herramientas del diseñador, seleccione Parámetros.

   

3. En el panel Parámetros seleccione Crear parámetro.

4. Proporcione la información siguiente sobre el parámetro que se creará:

   Propiedad	Obligatorio	Descripción
   Nombre	Sí	Nombre del parámetro que se va a crear.
   Tipo	Sí	Tipo de datos del parámetro, como Array, Bool, Float, Int, Objet y String. Nota: En los flujos de trabajo de la aplicación lógica estándar, no se admiten los tipos de datos seguros, como securestring y secureobject.
   Valor	Sí	Valor del parámetro. En flujos de trabajo de aplicaciones lógicas estándar, debe especificar el valor del parámetro porque la lógica de flujo de trabajo, la información de conexión y los valores de parámetro no existen en una única ubicación. El diseñador debe poder resolver el valor del parámetro antes de cargarlo.

   En el ejemplo siguiente se muestra una definición para un parámetro de cadena:

   

5. Cuando haya terminado, cierre el panel Parámetros, pero asegúrese de guardar el flujo de trabajo para guardar la nueva definición de parámetro.

6. Para hacer referencia al parámetro desde un desencadenador o una acción que se encuentra en cualquier flujo de trabajo de la misma aplicación lógica, siga estos pasos:

   1. En el diseñador, abra el flujo de trabajo que quiera y expanda el desencadenador o la acción.

   2. En la propiedad donde quiere usar el parámetro, haga clic dentro del cuadro de edición de esa propiedad.

   3. En la lista de contenido dinámico que se abre, en Parámetros, seleccione el parámetro creado anteriormente, por ejemplo:

      

7. Para ver o editar parámetros en la misma aplicación lógica, siga cualquiera de estos dos pasos:

   • Abra cualquier flujo de trabajo en esa aplicación lógica. En el menú del flujo de trabajo, seleccione Diseñador. En la barra de herramientas del diseñador, seleccione Parámetros.

     Se abre el panel Parámetros y se muestran todos los parámetros definidos en los flujos de trabajo de esa aplicación lógica.

   • Para ver o editar en JSON masivo, en el menú principal de la aplicación lógica, seleccione Parámetros.

     Se abre la vista de JSON Parámetros y se muestran todos los parámetros definidos en los flujos de trabajo de esa aplicación lógica.

Visual Studio Code

1. En un archivo JSON de nivel raíz de proyecto denominado parameters.json, defina todos los parámetros y sus valores. Este archivo tiene un objeto que incluye pares clave-valor. Cada clave es el nombre de cada parámetro, mientras que cada valor es la estructura de cada parámetro. Cada estructura debe incluir una declaración type y value.

   Importante

   El archivo parameters.json debe definir e incluir todos los parámetros y sus valores a los que haga referencia o use en otra parte del proyecto, por ejemplo, en las definiciones de flujo de trabajo o las conexiones.

   En el ejemplo siguiente se muestra un archivo de parámetros básicos:

   {
       "responseString": { 
           "type": "string", 
           "value": "hello" 
       },
       "functionAuth": { 
           "type": "object", 
           "value": { 
               "type": "QueryString", 
               "name": "Code", 
               "value": "@appsetting('<AzureFunctionsOperation-FunctionAppKey>')" 
           }
       }
    }
   

   Nota

   El único tipo de expresión válido en el archivo parameters.json es @appsetting.

2. Para hacer referencia a parámetros en las entradas de desencadenador o acción, use la expresión @parameters('<parameter-name>').

Parametrización del archivo de conexiones

Para parametrizar el archivo connections.json, reemplace los valores de los literales, como ConnectionRuntimeUrl, por una expresión parameters() única, como por ejemplo, @parameters('api-runtimeUrl'). Los únicos tipos de expresión válidos en el archivo connections.json son @parameters y @appsetting.

Importante

Durante el desarrollo, si parametriza el archivo connections.json, la experiencia del diseñador se restringe, tanto localmente como en Azure Portal. Si necesita usar el diseñador para desarrollo, en su lugar use un archivo connections.json sin parametrizar. A continuación, en las canalizaciones de implementación, reemplace por el archivo con parámetros. El tiempo de ejecución sigue funcionando con parametrización. Las mejoras del diseñador están en desarrollo.

En el ejemplo siguiente se muestra un archivo connections.json parametrizado que usa la configuración de la aplicación y los parámetros. Aunque quiere usar parámetros siempre que sea posible, este escenario es una excepción o un caso perimetral en el que se usaría la configuración de la aplicación sobre los parámetros porque la configuración de la aplicación se genera durante la implementación y es más fácil de rellenar dinámicamente en una canalización de desarrollo. En este archivo de ejemplo se usa un parámetro para el objeto de autenticación blob_auth complejo y la configuración de la aplicación para los demás valores. En este caso, puede usar un parámetro para el objeto de autenticación, ya que es poco probable que haga referencia al parámetro en el flujo de trabajo:

{
   "serviceProviderConnections": {
      "serviceBus": {
         "parameterValues": {
            "connectionString": "@appsetting('serviceBus_connectionString')"
        },
        "serviceProvider": {
           "id": "/serviceProviders/serviceBus"
        },
        "displayName": "servicebus"
     }
   },
   "managedApiConnections": {
      "azureblob": {
         "api": {
            "id": "/subscriptions/@{appsetting('WORKFLOWS_SUBSCRIPTION_ID')}/providers/Microsoft.Web/locations/@{appsetting('WORKFLOWS_LOCATION_NAME')}/managedApis/azureblob"
         },
         "connection": {
            "id": "/subscriptions/@{appsetting('WORKFLOWS_SUBSCRIPTION_ID')}/resourceGroups/@{appsetting('WORKFLOWS_RESOURCE_GROUP_NAME')}/providers/Microsoft.Web/connections/azureblob"
         },
         "connectionRuntimeUrl": "@appsetting('BLOB_CONNECTION_RUNTIMEURL')",
         "authentication": "@parameters('blob_auth')"
      }
   }
}

Nota

Cuando tenga una expresión insertada con texto sin formato, asegúrese de usar el formato interpolado con esa expresión colocándola entre llaves ({}). Este formato ayuda a evitar problemas de análisis.

Por ejemplo, si tiene "<text>/@<function-name>('<parameter-name>')/<text>", use la siguiente versión en lugar de "<text>/@{<function-name>('<parameter-name>')}/<text>".

Para más información, consulte Consideraciones a la hora de usar funciones.

Administración de archivos de parámetros

Normalmente, debe administrar varias versiones de archivos de parámetros. Es posible que tenga valores de destino para distintos entornos de implementación, como desarrollo, pruebas y producción. La administración de estos archivos de parámetros suele funcionar como la administración de archivos de parámetros de plantilla de ARM. Al realizar la implementación en un entorno específico, se promueve el archivo de parámetros correspondiente, por lo general a través de una canalización para DevOps.

Para reemplazar los archivos de parámetros de forma dinámica mediante la CLI de Azure, ejecute el comando siguiente:

az functionapp deploy --resource-group MyResourceGroup --name MyLogicApp --src-path C:\parameters.json --type static --target-path parameters.json

Si tiene un proyecto de aplicación lógica basado en NuGet, tendrá que actualizar el archivo de proyecto ( <nombre-de-aplicación-lógica>.csproj) para incluir el archivo de parámetros en la salida de compilación, por ejemplo:

<ItemGroup>
  <None Update="parameters.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>

Nota

Actualmente, la capacidad de reemplazar de forma dinámica los archivos de parámetros aún no está disponible en Azure Portal ni en el diseñador de flujos de trabajo.

Para obtener más información sobre cómo configurar las aplicaciones lógicas para implementaciones de DevOps, revise la siguiente documentación:

• Introducción a la implementación de DevOps para aplicaciones lógicas basadas en un solo inquilino
• Configuración de la implementación de DevOps para aplicaciones lógicas basadas en un solo inquilino

Administración de la configuración de la aplicación

En Azure Logic Apps de un solo inquilino, la configuración de la aplicación contiene opciones de configuración globales para todos los flujos de trabajo de la misma aplicación lógica. Al ejecutar flujos de trabajo localmente en Visual Studio Code, se puede acceder a esta configuración de la aplicación como variables de entorno local en el archivo local.settings.json. A continuación, puede hacer referencia a esta configuración de la aplicación en los parámetros.

Para agregar, actualizar o eliminar la configuración de la aplicación, seleccione y revise las secciones siguientes para Visual Studio Code, Azure Portal, la CLI de Azure o la plantilla de ARM (Bicep).

Azure Portal

Para revisar la configuración de aplicación del recurso aplicación lógica en Azure Portal, siga estos pasos:

1. En Azure Portal, abra el recurso de aplicación lógica.

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

3. En la página Configuración, en la pestaña Configuración de la aplicación, revise la configuración de la aplicación de la aplicación lógica.

4. Para ver todos los valores, seleccione Mostrar valores. O bien, para ver un valor único, seleccione ese valor.

Para agregar una configuración nueva, siga estos pasos:

1. En la pestaña Configuración de la aplicación, en Configuración de la aplicación, seleccione Nueva configuración la de aplicación.

2. En Nombre, escriba la clave o el nombre de la nueva configuración.

3. En Valor, escriba el valor de la nueva configuración.

4. Cuando esté listo para crear el nuevo par clave-valor, seleccione Aceptar.

   

5. Cuando esté listo, en la barra de herramientas Configuración, seleccione Guardar.

CLI de Azure

Para revisar la configuración actual de la aplicación mediante la CLI de Azure, ejecute el comando az logicapp config appsettings list. Asegúrese de que el comando incluye los parámetros --name -n y --resource-group -g, por ejemplo:

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

Para agregar o actualizar una configuración de la aplicación mediante la CLI de Azure, ejecute el comando az logicapp config appsettings set. Asegúrese de que el comando incluye los parámetros --name n y --resource-group -g. Por ejemplo, el comando siguiente crea una configuración con una clave denominada CUSTOM_LOGIC_APP_SETTING con un valor de 12345:

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

Plantilla de Resource Manager o de Bicep

Para revisar y definir la configuración de la aplicación en una plantilla de ARM o en una plantilla de Bicep, busque la definición de recursos de la aplicación lógica y actualice el objeto JSON appSettings. Para obtener la definición de recursos completa, consulte la referencia sobre la plantilla de ARM.

En este ejemplo se muestra la configuración de archivos para las plantillas de ARM o las plantillas de Bicep:

"appSettings": [
    {
        "name": "string",
        "value": "string"
    },
    {
        "name": "string",
        "value": "string"
    },
    <...>
], 

Pasos siguientes

• Comparación de las opciones de un solo inquilino, multiinquilino y entorno del servicio de integración para Azure Logic Apps