Modifier les paramètres de l’hôte et de l’application pour les applications logiques Standard dans Azure Logic Apps monolocataire

S’applique à : Azure Logic Apps (Standard)

Dans Azure Logic Apps locataire unique, les paramètres d’application pour une application logique standard spécifient les options de configuration globale qui affectent tous les workflows de cette application logique. Toutefois, ces paramètres s’appliquent uniquement lorsque ces workflows s’exécutent dans votre environnement de développement local. Les workflows qui s’exécutent localement peuvent accéder à ces paramètres d’application en tant que variables d’environnement locales, qui sont utilisées par les outils de développement locaux pour des valeurs qui peuvent souvent changer d’un environnement à l’autre. Par exemple, ces valeurs peuvent contenir des chaînes de connexion. Lorsque vous déployez dans Azure, les paramètres de l’application sont ignorés et ne sont pas inclus dans votre déploiement.

Votre application logique a également des paramètres d’hôte qui spécifient les paramètres de configuration du runtime et les valeurs qui s’appliquent à tous les workflows de cette application logique, par exemple, les valeurs par défaut pour le débit, la capacité, la taille des données, etc., qu’elle s’exécute localement ou dans Azure.

Paramètres de l’application, paramètres et déploiement

Dans Azure Logic Apps multi-tenant, le déploiement dépend des modèles Azure Resource Manager (modèles ARM) qui combinent et gèrent l’approvisionnement de ressources pour les applications logiques et l’infrastructure. Cette conception pose un défi lorsque vous devez gérer des variables d’environnement pour des applications logiques dans différents environnements de développement, de test et de production. Tout ce qui se trouve dans un modèle ARM est défini lors du déploiement. Si vous ne devez modifier ne serait-ce qu’une seule variable, vous devez tout redéployer.

Dans Azure Logic Apps monolocataire, le déploiement devient plus facile, car vous pouvez séparer l’approvisionnement des ressources entre les applications et l’infrastructure. Vous pouvez utiliser des paramètres pour extraire les valeurs qui peuvent changer d’un environnement à l’autre. En définissant des paramètres à utiliser dans vos workflows, vous pouvez d’abord vous concentrer sur la conception de vos workflows, puis insérer ultérieurement vos variables spécifiques à l’environnement. Vous pouvez appeler et référencer vos variables d’environnement au moment de l’exécution à l’aide des paramètres d’application et des paramètres. De cette façon, vous n’avez pas besoin de redéployer aussi souvent.

Les paramètres d’application s’intègrent à Azure Key Vault. Vous pouvez référencer directement des chaînes sécurisées, telles que des chaînes de connexion et des clés. Comme pour les modèles Azure Resource Manager (modèles ARM), où vous pouvez définir des variables d’environnement au moment du déploiement, vous pouvez définir des paramètres d’application dans la définition de workflow de votre application logique. Vous pouvez ensuite capturer des valeurs d’infrastructure générées dynamiquement, comme des points de terminaison de connexion, des chaînes de stockage, etc. Toutefois, les paramètres d’application ont des limitations de taille et ne peuvent pas être référencés à partir de certaines zones dans Azure Logic Apps.

Pour plus d’informations sur la configuration de vos applications logiques pour le déploiement, consultez la documentation suivante :

• Créer des paramètres pour les valeurs qui changent dans les workflows entre les environnements pour Azure Logic Apps monolocataire
• Présentation du déploiement DevOps pour les applications logiques basées monolocataires
• Configurer le déploiement DevOps pour les applications logiques monolocataires

Structure de projet Visual Studio Code

Dans Visual Studio Code, votre projet d’application logique a l’un des types suivants :

• Extension basée sur un bundle (Node.js), qui est le type par défaut
• NuGet basé sur un package (.NET), que vous pouvez convertir à partir du type par défaut

En fonction de ces types, votre projet comprend des dossiers et des fichiers légèrement différents. Un projet NuGet inclut un dossier .bin qui contient des packages et d’autres fichiers de bibliothèque. Un projet basé sur un bundle n’inclut pas le dossier .bin ni d’autres fichiers. Certains scénarios exigent un projet NuGet pour que votre application s’exécute, par exemple quand vous voulez développer et exécuter des opérations intégrées personnalisées. Pour plus d’informations sur la conversion de votre projet pour utiliser NuGet, consultez Activer la création de connecteurs intégrés.

Pour le projet basé sur un bundle par défaut, votre projet a une structure de dossiers et de fichiers similaire à celle de l’exemple suivant :

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

Au niveau racine de votre projet se trouvent les fichiers et dossiers suivants avec d’autres éléments :

Informations de référence sur les paramètres d’application - local.settings.json

Dans Visual Studio Code, au niveau de la racine de votre projet d’application logique, le fichier local.settings.json contient des options de configuration globale qui affectent tous les workflows de cette application logique en cours d’exécution dans votre environnement de développement local. Lorsque vos workflows s’exécutent localement, ces paramètres sont accessibles en tant que variables d’environnement locales et leurs valeurs peuvent souvent changer entre les différents environnements dans lesquels vous exécutez vos workflows. Pour afficher et gérer ces paramètres, consultez Gérer les paramètres d’application - local.settings.json.

Les paramètres de l’application dans Azure Logic Apps fonctionnent de la même façon que les paramètres de l’application dans Azure Functions ou Azure Web Apps. Si vous avez déjà utilisé ces autres services, vous connaissez peut-être déjà les paramètres d’application. Pour plus d’informations, consultez Référence des paramètres d’application pour Azure Functions et Utiliser Azure Functions Core Tools - Fichier de paramètres local.

Pour que votre workflow fonctionne correctement, certains paramètres d’application sont obligatoires.

Gérer les paramètres d’application - local.settings.js

Pour ajouter, mettre à jour ou supprimer des paramètres d’application, sélectionnez et consultez les sections suivantes selon que vous utilisez le Portail Azure, Visual Studio Code, Azure CLI ou un modèle ARM (Bicep). Pour les paramètres d’application spécifiques à Logic Apps, consultez le Guide de référence des paramètres d’application disponibles - 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 

Référence pour les paramètres de l’hôte - host.json

Dans Visual Studio Code, au niveau de la racine de votre projet d’application logique, le fichier de métadonnées host.json contient les paramètres d’exécution et les valeurs par défaut qui s’appliquent à tous les workflows d’une ressource d’application logique, qu’ils s’exécutent localement ou dans Azure. Pour afficher et gérer ces paramètres, consultez Gérer les paramètres de l’hôte - host.json. Vous trouverez également des informations sur les limites associées dans la documentation Limites et configuration d’Azure Logic Apps.

Débit de l’orchestration de travail

Ces paramètres affectent le débit et la capacité d’Azure Logic Apps monolocataire à exécuter des opérations de workflow.

Vous utilisez les deux paramètres suivants pour arrêter manuellement et immédiatement supprimer les workflows spécifiés dans l’application logique Standard.

L’exemple suivant illustre la syntaxe pour ces paramètres dans lesquels l’ID de workflow est suivi des deux-points (:) et séparé par un point-virgule (;) :

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

Déclencheurs basés sur la récurrence

Déclencheur simultané

Les paramètres suivants fonctionnent uniquement pour les flux de travail qui commencent par un déclencheur basé sur la périodicité pour les connecteurs intégrés basés sur le fournisseur de services. Pour un flux de travail qui commence par un déclencheur basé sur une fonction, vous pouvez essayer de configurer le traitement par lots là où il est pris en charge. Toutefois, le traitement par lots n’est pas toujours la bonne solution. Par exemple, un lot peut conserver des messages au-delà de la durée du verrouillage avec les déclencheurs Azure Service Bus. Par conséquent, toute action, comme l’achèvement ou l’abandon, échoue sur ces messages.

Durée d’exécution et historique de rétention

Actions d’exécution

Entrées et sorties

Pagination

Segmentation

Stocker du contenu inline ou utiliser des objets blob

Boucles Foreach

Boucles until

Variables

Opérations HTTP intégrées

Opérations de webhook HTTP intégrées

Opérations de stockage Azure intégrées

Stockage d'objets blob

Stockage Table et File d’attente

Partage de fichiers

Opérations Azure Functions intégrées

Opérations Azure Service Bus intégrées

Opérations SFTP intégrées

Opérations du connecteur managé

Stratégie de nouvelle tentative pour toutes les autres opérations

Limites

• Taille maximale du contenu

  Les déclencheurs intégrés, tels que HTTP ou Requête, sont par défaut limités à la taille de message décrite dans Référence de configuration et limites – Messages. Pour gérer des fichiers de taille supérieure à la limite, essayez de télécharger votre contenu en tant que blob dans Stockage Blob Azure, puis obtenez votre contenu en utilisant le connecteur Blob Azure.

Gérer les paramètres de l’hôte - host.json

Vous pouvez ajouter, mettre à jour ou supprimer des paramètres d’hôte, qui spécifient les paramètres de configuration du runtime et les valeurs qui s’appliquent à tous les workflows de cette application logique, comme les valeurs par défaut pour le débit, la capacité, la taille des données, etc., qu’elles s’exécutent localement ou dans Azure. Pour les paramètres d’hôte spécifiques à Logic Apps, consultez le Guide de référence pour les paramètres de déploiement et d’exécution disponibles - host.json.

Portail Azure - host.json

Pour passer en revue les paramètres d’hôte pour votre application logique basée sur un seul locataire dans le portail Azure, procédez comme suit :

1. Dans la zone de recherche du portail Azure, recherchez et ouvrez votre application logique.

2. Dans le menu de l’application logique, sélectionnez Outils avancés sous Outils de développement.

3. Dans la page Outils avancés, sélectionnez Accéder, ce qui ouvre l’environnement Kudu pour votre application logique.

4. Dans la barre d’outils Kudu, ouvrez le menu Console de débogage, puis sélectionnez CMD.

5. Dans le portail Azure, arrêtez votre application logique.

   1. Dans le menu de votre application logique, sélectionnez Vue d’ensemble.

   2. Dans la barre d’outils du volet Vue d’ensemble, sélectionnez Arrêter.

6. Dans le menu de l’application logique, sélectionnez Outils avancés sous Outils de développement.

7. Dans le volet Outils avancés, sélectionnez Accéder, ce qui ouvre l’environnement Kudu pour votre application logique.

8. Dans la barre d’outils Kudu, ouvrez le menu Console de débogage, puis sélectionnez CMD.

   Une fenêtre de console s’ouvre pour vous permettre d’accéder au dossier wwwroot à l’aide de l’invite de commandes. Sinon, vous pouvez parcourir la structure des répertoires qui s’affiche au-dessus de la fenêtre de console.

9. Suivez le chemin menant au dossier wwwroot : ...\home\site\wwwroot.

10. Au-dessus de la fenêtre de la console, dans la table des répertoires, en regard du fichier host.json, sélectionnez Modifier.

11. Une fois que le fichier host.json s’ouvre, passez en revue tous les paramètres de l’hôte qui ont été ajoutés précédemment pour votre application logique.

    Pour plus d’informations sur les paramètres de l’hôte, consultez le Guide de référence des paramètres d’hôte disponibles - host.json.

Pour ajouter un paramètre, effectuez les étapes suivantes :

1. Avant d’ajouter ou de modifier des paramètres, arrêtez votre application logique dans le portail Azure.

   1. Dans le menu de votre application logique, sélectionnez Vue d’ensemble.
   2. Dans la barre d’outils du volet Vue d’ensemble, sélectionnez Arrêter.

2. Revenez au fichier host.json. Sous l’objet extensionBundle, ajoutez l’objet extensions, qui comprend les objets workflow et settings, par exemple :

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

3. Dans l’objet settings, ajoutez une liste plate avec les paramètres d’hôte que vous souhaitez utiliser pour tous les workflows de votre application logique, que ces workflows s’exécutent localement ou dans Azure, par exemple :

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

4. Lorsque vous avez terminé, n’oubliez pas de sélectionner Enregistrer.

5. À présent, redémarrez votre application logique. Revenez à la page Vue d’ensemble de votre application logique, puis sélectionnez Redémarrer.

Visual Studio Code - host.json

Pour passer en revue les paramètres d’hôte de votre application logique dans Visual Studio Code, procédez comme suit :

1. Dans votre projet d’application logique, au niveau du projet racine, recherchez et ouvrez le fichier host.json.

2. Dans l’objet extensions, sous workflows et settings, examinez tous les paramètres d’hôte qui ont été précédemment ajoutés pour votre application logique. Sinon, l’objet extensions n’apparaîtra pas dans le fichier.

   Pour plus d’informations sur les paramètres de l’hôte, consultez le Guide de référence des paramètres d’hôte disponibles - host.json.

Pour ajouter un paramètre d’hôte, effectuez les étapes suivantes :

1. Dans le fichier host.json, sous l’objet extensionBundle, ajoutez l’objet extensions, qui comprend les objets workflow et settings, par exemple :

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

2. Dans l’objet settings, ajoutez une liste plate avec les paramètres d’hôte que vous souhaitez utiliser pour tous les workflows de votre application logique, que ces workflows s’exécutent localement ou dans Azure, par exemple :

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

Étapes suivantes

• Créer des paramètres pour les valeurs qui changent dans les workflows entre les environnements pour Azure Logic Apps monolocataire
• Configurer le déploiement DevOps pour Azure Logic Apps monolocataire