Exemple de script Azure CLI – Créer une application logique

Article
01/04/2024

S’applique à : Azure Logic Apps (Consommation)

Ce script crée un exemple d’application logique via l’extension Logic Apps de l’interface Azure CLI, (az logic). Pour obtenir un guide détaillé de la création et de la gestion d’applications logiques via l’interface Azure CLI, consultez le Guide de démarrage rapide Logic Apps pour l’interface Azure CLI.

Avertissement

L’extension Logic Apps d’Azure CLI, actuellement expérimentale, ne bénéficie pas d’un support technique. Utilisez-la CLI avec précaution, en particulier si vous choisissez de l’utiliser dans des environnements de production.

Prérequis

Compte Azure avec un abonnement actif. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit.
Azure CLI installé sur votre ordinateur local.
Extension Logic Apps d’Azure CLI installée sur votre ordinateur. Pour installer cette extension, utilisez la commande suivante : az extension add --name logic
Une définition de workflow pour votre application logique. Ce fichier JSON doit suivre le schéma de langage de définition de workflow.
Une connexion de l’API à un compte de messagerie au moyen d’un connecteur Azure Logic Apps pris en charge dans le même groupe de ressources que votre application logique. Cet exemple utilise le connecteur Office 365 Outlook, mais vous pouvez également utiliser d’autres connecteurs, comme Outlook.com.

Vérification du prérequis

Validez votre environnement avant de commencer :

Connectez-vous au portail Azure et vérifiez que votre abonnement est actif en exécutant la commande az login.
Vérifiez votre version d’Azure CLI dans un terminal ou une fenêtre de commande en exécutant az --version. Pour obtenir la version la plus récente, consultez les notes de publication les plus récentes.
- Si vous ne disposez pas de la dernière version, mettez à jour votre installation en suivant le guide d’installation pour votre système d’exploitation ou votre plateforme.

Exemple d’explication de workflow

Cet exemple de fichier de définition de workflow crée le même exemple d’application logique Consommation de base que le guide de démarrage rapide pour le portail Azure.

Cet exemple de workflow :

Spécifie un schéma, $schema, pour l’application logique.
Définit un déclencheur pour l’application logique dans la liste des déclencheurs, triggers. Le déclencheur se répète (recurrence) toutes les 3 heures. Les actions sont déclenchées lorsqu’un nouvel élément de flux est publié (When_a_feed_item_is_published) pour le flux RSS spécifié (feedUrl).
Définit une action pour l’application logique dans la liste des actions, actions. L’action envoie un e-mail (Send_an_email_(V2)) via Microsoft 365 avec les détails des éléments de flux RSS, tels qu’ils sont spécifiés dans la section du corps (body) des entrées de l’action (inputs).

Exemple de définition de workflow

Avant d’exécuter l’exemple de script, vous devez d’abord créer un exemple de définition de workflow.

Créez un fichier JSON, testDefinition.json, sur votre ordinateur.

Copiez le contenu suivant dans le fichier JSON :


{
    "definition": {
        "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
        "actions": {
            "Send_an_email_(V2)": {
                "inputs": {
                    "body": {
                        "Body": "<p>@{triggerBody()?['publishDate']}<br>\n@{triggerBody()?['title']}<br>\n@{triggerBody()?['primaryLink']}</p>",
                        "Subject": "@triggerBody()?['title']",
                        "To": "test@example.com"
                    },
                    "host": {
                        "connection": {
                            "name": "@parameters('$connections')['office365']['connectionId']"
                        }
                    },
                    "method": "post",
                    "path": "/v2/Mail"
                },
                "runAfter": {},
                "type": "ApiConnection"
            }
        },
        "contentVersion": "1.0.0.0",
        "outputs": {},
        "parameters": {
            "$connections": {
                "defaultValue": {},
                "type": "Object"
            }
        },
        "triggers": {
            "When_a_feed_item_is_published": {
                "inputs": {
                    "host": {
                        "connection": {
                            "name": "@parameters('$connections')['rss']['connectionId']"
                        }
                    },
                    "method": "get",
                    "path": "/OnNewFeed",
                    "queries": {
                        "feedUrl": "https://www.pbs.org/now/rss.xml"
                    }
                },
                "recurrence": {
                    "frequency": "Hour",
                    "interval": 3
                },
                "splitOn": "@triggerBody()?['value']",
                "type": "ApiConnection"
            }
        }
    },
    "parameters": {
        "$connections": {
            "value": {
                "office365": {
                    "connectionId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/office365",
                    "connectionName": "office365",
                    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/westus/managedApis/office365"
                },
                "rss": {
                    "connectionId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/rss",
                    "connectionName": "rss",
                    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/westus/managedApis/rss"
                }
            }
        }
    }
}

Mettez à jour les valeurs d’espace réservé avec vos propres informations :
1. Remplacez l’adresse e-mail de l’espace réservé ("To": "test@example.com"). Vous devez utiliser une adresse e-mail compatible avec les connecteurs Logic Apps. Pour plus d’informations, voir les Conditions préalables.
2. Remplacez des détails supplémentaires du connecteur si vous utilisez un connecteur de messagerie autre que le connecteur Office 365 Outlook.
3. Remplacez les valeurs d’abonnement de l’espace réservé (00000000-0000-0000-0000-000000000000) pour vos identificateurs de connexion (connectionId et id) sous le paramètre de connexion ($connections) par vos propres valeurs d’abonnement.
Enregistrez vos modifications.

Exemple de script

Notes

Cet exemple a été écrit pour l’interpréteur de commandes bash. Si vous souhaitez exécuter cet exemple dans un autre interpréteur de commandes, tel que Windows PowerShell ou l’invite de commandes, vous devrez peut-être apporter des modifications à votre script.

Avant d’exécuter cet exemple de script, exécutez la commande suivante pour vous connecter à Azure :


az login

Ensuite, accédez au répertoire dans lequel vous avez créé votre définition de workflow. Par exemple, si vous avez créé le fichier JSON de définition de workflow sur votre Bureau :


cd ~/Desktop

Exécutez alors ce script pour créer une application logique.


#!/bin/bash

# Create a resource group

az group create --name testResourceGroup --location westus

# Create your logic app

az logic workflow create --resource-group "testResourceGroup" --location "westus" --name "testLogicApp" --definition "testDefinition.json"

Nettoyer le déploiement

Une fois que vous avez fini d’utiliser l’exemple de script, exécutez la commande suivante pour supprimer votre groupe de ressources et toutes ses ressources imbriquées, y compris l’application logique.


az group delete --name testResourceGroup --yes

Explication du script

Cet exemple de script utilise les commandes suivantes pour créer un groupe de ressources et une application logique.

Commande	Notes
`az group create`	Crée un groupe de ressources dans lequel les ressources de votre application logique sont stockées.
`az logic workflow create`	Crée une application logique basée sur le workflow défini dans le paramètre `--definition`.
`az group delete`	Supprime un groupe de ressources et toutes ses ressources imbriquées.

Étapes suivantes

Pour plus d’informations sur l’interface Azure CLI, consultez la documentation relative à l’interface Azure CLI.

Vous trouverez des exemples supplémentaires de scripts CLI Logic Apps dans le navigateur d’exemples de code de Microsoft.

Partager via