Exporter des workflows Consommation vers une application logique Standard
Les workflows d’application logique Standard, qui s’exécutent dans Azure Logic Apps monolocataire, offrent de nombreuses capacités nouvelles et améliorées. Par exemple, vous obtenez l’isolation de calcul, l’intégration de réseau virtuel et les points de terminaison privés, ainsi que l’hébergement de l’environnement App Services, le développement local et le débogage à l’aide de Visual Studio Code, une faible latence avec des workflows sans état, etc.
Si vous souhaitez bénéficier des flux de travail Standard, mais que vos flux de travail s’exécutent dans une instance Azure Logic Apps multitenant, vous pouvez maintenant déplacer vos flux de travail Consommation vers une instance Azure Logic Apps à tenant unique. Ce commutateur est utile dans les scénarios qui nécessitent certaines fonctionnalités Standard telles que l’isolation et l’intégration réseau, une latence plus faible ou une meilleure prévisibilité des coûts.
Vous pouvez désormais exporter une application logique Consommation vers une application logique Standard. À l’aide de Visual Studio Code et de la dernière extension Azure Logic Apps (Standard), vous exportez vos applications logiques en tant que workflow avec état vers un projet d’application logique Standard. Vous pouvez ensuite mettre à jour, tester et déboguer localement vos workflows pour les préparer au redéploiement. Lorsque vous êtes prêt, vous pouvez déployer directement à partir de Visual Studio Code ou via votre propre processus DevOps.
Notes
La fonctionnalité d’exportation ne migre pas vos workflows. À la place, cet outil réplique les artefacts, tels que les définitions de workflow, les connexions, les artefacts de compte d’intégration et d’autres. Vos ressources d’application logique source, vos workflows, l’historique des déclencheurs, l’historique des exécutions et d’autres données restent intactes.
Vous contrôlez le processus d’exportation et votre parcours de migration. Vous pouvez tester et valider vos workflows exportés selon vos besoins avec l’environnement de destination. Vous choisissez quand désactiver ou supprimer vos applications logiques sources.
Cet article fournit des informations sur le processus d’exportation et montre comment exporter vos flux de travail d’application logique d’un flux de travail Consommation vers un projet d’application logique Standard local dans Visual Studio Code.
Problèmes connus et limitations
L’outil d’exportation n’exporte pas d’informations sur l’infrastructure, telles que les paramètres de compte d’intégration.
L’outil d’exportation peut exporter des workflows d’application logique avec des déclencheurs qui ont des paramètres d’accès concurrentiel. Toutefois, Azure Logic Apps monolocataire ignore ces paramètres.
Les applications logiques doivent se trouver dans la même région si vous souhaitez les exporter vers un même projet d’application logique Standard.
Par défaut, les informations d’identification de connexion ne sont pas clonées à partir de workflows d’application logique source. Pour que vos workflows d’application logique puissent s’exécuter, vous devez réauthentifier ces connexions après l’exportation.
Par défaut, si un connecteur Azure a une version de connecteur intégrée, l’outil d’exportation convertit automatiquement le connecteur Azure en connecteur intégré. Il n’existe aucune option permettant de refuser ce comportement.
Types d’opérations exportables
| Opération | Type JSON |
|---|---|
| Déclencheur | Intégrée : Http, HttpWebhook, Recurrence, manual (Requête) Managé: ApiConnection ApiConnectionNotification, ApiConnectionWebhook |
| Action | Intégrée : AppendToArrayVariable, AppendToStringVariable, Compose, DecrementVariable, Foreach, Http, HttpWebhook, If, IncrementVariable, InitializeVariable, JavaScriptCode, Join, ParseJson, Response, Scope, Select, SetVariable, Switch, Table, Terminate, Until, Wait - Managée : ApiConnection, ApiConnectionWebhook |
Prérequis
Une ou plusieurs applications logiques à déployer dans le même abonnement et la même région Azure, par exemple, USA Est 2.
Le lecteur Azure a accès, au niveau de l’abonnement, à l’abonnement dans lequel les applications logiques sont actuellement déployées.
Le contributeur Azure a accès au niveau du groupe de ressources, si vous sélectionnez l’option Déployer des connecteurs gérés.
Passez en revue et répondez aux exigences de configuration de Visual Studio Code avec l’extension Azure Logic Apps (Standard).
Notes
Veillez à installer la version 2.0.16 ou ultérieure pour l’extension Azure Logic Apps (Standard) pour Visual Studio Code. Certains scénarios de conversion nécessitent le concepteur de flux de travail le plus récent, qui est disponible dans cette version.
Regrouper des applications logiques pour l’exportation
Avec l’extension Azure Logic Apps (Standard), vous pouvez combiner plusieurs workflows d’application logique Consommation dans un même projet d’application logique Standard. Dans Azure Logic Apps monolocataire, une ressource d’application logique Standard peut avoir plusieurs workflows. Avec cette approche, vous pouvez pré-valider vos workflows afin de ne manquer aucune dépendance lorsque vous sélectionnez des applications logiques pour l’exportation.
Tenez compte des recommandations suivantes lorsque vous sélectionnez des applications logiques pour l’exportation :
Regroupez des applications logiques où les workflows partagent les mêmes ressources, telles que les artefacts de compte d’intégration, les mappages et les schémas, ou utilisent des ressources via une chaîne de processus.
Pour l’organisation et le nombre de workflows par application logique, consultez les Meilleures pratiques et recommandations.
Exporter des workflows Consommation vers un projet local
Sélectionner des applications logiques pour l’exportation
Dans Visual Studio Code, connectez-vous à Azure, si ce n’est déjà fait.
Dans la barre d’activité de Visual Studio Code, sélectionnez Azure pour ouvrir la fenêtre Azure (Shift + Alt + A).
Dans la barre d’outils de la section Espace de travail, depuis le menu Azure Logic Apps, sélectionnez Exporter une application logique.
Une fois l’onglet Exporter ouvert, sélectionnez votre abonnement et votre région Azure, puis sélectionnez Suivant.
Sélectionnez les applications logiques à exporter. Chaque application logique sélectionnée s’affiche dans la liste Applications logiques sélectionnées sur le côté.
Conseil
Vous pouvez également rechercher des applications logiques et filtrer sur le groupe de ressources.
L’outil d’exportation commence à vérifier si vos applications logiques sélectionnées sont éligibles à l’exportation.
Dans la section Options avancées , vous pouvez sélectionner les options suivantes :
Option Default Description Générer un modèle d’infrastructure Activé Le processus d’exportation crée des modèles d’infrastructure, qui incluent un modèle ARM pour l’application logique Standard et un modèle ARM pour chaque connexion managée par Azure exportée. Cloner les informations d'identification de connexion Désactivé Le processus d’exportation clone les informations d’identification de la connexion managée par Azure d’origine vers la nouvelle connexion managée par Azure créée dans Azure, en tant qu’élément du déploiement. Fonctionne uniquement dans les cas où la connexion exportée reste une connexion managée par Azure, par exemple une connexion Office 365 Outlook.
Important : utilisez cette option avec prudence. Par défaut, deux nouvelles connexions pointeront vers la même ressource, ce qui peut potentiellement créer des conditions de compétition.Par défaut, compte d’intégration comme source pour les transformations et la validation Désactivé Référencez le mappage et les fichiers de schéma localement ou dans un compte d’intégration. Si cette option est activée, ne copiez pas les mappages et les schémas dans le projet de destination. Nécessite l’ajout d’une référence à un compte d’intégration dans le paramètre d’application de votre application logique. Par défaut, les actions Transformation XML et Validation XML utilisent le compte d’intégration comme source. Exporter des connecteurs personnalisés en tant qu’actions de Gestion des API Désactivé Si cette option est activée, des connecteurs personnalisés sont créés en tant qu’actions de Gestion des API, plutôt qu’actions HTTP, afin que vous puissiez implémenter des actions personnalisées en tant qu’opérations d’API dans Gestion des API. Pour plus d’informations, consultez Options Standard Azure Logic Apps pour la connexion aux services clients ou aux API. Lorsque vous avez terminé, sélectionnez Suivant.
Passer en revue les résultats de la validation d’exportation
Une fois la validation d’exportation terminée, passez en revue les résultats en développant l’entrée pour chaque application logique.
Les applications logiques qui présentent des erreurs ne peuvent pas être exportées. Vous devez supprimer ces applications logiques de la liste d’exportation jusqu’à ce que vous les corrigiez à la source. Pour supprimer une application logique de la liste, sélectionnez Précédent.
Par exemple, SourceLogicApp2 a une erreur et ne peut pas être exporté tant qu’elle ne soit résolue :
Les applications logiques qui passent la validation avec ou sans avertissements sont toujours éligibles à l’exportation. Pour continuer, sélectionnez Exporter si toutes les applications sont validées avec succès, ou sélectionnez Exporter avec des avertissements si les applications ont des avertissements.
Par exemple, SourceLogicApp3 a un avertissement, mais vous pouvez continuer à exporter :
Le tableau suivant fournit plus d’informations sur chaque icône de validation et état :
Icône de validation État de validation 
La validation de l’élément a réussi, l'exportation peut donc continuer sans problèmes à résoudre. 
La validation de l'élément a échoué, l'exportation ne peut donc pas continuer.
L’entrée de validation de l’élément ayant échoué apparaît automatiquement développée et fournit des informations sur l’échec de validation.
L’élément a réussi la validation avec un avertissement, mais l’exportation peut continuer avec la résolution post-exportation requise.
L’entrée de validation de l’élément avec un avertissement s’affiche automatiquement et fournit des informations sur l’avertissement et la correction post-exportation requise.Une fois la section Terminer l’exportation affichée, pour Exporter l’emplacement, parcourez et sélectionnez un dossier local pour votre nouveau projet d’application logique Standard.
Si votre workflow dispose de connexions managées que vous souhaitez déployer, ce qui est recommandé uniquement pour les environnements hors production, sélectionnez Déployer des connexions managées, qui affiche des groupes de ressources existants dans votre abonnement Azure. Sélectionnez le groupe de ressources dans lequel vous souhaitez déployer les connexions managées.
Sous Étapes après l’exportation, passez en revue les étapes de post-exportation requises, par exemple :
En fonction de votre scénario, sélectionnez Exporter et terminer ou Exporter avec des avertissements et terminer.
L’outil d’exportation télécharge votre projet à l’emplacement de votre dossier sélectionné, développe le projet dans Visual Studio Code et déploie toutes les connexions managées, si vous avez sélectionné cette option.
Une fois ce processus terminé, Visual Studio Code ouvre un nouvel espace de travail. Vous pouvez fermer la fenêtre d’exportation en toute sécurité.
À partir de votre projet d’application logique Standard, ouvrez et consultez le fichier README.md pour connaître les étapes de post-exportation requises.
Étapes post-exportation
Étapes de correction
Certains workflows d’application logique exportés nécessitent des étapes de correction post-exportation pour s’exécuter sur la plateforme Standard.
À partir de votre projet d’application logique Standard, ouvrez le fichier README.md et passez en revue les étapes de correction de vos workflows exportés. L’outil d’exportation génère le fichier README.md, qui contient toutes les étapes de post-exportation requises.
Avant d’apporter des modifications à votre workflow d’application logique source, veillez à tester votre nouvelle ressource et votre workflow d’application logique Standard.
Actions et paramètres du compte d’intégration
Si vous exportez des actions qui dépendent d’un compte d’intégration, vous devez configurer manuellement votre application logique Standard avec un lien de référence vers le compte d’intégration qui contient les artefacts requis. Pour plus d’informations, passez en revue le compte d'intégration Link à une application logique Standard.
Actions et paramètres de lot
Si vous exportez des actions qui utilisent des actions Batch avec plusieurs configurations stockées dans un compte d’intégration, vous devez configurer manuellement vos actions Batch avec les valeurs appropriées après l’exportation. Pour plus d’informations, reportez-vous à Envoyer, recevoir et traiter des messages par lots dans Azure Logic Apps.
Structure de dossiers du projet
Une fois le processus d’exportation terminé, votre projet d’application logique Standard contient de nouveaux dossiers et fichiers en même temps que la plupart des autres dans un projet d’application logique Standard standard.
Le tableau suivant décrit ces nouveaux dossiers et fichiers ajoutés par le processus d’exportation :
| Dossier | Fichier | Description |
|---|---|---|
| .development\deployment | LogicAppStandardConnections.parameters.json | Fichier de paramètres de modèle Azure Resource Manager pour le déploiement de connecteurs managés |
| LogicAppStandardConnections.template.json | Définition de modèle Azure Resource Manager pour le déploiement de connecteurs managés | |
| LogicAppStandardInfrastructure.parameters.json | Fichier de paramètres de modèle Azure Resource Manager pour le déploiement de la ressource d’application logique Standard | |
| LogicAppStandardInfrastructure.template.json | Définition de modèle Azure Resource Manager pour le déploiement de la ressource d’application logique Standard | |
| .logs\export | exportReport.json | Exporter le fichier brut récapitulatif du rapport, qui inclut toutes les étapes requises pour la correction post-exportation |
| exportValidation.json | Fichier brut de rapport de validation, qui inclut les résultats de validation pour chaque application logique exportée | |
| README.md | Fichier Markdown avec résumé des résultats d’exportation, y compris les applications logiques créées et toutes les étapes suivantes nécessaires |