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

Cikk
01/04/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álat 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 logikaialkalmazás-munkafolyamatokhoz. További információ: Erőforrástípus- és gazdagép-különbségek az Azure Logic Appsben.

Ha még nem ismerkedik az Azure Logic Appsszel, megtudhatja, hogyan hozhatja létre az első használatalapú logikai alkalmazás munkafolyamatát a Azure Portal, 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épre 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 kell hoznia a logikai alkalmazást.

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.

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 nevű testResourceGroup erőforráscsoportot a helyen westus.

az group create --name testResourceGroup --location westus

A kimenet a provisioningState következőképpen jelenik meg, mint Succeeded amikor az erőforráscsoport sikeresen létrejött:

<...>
  "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. A Azure Portal 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 rendszer feltölti a munkafolyamat-definíciót kötelező paraméterként (--definition). 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 logikaialkalmazás-munkafolyamatot szeretne létrehozni az Azure CLI-ből, 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]
                         [--integration-service-environment]
                         [--state {Completed, Deleted, Disabled, Enabled, NotSpecified, Suspended}]
                         [--tags]

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

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 Az Azure-régió, amelyben a logikai alkalmazás található.
Name	`--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 a régiók között 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 választható paramétereket is megadhat a logikai alkalmazás hozzáférés-vezérlőinek, végpontjainak, integrációs fiókjának, integrációs szolgáltatási környezetének, állapot- és erőforráscímkéinek konfigurálásához.

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

Ebben a példában egy nevű testLogicApp munkafolyamat jön létre a hely westuserőforráscsoportjábantestResourceGroup. A JSON-fájl testDefinition.json tartalmazza a munkafolyamat-definíció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 a 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, testTag1 valamint 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 a következő kötelező paramétereket kell tartalmaznia:

Paraméter	Érték	Leírás
Name (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ó.

A megerősítő kérések kihagyásához opcionális paramétert is megadhat( --yes -y).

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

A parancssori felület ezután megké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á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 a Azure Portal.

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ő üzenetre a következővel y: , a logikai alkalmazás törlődik.

Megfontolandó 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.

Még nagy kötet vagy hátralék esetén is a legtöbb futtatás le lesz szakítva a befejezés vagy a kezdés előtt. A lemondási folyamat azonban időbe telhet. 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 újra 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 munkafolyamatot ú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
Name (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 visszaadja a logikaialkalmazás-munkafolyamatok JSON-kódját.

Az eredményeket a következő választható paraméterek alapján 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 azonosítója (`ReferencedResourceId`) 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"

Hibák

Az alábbi hiba azt jelzi, hogy az Azure Logic Apps CLI-bővítmény nincs telepítve. A Logic Apps-bővítmény számítógépre való telepítéséhez kövesse az előfeltételekben szereplő lépéseket.

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ének fájlelé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észletes	`--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ó párbeszédpanel megjelenítése.
Lekérdezés	`--query`	Állítson be egy JMESPath lekérdezési sztringet a 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 találhat a Microsoft kódmintákat tartalmazó 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 példaszkript használatával.