Rychlý start: Vytváření a správa pracovních postupů pomocí Azure CLI v Azure Logic Apps

Článek
08/18/2024

Platí pro: Azure Logic Apps (Consumption)

V tomto rychlém startu se dozvíte, jak vytvářet a spravovat automatizované pracovní postupy spouštěné v Azure Logic Apps pomocí rozšíření Azure CLI Logic Apps (az logic). Z příkazového řádku můžete vytvořit aplikaci logiky Consumption ve víceklientské službě Azure Logic Apps pomocí souboru JSON pro definici pracovního postupu aplikace logiky. Aplikaci logiky pak můžete spravovat spuštěním operací, jako listjsou , show (get) updatea delete z příkazového řádku.

Upozorňující

Rozšíření Azure CLI Logic Apps je aktuálně experimentální a nevztahuje se na ně zákaznická podpora. Toto rozšíření rozhraní příkazového řádku používejte opatrně, zejména pokud se rozhodnete rozšíření používat v produkčních prostředích.

Tento rychlý start se v současné době vztahuje pouze na pracovní postupy aplikace logiky Consumption, které běží ve víceklientských azure Logic Apps. Azure CLI v současné době není k dispozici pro pracovní postupy standardní aplikace logiky, které běží v Azure Logic Apps s jedním tenantem. Další informace najdete v tématu Rozdíly typu prostředku a hostitele v Azure Logic Apps.

Pokud s Azure Logic Apps teprve začínáte, zjistěte, jak vytvořit první pracovní postup aplikace logiky Consumption na webu Azure Portal nebo v editoru Visual Studio Code.

Požadavky

Účet Azure s aktivním předplatným. Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet.
Rozhraní příkazového řádku Azure nainstalované na místním počítači.
Rozšíření Azure Logic Apps CLI nainstalované na vašem počítači. K instalaci tohoto rozšíření použijte tento příkaz: az extension add --name logic
Skupina prostředků Azure, ve které chcete vytvořit aplikaci logiky.

Kontrola požadovaných součástí

Než začnete, ověřte své prostředí:

Přihlaste se k webu Azure Portal a zkontrolujte, jestli je vaše předplatné aktivní spuštěním az login.
Spuštěním příkazu az --versionzkontrolujte verzi Azure CLI v terminálu nebo příkazovém okně. Nejnovější verzi najdete v nejnovější zprávě k vydání verze.

Pokud nemáte nejnovější verzi, aktualizujte instalaci podle průvodce instalací operačního systému nebo platformy.

Příklad – Vytvoření skupiny prostředků

Pokud ještě nemáte skupinu prostředků pro aplikaci logiky, vytvořte skupinu pomocí příkazu az group create. Například následující příkaz vytvoří skupinu prostředků pojmenovanou testResourceGroup v umístění westus.

az group create --name testResourceGroup --location westus

Výstup ukazuje, provisioningState jako Succeeded když se vaše skupina prostředků úspěšně vytvořila:

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

Definice pracovního postupu

Před vytvořením nové aplikace logiky nebo aktualizací existující aplikace logiky pomocí Azure CLI potřebujete definici pracovního postupu pro aplikaci logiky. Na webu Azure Portal můžete zobrazit základní definici pracovního postupu aplikace logiky ve formátu JSON přepnutím ze zobrazení Návrháře na zobrazení kódu.

Když spustíte příkazy pro vytvoření nebo aktualizaci aplikace logiky, definice pracovního postupu se nahraje jako povinný parametr (--definition). Definici pracovního postupu musíte vytvořit jako soubor JSON, který se řídí schématem jazyka definice pracovního postupu.

Vytváření aplikací logiky z rozhraní příkazového řádku

Pokud chcete vytvořit pracovní postup aplikace logiky z Azure CLI, použijte příkaz az logic workflow create se souborem JSON pro definici.

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

Příkaz musí obsahovat následující požadované parametry:

Parametr	Hodnota	Popis
Definice pracovního postupu	`--definition`	Soubor JSON s definicí pracovního postupu vaší aplikace logiky.
Umístění	`--location -l`	Oblast Azure, ve které se nachází vaše aplikace logiky.
Název	`--name -n`	Název aplikace logiky Název může obsahovat pouze písmena, číslice, pomlčky (`-`), podtržítka (`_`), závorky (`()`) a tečky (`.`). Název musí být také jedinečný napříč oblastmi.
Název skupiny prostředků	`--resource-group -g`	Skupina prostředků Azure, ve které chcete vytvořit aplikaci logiky. Než začnete, vytvořte skupinu prostředků, pokud ji ještě nemáte pro aplikaci logiky.

Můžete také zahrnout další volitelné parametry pro konfiguraci řízení přístupu aplikace logiky, koncových bodů, účtu integrace, stavu a značek prostředků.

Příklad – Vytvoření aplikace logiky

V tomto příkladu je pracovní testLogicApp postup vytvořen ve skupině testResourceGroup prostředků v umístění westus. Soubor testDefinition.json JSON obsahuje definici pracovního postupu.

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

Po úspěšném vytvoření pracovního postupu se v rozhraní příkazového řádku zobrazí kód JSON nové definice pracovního postupu. Pokud se vytvoření pracovního postupu nezdaří, podívejte se na seznam možných chyb.

Aktualizace aplikací logiky z rozhraní příkazového řádku

Pokud chcete aktualizovat pracovní postup aplikace logiky z Azure CLI, použijte příkaz az logic workflow create.

Příkaz musí obsahovat stejné požadované parametry jako při vytváření aplikace logiky. Můžete také přidat stejné volitelné parametry jako při vytváření aplikace logiky.

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říklad – aktualizace aplikace logiky

V tomto příkladu se ukázkový pracovní postup vytvořený v předchozí části aktualizuje tak, aby používal jiný definiční soubor JSON, newTestDefinition.jsona přidal dvě značky testTag1 prostředků a testTag2 s hodnotami popisu.

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

Po úspěšné aktualizaci pracovního postupu zobrazí rozhraní příkazového řádku aktualizovanou definici pracovního postupu vaší aplikace logiky. Pokud vaše aktualizace selže, podívejte se na seznam možných chyb.

Odstranění aplikací logiky z rozhraní příkazového řádku

Pokud chcete odstranit pracovní postup aplikace logiky z Azure CLI, použijte příkaz az logic workflow delete.

Příkaz musí obsahovat následující požadované parametry:

Parametr	Hodnota	Popis
Name	`--name -n`	Název aplikace logiky
Název skupiny prostředků	`-resource-group -g`	Skupina prostředků, ve které se nachází vaše aplikace logiky.

Můžete také zahrnout volitelný parametr pro přeskočení potvrzovacích výzev, --yes -y.

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

Rozhraní příkazového řádku vás pak vyzve k potvrzení odstranění aplikace logiky. Výzvu k potvrzení můžete přeskočit pomocí volitelného parametru --yes -y s příkazem.

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

Pokud chcete potvrdit odstranění aplikace logiky, zobrazte seznam aplikací logiky v rozhraní příkazového řádku nebo zobrazte aplikace logiky na webu Azure Portal.

Příklad – Odstranění aplikace logiky

V tomto příkladu se odstraní ukázkový pracovní postup vytvořený v předchozí části .

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

Jakmile odpovíte na výzvu k potvrzení, yaplikace logiky se odstraní.

Důležité informace – Odstranění aplikace logiky

Odstranění aplikace logiky ovlivňuje instance pracovního postupu následujícími způsoby:

Azure Logic Apps se snaží zrušit probíhající a čekající spuštění.

I u velkého svazku nebo backlogu se většina spuštění před dokončením nebo spuštěním zruší. Dokončení procesu zrušení ale může chvíli trvat. Mezitím se některá spuštění můžou vyzvednout ke spuštění, zatímco modul runtime funguje prostřednictvím procesu zrušení.
Azure Logic Apps nevytvoří ani nespouští nové instance pracovních postupů.
Pokud pracovní postup odstraníte a pak znovu vytvoříte stejný pracovní postup, znovu vytvořený pracovní postup nebude mít stejná metadata jako odstraněný pracovní postup. Musíte znovu vytvořit libovolný pracovní postup, který se nazývá odstraněný pracovní postup. Volající tak získá správné informace pro znovu vytvořený pracovní postup. V opačném případě volání znovu vytvořený pracovní postup selže s chybou Unauthorized . Toto chování platí také pro pracovní postupy, které používají artefakty v účtech integrace a pracovních postupech, které volají funkce Azure Functions.

Zobrazení aplikací logiky v rozhraní příkazového řádku

Pokud chcete získat konkrétní pracovní postup aplikace logiky, použijte příkaz az logic workflow show.

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

Příkaz musí obsahovat následující požadované parametry.

Parametr	Hodnota	Popis
Name	`--name -n`	Název aplikace logiky
Název skupiny prostředků	`--resource-group -g`	Název skupiny prostředků, ve které se nachází vaše aplikace logiky.

Příklad – Získání aplikace logiky

V tomto příkladu se aplikace testLogicApp logiky ve skupině testResourceGroup prostředků vrátí s úplnými protokoly pro ladění.

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

Výpis aplikací logiky v rozhraní příkazového řádku

Pokud chcete zobrazit seznam aplikací logiky podle předplatného, použijte příkaz az logic workflow list. Tento příkaz vrátí kód JSON pro pracovní postupy aplikace logiky.

Výsledky můžete filtrovat podle následujících volitelných parametrů:

Parametr	Hodnota	Popis
Název skupiny prostředků	`--resource-group -g`	Název skupiny prostředků, podle které chcete filtrovat výsledky.
Počet položek	`--top`	Počet položek, které jsou součástí výsledků
Filtrovat	`--filter`	Typ filtru, který používáte v seznamu. Můžete filtrovat podle stavu (`State`), triggeru (`Trigger`) a identifikátoru odkazovaného prostředku (`ReferencedResourceId`).

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

Příklad – Výpis aplikací logiky

V tomto příkladu se vrátí všechny povolené pracovní postupy ve skupině testResourceGroup prostředků ve formátu tabulky ASCII.

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

Chyby

Následující chyba značí, že není nainstalované rozšíření Azure Logic Apps CLI. Podle pokynů v požadavcích nainstalujte rozšíření Logic Apps do počítače.

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

Následující chyba může znamenat, že cesta k souboru pro nahrání definice pracovního postupu je nesprávná.

Expecting value: line 1 column 1 (char 0)

Globální parametry

Ke svým az logic příkazům můžete použít následující volitelné globální parametry Azure CLI:

Parametr	Hodnota	Popis
Výstupní formát	`--output -o`	Změňte výstupní formát z výchozího formátu JSON.
Zobrazit pouze chyby	`--only-show-errors`	Potlačit upozornění a zobrazit pouze chyby.
Podrobnosti	`--verbose`	Umožňuje zobrazit podrobné protokoly.
Ladění	`--debug`	Zobrazí všechny protokoly ladění.
Zpráva nápovědy	`--help -h`	Zobrazit dialogové okno nápovědy
Dotaz	`--query`	Nastavte řetězec dotazu JMESPath pro výstup JSON.

Další kroky

Další informace o Azure CLI najdete v dokumentaci k Azure CLI.

Další ukázky skriptů azure Logic Apps CLI najdete v prohlížeči ukázek kódu Od Microsoftu.

Dále můžete vytvořit ukázkovou logiku aplikace prostřednictvím Azure CLI pomocí ukázkového skriptu a definice pracovního postupu.

Vytvoření aplikace logiky pomocí ukázkového skriptu

Sdílet prostřednictvím