Démarrage rapide : Créer et déployer un workflow d’application logique Consommation dans Azure Logic Apps multilocataire avec un modèle ARM

S’applique à : Azure Logic Apps (Consommation)

Azure Logic Apps est un service cloud qui vous permet de créer et d’exécuter des workflows automatisés qui intègrent des données, des applications, des services cloud et des systèmes locaux en choisissant parmi des centaines de connecteurs. Ce guide de démarrage rapide se concentre sur le processus de déploiement d’un modèle ARM (Azure Resource Manager) pour créer un workflow d’application logique Consommation de base qui vérifie l’état d’Azure toutes les heures et s’exécute dans Azure Logic Apps multilocataire.

Un modèle Azure Resource Manager est un fichier JavaScript Object Notation (JSON) qui définit l'infrastructure et la configuration de votre projet. Le modèle utilise la syntaxe déclarative. Vous décrivez votre déploiement prévu sans écrire la séquence de commandes de programmation pour créer le déploiement.

Si votre environnement répond aux prérequis et que vous êtes familiarisé avec l’utilisation des modèles ARM, sélectionnez le bouton Déployer sur Azure. Le modèle s’ouvre dans le portail Azure.

Prérequis

Si vous n’avez pas d’abonnement Azure, créez un compte Azure gratuit avant de commencer.

Vérifier le modèle

Ce guide de démarrage rapide utilise le modèle Créer une application logique, que vous trouverez dans la galerie des modèles de démarrage rapide Azure, trop longue pour être présentée ici. Passez plutôt en revue le « fichier azuredeploy.json » du modèle de démarrage rapide dans la galerie des modèles.

Le modèle de démarrage rapide crée un workflow d’application logique Consommation qui utilise le déclencheur de périodicité intégré, configuré pour s’exécuter toutes les heures, ainsi qu’une action HTTP intégrée, qui appelle une URL qui retourne l’état d’Azure. Les opérations intégrées s’exécutent en mode natif sur la plateforme Azure Logic Apps.

Ce modèle crée la ressource Azure suivante :

• Microsoft.Logic/workflows, qui crée le workflow pour une ressource d’application logique Consommation.

Pour trouver d’autres modèles de démarrage rapide pour Azure Logic Apps, consultez les modèles Microsoft.Logic dans la galerie.

Déployer le modèle

Suivez l’option que vous voulez utiliser pour déployer le modèle de démarrage rapide :

Option	Description
Azure portal	Si votre environnement Azure satisfait aux prérequis et que vous savez utiliser des modèles Resource Manager, ces étapes vous permettent de vous connecter directement à Azure et d’ouvrir le modèle de démarrage rapide dans le portail Azure. Pour plus d’informations, consultez Déployer des ressources à l’aide de modèles Resource Manager et du portail Azure.
Azure CLI	L’interface de ligne de commande Azure permet de créer et de gérer des ressources Azure. Pour exécuter ces commandes, vous avez besoin d’Azure CLI version 2.6 ou ultérieure. Pour vérifier votre version de l’interface CLI, entrez az --version. Pour plus d’informations, consultez la documentation suivante : - Qu’est-ce qu’Azure CLI ? - Bien démarrer avec Azure CLI
Azure PowerShell	Azure PowerShell fournit un ensemble de cmdlets qui utilisent le modèle Azure Resource Manager pour gérer vos ressources Azure. Pour plus d’informations, consultez la documentation suivante : - Vue d’ensemble d’Azure PowerShell - Présentation du module Azure PowerShell Az - Bien démarrer avec Azure PowerShell
API REST Gestion des ressources Azure	Azure fournit des API REST (Representational State Transfer) qui sont des points de terminaison de service prenant en charge des opérations HTTP (méthodes) que vous utilisez pour créer, récupérer, mettre à jour ou supprimer l’accès à des ressources de service. Pour plus d’informations, consultez Bien démarrer avec l’API REST Azure.

Portail

1. Pour vous connecter avec votre compte Azure et ouvrir le modèle de démarrage rapide dans le portail Azure, sélectionnez l’image suivante :

   

2. Dans le portail, dans la page Créer une application logique à l’aide d’un modèle, entrez ou sélectionnez les valeurs suivantes :

   Propriété	Valeur	Description
   Abonnement	<Azure-subscription-name>	Nom de l’abonnement Azure à utiliser.
   Groupe de ressources	<nom-groupe-de-ressources-Azure>	Nom d’un groupe de ressources Azure nouveau ou existant. Cet exemple utilise Check-Azure-Status-RG.
   Région	<Azure-region>	Région du centre de données Azure qui va utiliser votre application logique. Cet exemple utilise la région USA Ouest.
   Nom de l’application logique	<logic-app-name>	Nom à utiliser pour votre application logique. Cet exemple utilise Check-Azure-Status-LA.
   URI de test	<test-URI>	URI du service à appeler selon une planification spécifique. Cet exemple utilise https://azure.status.microsoft/en-us/status/, qui correspond à la page d’état d’Azure.
   Lieu	<Azure-region-for-all-resources>	Région Azure à utiliser pour toutes les ressources, si elle est différente de la valeur par défaut. Cet exemple utilise la valeur par défaut, [resourceGroup().location], qui correspond à l’emplacement du groupe de ressources.

   L’exemple suivant illustre l’aspect de la page avec des exemples de valeurs :

   

3. Quand vous avez terminé, sélectionnez Vérifier + créer.

4. Poursuivez avec les étapes décrites dans Vérifier les ressources déployées.

INTERFACE DE LIGNE DE COMMANDE

read -p "Enter a project name to use for generating resource names:" projectName &&
read -p "Enter the location, such as 'westus':" location &&
templateUri="https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.json" &&
resourceGroupName="${projectName}rg" &&
az group create --name $resourceGroupName --location "$location" &&
az deployment group create --resource-group $resourceGroupName --template-uri  $templateUri &&
echo "Press [ENTER] to continue ..." &&
read

Pour plus d’informations, consultez la documentation suivante :

• Azure CLI : az deployment group
• Déployer des ressources à l’aide de modèles Resource Manager et d’Azure CLI

PowerShell

$projectName = Read-Host -Prompt "Enter a project name to use for generating resource names"
$location = Read-Host -Prompt "Enter the location, such as 'westus'"
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.json"

$resourceGroupName = "${projectName}rg"

New-AzResourceGroup -Name $resourceGroupName -Location "$location"
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri

Read-Host -Prompt "Press [ENTER] to continue ..."

Pour plus d’informations, consultez la documentation suivante :

• Azure PowerShell : New-AzResourceGroup
• Azure PowerShell : New-AzResourceGroupDeployment
• Déployer des ressources à l’aide de modèles Resource Manager et d’Azure PowerShell

REST API

1. Si vous ne voulez pas utiliser un groupe de ressources Azure existant, créez-en un nouveau en suivant cette syntaxe pour la demande que vous envoyez à l’API REST Gestion des ressources :

   PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2019-10-01
   

   Valeur	Description
   <subscriptionId>	GUID de l’abonnement Azure à utiliser.
   <resourceGroupName>	Nom du groupe de ressources Azure à créer. Cet exemple utilise Check-Azure-Status-RG.

   Par exemple :

   PUT https://management.azure.com/subscriptions/xxxxXXXXxxxxXXXXX/resourcegroups/Check-Azure-Status-RG?api-version=2019-10-01
   

   Pour plus d’informations, consultez la documentation suivante :

   • Informations de référence sur l’API REST Azure : guide pratique pour appeler des API REST Azure
   • API REST Gestion des ressources : Groupes de ressources : Créer ou mettre à jour.

2. Pour déployer le modèle de démarrage rapide sur votre groupe de ressources, suivez cette syntaxe pour la demande que vous envoyez à l’API REST Gestion des ressources :

   PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2019-10-01
   

   Valeur	Description
   <subscriptionId>	GUID de l’abonnement Azure à utiliser.
   <resourceGroupName>	Nom du groupe de ressources Azure à utiliser. Cet exemple utilise Check-Azure-Status-RG.
   <deploymentName>	Nom à utiliser pour votre déploiement. Cet exemple utilise Check-Azure-Status-LA.

   Par exemple :

   PUT https://management.azure.com/subscriptions/xxxxXXXXxxxxXXXXX/resourcegroups/Check-Azure-Status-RG/providers/Microsoft.Resources/deployments/Check-Azure-Status-LA?api-version=2019-10-01
   

   Pour plus d’informations, consultez API REST Gestion des ressources : Déploiements : Créer ou mettre à jour.

3. Pour fournir les valeurs à utiliser pour le déploiement, comme la région Azure et les liens vers le modèle de démarrage rapide et le fichier de paramètres, qui contient les valeurs que le modèle de démarrage rapide va utiliser lors du déploiement, suivez cette syntaxe pour le corps de la demande que vous envoyez à l’API REST Gestion des ressources :

   {
      "location": "{Azure-region}",
      "properties": {
         "templateLink": {
            "uri": "{quickstart-template-URL}",
            "contentVersion": "1.0.0.0"
         },
         "parametersLink": {
            "uri": "{quickstart-template-parameter-file-URL}",
            "contentVersion": "1.0.0.0"
         },
         "mode": "Incremental"
      }
   }
   

   Propriété	Valeur	Description
   location	<Azure-region>	Région Azure à utiliser pour le déploiement. Cet exemple utilise la région USA Ouest.
   templateLink : uri	<quickstart-template-URL>	Emplacement de l’URL du modèle de démarrage rapide à utiliser pour le déploiement : https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.json
   parametersLink : uri	<quickstart-template-parameter-file-URL>	Emplacement de l’URL du fichier de paramètres du modèle de démarrage rapide à utiliser pour le déploiement : https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.parameters.json Pour plus d’informations sur le fichier de paramètres Resource Manager, consultez la documentation suivante : - Créer un fichier de paramètres Resource Manager - Tutoriel : Utiliser les fichiers de paramètres pour déployer votre modèle Resource Manager
   mode	<deployment-mode>	Exécutez une mise à jour incrémentielle ou complète. Cet exemple utilise Incrémentielle, qui est la valeur par défaut. Pour plus d’informations, consultez Modes de déploiement Azure Resource Manager.

   Par exemple :

   {
      "location": "West US",
      "properties": {
         "templateLink": {
            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.json",
            "contentVersion": "1.0.0.0"
         },
         "parametersLink": {
            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.logic/logic-app-create/azuredeploy.parameters.json",
            "contentVersion": "1.0.0.0"
         },
         "mode": "Incremental"
      }
   }
   

Pour plus d’informations, consultez les rubriques suivantes :

• API REST Gestion des ressources
• Déployer des ressources avec des modèles Resource Manager et l’API REST Resource Manager

Vérifier les ressources déployées

Pour afficher le workflow d’application logique, vous pouvez utiliser le portail Azure, exécuter un script que vous créez avec Azure CLI ou Azure PowerShell, ou encore utiliser l’API REST Application logique.

Portail

1. Dans la zone de recherche du portail Azure, entrez le nom de votre application logique, à savoir Check-Azure-Status-LA dans cet exemple. Dans la liste des résultats, sélectionnez votre application logique.

2. Dans le portail Azure, recherchez et sélectionnez votre application logique, à savoir Check-Azure-Status-RG dans cet exemple.

3. Quand le concepteur de workflow s’ouvre, passez en revue le workflow d’application logique créé par le modèle de démarrage rapide.

4. Pour tester l’application logique, sélectionnez Exécuter dans la barre d’outils du concepteur.

INTERFACE DE LIGNE DE COMMANDE

echo "Enter your logic app name:" &&
read logicAppName &&
az logic workflow show --resource-group $resourceGroupName --name $logicAppName &&
echo "Press [ENTER] to continue ..."

Pour plus d’informations, consultez Azure CLI : az logic workflow show.

PowerShell

$logicAppName = Read-Host -Prompt "Enter your logic app name"
Get-AzLogicApp -ResourceGroupName $resourceGroupName -Name $logicAppName 
Write-Host "Press [ENTER] to continue..."

Pour plus d’informations, consultez Azure PowerShell : Get-AzLogicApp.

REST API

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}?api-version=2016-06-01

Value	Description
subscriptionId	GUID de l’abonnement Azure sur lequel vous avez déployé le modèle de démarrage rapide.
resourceGroupName	Nom du groupe de ressources Azure sur lequel vous avez déployé le modèle de démarrage rapide. Cet exemple utilise Check-Azure-Status-RG.
workflowName	Nom de l’application logique que vous avez déployée. Cet exemple utilise Check-Azure-Status-LA.

Par exemple :

GET https://management.azure.com/subscriptions/xxxxXXXXxxxxXXXXX/resourceGroups/Check-Azure-Status-RG/providers/Microsoft.Logic/workflows/Check-Azure-Status-LA?api-version=2016-06-01

Pour plus d’informations, consultez API REST Logic Apps : Workflows : Obtenir.

Nettoyer les ressources

Si vous prévoyez d’utiliser d’autres guides de démarrage rapide et tutoriels, vous pouvez conserver ces ressources. Quand vous n’avez plus besoin de l’application logique, supprimez le groupe de ressources à l’aide du portail Azure, d’Azure CLI, d’Azure PowerShell ou de l’API REST Gestion des ressources.

Portail

1. Dans le portail Azure, recherchez et sélectionnez le groupe de ressources à supprimer, à savoir Check-Azure-Status-RG dans cet exemple.

2. Dans le menu du groupe de ressources, sélectionnez Vue d’ensemble, si cette option n’est pas déjà sélectionnée. Dans la page de présentation, sélectionnez Supprimer le groupe de ressources.

3. Pour confirmer, entrez le nom du groupe de ressources.

Pour plus d’informations, consultez Supprimer le groupe de ressources.

INTERFACE DE LIGNE DE COMMANDE

echo "Enter your resource group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Pour plus d’informations, consultez Azure CLI : az group delete.

PowerShell

$resourceGroupName = Read-Host -Prompt "Enter the resource group name"
Remove-AzResourceGroup -Name $resourceGroupName
Write-Host "Press [ENTER] to continue..."

Pour plus d’informations, consultez Azure PowerShell : Remove-AzResourceGroup.

REST API

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2019-10-01

Value	Description
subscriptionId	GUID de l’abonnement Azure sur lequel vous avez déployé le modèle de démarrage rapide.
resourceGroupName	Nom du groupe de ressources Azure sur lequel vous avez déployé le modèle de démarrage rapide. Cet exemple utilise Check-Azure-Status-RG.

Par exemple :

GET https://management.azure.com/subscriptions/xxxxXXXXxxxxXXXXX/resourceGroups/Check-Azure-Status-RG?api-version=2019-10-01

Pour plus d’informations, consultez API REST Gestion des ressources : Groupes de ressources - Supprimer.

Étapes suivantes

Tutoriel : Créer et déployer votre premier modèle Resource Manager