Azure CLI-példaszkript – logikai alkalmazás létrehozása

Cikk
01/04/2024

A következőkre vonatkozik: Azure Logic Apps (használat)

Ez a szkript létrehoz egy minta logikai alkalmazást az Azure CLI Logic Apps bővítményenaz logic (). A logikai alkalmazások Azure CLI-vel történő létrehozásával és kezelésével kapcsolatos részletes útmutatóért tekintse meg az Azure CLI Logic Apps rövid útmutatóját.

Figyelmeztetés

Az Azure CLI Logic Apps-bővítmény jelenleg kísérleti jellegű , és nem vonatkozik az ügyfélszolgálatra. Ezt a CLI-bővítményt óvatosan használja, különösen akkor, ha éles környezetben használja a bővítményt.

Előfeltételek

Egy Azure-fiók, aktív előfizetéssel. Ha nem rendelkezik Azure-előfizetéssel, hozzon létre egy ingyenes fiókot.
A helyi számítógépre telepített Azure CLI .
A számítógépre telepített Logic Apps Azure CLI-bővítmény . A bővítmény telepítéséhez használja a következő parancsot: az extension add --name logic
A logikai alkalmazás munkafolyamat-definíciója . Ennek a JSON-fájlnak a Munkafolyamat-definíció nyelvi sémáját kell követnie.
API-kapcsolat egy e-mail-fiókhoz egy támogatott Azure Logic Apps-összekötőn keresztül, ugyanabban az erőforráscsoportban, mint a logikai alkalmazás. Ez a példa az Office 365 Outlook-összekötőt használja, de más összekötőket is használhat, például Outlook.com.

Előfeltételek ellenőrzése

A kezdés előtt ellenőrizze a környezetet:

Jelentkezzen be a Azure Portal, és a futtatásával az loginellenőrizze, hogy az előfizetés aktív-e.
Ellenőrizze az Azure CLI verzióját egy terminálban vagy parancsablakban a futtatásával az --version. A legújabb verzióért tekintse meg a legújabb kibocsátási megjegyzéseket.
- Ha nem a legújabb verzióval rendelkezik, frissítse a telepítést az operációs rendszer vagy a platform telepítési útmutatójának követésével.

Munkafolyamat-minta magyarázata

Ez a példa munkafolyamat-definíciós fájl ugyanazt az alapvető példát hozza létre, mint a Használat logikai alkalmazás munkafolyamata, mint a Azure Portal rövid útmutatójában.

Ez a minta-munkafolyamat:

A logikai alkalmazás sémáját $schemaadja meg.
A logikai alkalmazás eseményindítóját határozza meg az eseményindítók listájában. triggers Az eseményindító 3 óránként ismétlődik (recurrence). A műveletek akkor aktiválódnak, ha új hírcsatornaelemet tesznek közzé (When_a_feed_item_is_published) a megadott RSS-hírcsatornához (feedUrl).
A logikai alkalmazáshoz tartozó műveletet definiálja a műveletek listájában. actions A művelet e-mailt (Send_an_email_(V2)) küld a Microsoft 365-on keresztül a művelet bemeneteinek törzsszakaszában (body) megadott RSS-hírcsatorna-elemek részleteivel (inputs).

Minta munkafolyamat-definíció

A mintaszkript futtatása előtt létre kell hoznia egy minta munkafolyamat-definíciót.

Hozzon létre egy JSON-fájlt testDefinition.json a számítógépen.

Másolja a következő tartalmat a JSON-fájlba:


{
    "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"
                }
            }
        }
    }
}

Frissítse a helyőrző értékeket a saját adataival:
1. Cserélje le a helyőrző e-mail-címét ("To": "test@example.com"). A Logic Apps-összekötőkkel kompatibilis e-mail-címet kell használnia. További információkért tekintse meg az előfeltételeket.
2. Cserélje le az összekötő további adatait, ha az outlook-összekötőnél más e-mail-összekötőt használ, mint az Office 365 Outlook-összekötőt.
3. Cserélje le a kapcsolatazonosítók (és id) helyőrző előfizetési értékeit (00000000-0000-0000-0000-000000000000connectionId) a kapcsolatparaméterben ($connections) a saját előfizetési értékeire.
Mentse a módosításokat.

Példaszkript

Megjegyzés

Ez a minta a bash rendszerhéjhoz van megírva. Ha ezt a mintát egy másik rendszerhéjban , például Windows PowerShell vagy parancssorban szeretné futtatni, előfordulhat, hogy módosítania kell a szkriptet.

A mintaszkript futtatása előtt futtassa ezt a parancsot az Azure-hoz való csatlakozáshoz:


az login

Ezután lépjen arra a könyvtárra, amelyben létrehozta a munkafolyamat-definíciót. Ha például létrehozta a munkafolyamat-definíciós JSON-fájlt az asztalon:


cd ~/Desktop

Ezután futtassa ezt a szkriptet egy logikai alkalmazás létrehozásához.


#!/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"

Az üzemelő példány eltávolítása

Miután befejezte a mintaszkript használatát, futtassa az alábbi parancsot az erőforráscsoport és az összes beágyazott erőforrás eltávolításához, beleértve a logikai alkalmazást is.


az group delete --name testResourceGroup --yes

Szkript ismertetése

Ez a példaszkript a következő parancsokat használja egy új erőforráscsoport és logikai alkalmazás létrehozásához.

Parancs	Jegyzetek
`az group create`	Létrehoz egy erőforráscsoportot, amelyben a logikai alkalmazás erőforrásai tárolódnak.
`az logic workflow create`	Létrehoz egy logikai alkalmazást a paraméterben `--definition`definiált munkafolyamat alapján.
`az group delete`	Töröl egy erőforráscsoportot és annak összes beágyazott erőforrását.

Következő lépések

Az Azure CLI-vel kapcsolatos további információkért tekintse meg az Azure CLI dokumentációját.

További Logic Apps CLI-szkriptmintákat találhat a Microsoft kódmintákat tartalmazó böngészőjében.

Megosztás a következőn keresztül: