Rövid útmutató: Munkafolyamatok létrehozása és kezelése az Azure CLI-vel az Azure Logic Appsben

Cikk
08/18/2024

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

Ez a rövid útmutató bemutatja, hogyan hozhat létre és kezelhet az Azure Logic Appsben futó automatizált munkafolyamatokat az Azure CLI Logic Apps bővítmény ( )az logic használatával. A parancssorból létrehozhat egy használatalapú logikai alkalmazást a több-bérlős Azure Logic Appsben a JSON-fájl használatával egy logikai alkalmazás munkafolyamat-definíciójához. Ezután kezelheti a logikai alkalmazást olyan műveletek futtatásával, mint lista , show (get), updateés delete a parancssorból.

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.

Ez a rövid útmutató jelenleg csak a több-bérlős Azure Logic Appsben futó Használat logikai alkalmazás munkafolyamatokra vonatkozik. Az Azure CLI jelenleg nem érhető el az egybérlős Azure Logic Appsben futó standard logikai alkalmazás-munkafolyamatokhoz. További információkért tekintse át az Azure Logic Apps erőforrástípus- és gazdagép-különbségeit.

Ha még nem ismerkedik az Azure Logic Apps szolgáltatással, megtudhatja, hogyan hozhatja létre első használatalapú logikai alkalmazás munkafolyamatát az Azure Portalon, a Visual Studióban és a Visual Studio Code-ban.

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épen telepített Azure CLI .
A számítógépre telepített Azure Logic Apps 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
Egy Azure-erőforráscsoport , amelyben létre szeretné hozni a logikai alkalmazást.

Előfeltételek ellenőrzése

Mielőtt hozzákezd, ellenőrizze a környezetét:

Jelentkezzen be az Azure Portalra, és futtassa az loginaz előfizetését.
Futtassa az Azure CLI verzióját egy terminál vagy parancsablakban 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.

Példa – Erőforráscsoport létrehozása

Ha még nem rendelkezik erőforráscsoporttal a logikai alkalmazáshoz, hozza létre a csoportot a paranccsal az group create. A következő parancs például létrehoz egy erőforráscsoportot testResourceGroup a helyen westus.

az group create --name testResourceGroup --location westus

A kimenet az provisioningState Succeeded erőforráscsoport sikeres létrehozásakor látható:

<...>
  "name": "testResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
<...>

Munkafolyamat-definíció

Mielőtt új logikai alkalmazást hoz létre, vagy egy meglévő logikai alkalmazást frissít az Azure CLI használatával, szüksége lesz egy munkafolyamat-definícióra a logikai alkalmazáshoz. Az Azure Portalon a logikai alkalmazás mögöttes munkafolyamat-definícióját JSON formátumban tekintheti meg, ha Tervező nézetről Kód nézetre vált.

Amikor futtatja a parancsokat a logikai alkalmazás létrehozásához vagy frissítéséhez, a munkafolyamat-definíciót a rendszer kötelező paraméterként (--definition) tölti fel. A munkafolyamat-definíciót JSON-fájlként kell létrehoznia, amely a munkafolyamat-definíció nyelvi sémáját követi.

Logikai alkalmazások létrehozása a parancssori felületről

Ha logikai alkalmazás munkafolyamatát az Azure CLI-ből szeretné létrehozni, használja a parancsot az logic workflow create egy JSON-fájllal a definícióhoz.

az logic workflow create --definition
                         --location
                         --name
                         --resource-group
                         [--access-control]
                         [--endpoints-configuration]
                         [--integration-account]
                         [--state {Completed, Deleted, Disabled, Enabled, NotSpecified, Suspended}]
                         [--tags]

A parancsnak tartalmaznia kell a következő kötelező paramétereket:

Paraméter	Érték	Leírás
Munkafolyamat-definíció	`--definition`	JSON-fájl a logikai alkalmazás munkafolyamat-definíciójával.
Hely	`--location -l`	Az Azure-régió, amelyben a logikai alkalmazás található.
Név	`--name -n`	A logikai alkalmazás neve. A név csak betűket, számokat, kötőjeleket (`-`), aláhúzásjeleket (`_`), zárójeleket (`()`) és pontokat (`.`) tartalmazhat. A névnek régiókon belül is egyedinek kell lennie.
Erőforráscsoport neve	`--resource-group -g`	Az Azure-erőforráscsoport , amelyben létre szeretné hozni a logikai alkalmazást. Mielőtt hozzákezdene, hozzon létre egy erőforráscsoportot , ha még nincs ilyen a logikai alkalmazáshoz.

További opcionális paramétereket is megadhat a logikai alkalmazás hozzáférés-vezérlőinek, végpontjainak, integrációs fiókjának, állapotának és erőforráscímkéinek konfigurálásához.

Példa – Logikai alkalmazás létrehozása

Ebben a példában egy elnevezett testLogicApp munkafolyamat jön létre a hely westuserőforráscsoportjábantestResourceGroup. A JSON-fájl testDefinition.json tartalmazza a munkafolyamat definícióját.

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

A munkafolyamat sikeres létrehozásakor a parancssori felület megjeleníti az új munkafolyamat-definíció JSON-kódját. Ha a munkafolyamat létrehozása sikertelen, tekintse meg a lehetséges hibák listáját.

Logikai alkalmazások frissítése parancssori felületről

Ha frissíteni szeretné egy logikai alkalmazás munkafolyamatát az Azure CLI-ből, használja a parancsot az logic workflow create.

A parancsnak ugyanazokat a szükséges paramétereket kell tartalmaznia , mint egy logikai alkalmazás létrehozásakor. Ugyanazokat a választható paramétereket is hozzáadhatja, mint egy logikai alkalmazás létrehozásakor.

az logic workflow create --definition
                         --location
                         --name
                         --resource-group
                         [--access-control]
                         [--endpoints-configuration]
                         [--integration-account]
                         [--integration-service-environment]
                         [--state {Completed, Deleted, Disabled, Enabled, NotSpecified, Suspended}]
                         [--tags]

Példa – Logikai alkalmazás frissítése

Ebben a példában az előző szakaszban létrehozott minta-munkafolyamat frissül, hogy egy másik JSON-definíciós fájlt használjon, newTestDefinition.jsonés adjon hozzá két erőforráscímkét és testTag1 testTag2 leírási értékeket.

az logic workflow create --resource-group "testResourceGroup" --location "westus" --name "testLogicApp" --definition "newTestDefinition.json" --tags "testTag1=testTagValue1" "testTag2=testTagValue"

A munkafolyamat sikeres frissítésekor a parancssori felület megjeleníti a logikai alkalmazás frissített munkafolyamat-definícióját. Ha a frissítés sikertelen, tekintse meg a lehetséges hibák listáját.

Logikai alkalmazások törlése a parancssori felületről

Ha törölni szeretné egy logikai alkalmazás munkafolyamatát az Azure CLI-ből, használja a parancsot az logic workflow delete.

A parancsnak tartalmaznia kell a következő kötelező paramétereket:

Paraméter	Érték	Leírás
Név	`--name -n`	A logikai alkalmazás neve.
Erőforráscsoport neve	`-resource-group -g`	Az az erőforráscsoport, amelyben a logikai alkalmazás található.

Opcionális paramétert is megadhat a megerősítési kérések kihagyásához. --yes -y

az logic workflow delete --name
                         --resource-group
                         [--yes]

A parancssori felület ezután kéri, hogy erősítse meg a logikai alkalmazás törlését. A megerősítő kérést kihagyhatja az opcionális paraméterrel --yes -y a parancs használatával.

Are you sure you want to perform this operation? (y/n):

A logikai alkalmazások törlésének megerősítéséhez listázhatja a logikai alkalmazásokat a parancssori felületen, vagy megtekintheti a logikai alkalmazásokat az Azure Portalon.

Példa – Logikai alkalmazás törlése

Ebben a példában az előző szakaszban létrehozott minta-munkafolyamat törlődik.

az logic workflow delete --resource-group "testResourceGroup" --name "testLogicApp"

Miután válaszolt a megerősítést kérő üzenetre y, a logikai alkalmazás törlődik.

Szempontok – Logikai alkalmazás törlése

A logikai alkalmazások törlése a munkafolyamat-példányokat a következő módokon érinti:

Az Azure Logic Apps mindent megtesz annak érdekében, hogy megszakítsa a folyamatban lévő és függőben lévő futtatásokat.

A legtöbb futtatás még nagy mennyiségű vagy hátralék esetén is megszakad, mielőtt befejeződnének vagy elindulnának. A lemondási folyamat azonban időt vehet igénybe. Eközben előfordulhat, hogy egyes futtatások végrehajtásra kerülnek, miközben a futtatókörnyezet a lemondási folyamaton keresztül működik.
Az Azure Logic Apps nem hoz létre vagy futtat új munkafolyamat-példányokat.
Ha töröl egy munkafolyamatot, majd újból létrehozza ugyanazt a munkafolyamatot, az újra létrehozott munkafolyamat nem rendelkezik ugyanazokkal a metaadatokkal, mint a törölt munkafolyamat. A törölt munkafolyamatnak nevezett munkafolyamatokat újra kell mentenie. Így a hívó megkapja a megfelelő információkat az újra létrehozott munkafolyamathoz. Ellenkező esetben az újra létrehozott munkafolyamat hívásai hibával meghiúsulnak Unauthorized . Ez a viselkedés azokra a munkafolyamatokra is vonatkozik, amelyek összetevőket használnak az Azure-függvényeket hívó integrációs fiókokban és munkafolyamatokban.

Logikai alkalmazások megjelenítése a parancssori felületen

Egy adott logikai alkalmazás munkafolyamatának lekéréséhez használja a parancsot az logic workflow show.

az logic workflow show --name
                       --resource-group

A parancsnak tartalmaznia kell a következő kötelező paramétereket

Paraméter	Érték	Leírás
Név	`--name -n`	A logikai alkalmazás neve.
Erőforráscsoport neve	`--resource-group -g`	Annak az erőforráscsoportnak a neve, amelyben a logikai alkalmazás található.

Példa – Logikai alkalmazás lekérése

Ebben a példában az erőforráscsoportban testResourceGroup található logikai alkalmazás testLogicApp teljes naplókkal jelenik meg a hibakereséshez.

az logic workflow show --resource-group "testResourceGroup" --name "testLogicApp" --debug

Logikai alkalmazások listázása a parancssori felületen

A logikai alkalmazások előfizetés szerinti listázásához használja a parancsot az logic workflow list. Ez a parancs a logikai alkalmazás munkafolyamatainak JSON-kódját adja vissza.

Az eredményeket a következő választható paraméterekkel szűrheti:

Paraméter	Érték	Leírás
Erőforráscsoport neve	`--resource-group -g`	Annak az erőforráscsoportnak a neve, amellyel szűrni szeretné az eredményeket.
Elemek száma	`--top`	Az eredményekben szereplő elemek száma.
Szűrő	`--filter`	A listán használt szűrő típusa. Szűrhet állapot (`State`), trigger (`Trigger`) és a hivatkozott erőforrás (`ReferencedResourceId`) azonosítója alapján.

az logic workflow list [--filter]
                       [--resource-group]
                       [--top]

Példa – Logikai alkalmazások listázása

Ebben a példában az erőforráscsoport testResourceGroup összes engedélyezett munkafolyamata ASCII-táblaformátumban jelenik meg.

az logic workflow list --resource-group "testResourceGroup" --filter "(State eq 'Enabled')" --output "table"

Errors

Az alábbi hiba azt jelzi, hogy az Azure Logic Apps CLI-bővítmény nincs telepítve. Kövesse a Logic Apps bővítmény számítógépre való telepítéséhez szükséges előfeltételek lépéseit.

az: 'logic' is not in the 'az' command group. See 'az --help'. If the command is from an extension, please make sure the corresponding extension is installed. To learn more about extensions, please visit https://learn.microsoft.com/cli/azure/azure-cli-extensions-overview

Az alábbi hiba azt jelezheti, hogy a munkafolyamat-definíció feltöltéséhez használt fájl elérési útja helytelen.

Expecting value: line 1 column 1 (char 0)

Globális paraméterek

A parancsokkal a következő választható globális Azure CLI-paramétereket használhatja az logic :

Paraméter	Érték	Leírás
Kimeneti formátum	`--output -o`	Módosítsa a kimeneti formátumot az alapértelmezett JSON-ról.
Csak a hibák megjelenítése	`--only-show-errors`	A figyelmeztetések mellőzése és csak a hibák megjelenítése.
Részletezés	`--verbose`	Részletes naplók megjelenítése.
Hibakeresés	`--debug`	Megjeleníti az összes hibakeresési naplót.
Súgóüzenet	`--help -h`	Súgó megjelenítése párbeszédpanel.
Lekérdezés	`--query`	JMESPath lekérdezési sztring beállítása JSON-kimenethez.

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 Azure Logic Apps CLI-szkriptmintákat is találhat a Microsoft kódminták böngészőjében.

Ezután létrehozhat egy példaalkalmazás-logikát az Azure CLI-vel egy példaszkript és egy munkafolyamat-definíció használatával.

Logikai alkalmazás létrehozása mintaszkript használatával.

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