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

Platí pro: Azure Logic Apps (Consumption)

V tomto rychlém startu se dozvíte, jak vytvářet a spravovat automatizované pracovní postupy, které běží 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 v Azure Logic Apps s více tenanty pomocí souboru JSON pro definici pracovního postupu aplikace logiky. Aplikaci logiky pak můžete spravovat spuštěním operací, jako listje , show (get) updatea delete z příkazového řádku.

Upozornění

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

Tento rychlý start se v současné době vztahuje jenom na pracovní postupy aplikace logiky Consumption, které běží v Azure Logic Apps s více tenanty. Azure CLI v současné době není k dispozici pro pracovní postupy aplikací logiky Standard, 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 prostřednictvím webu Azure Portal, v sadě Visual Studio a v editoru Visual Studio Code.

Požadavky

Kontrola předpokladů

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

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]
                         [--integration-service-environment]
                         [--state {Completed, Deleted, Disabled, Enabled, NotSpecified, Suspended}]
                         [--tags]

Váš 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 aplikace logiky
Umístění --location -l Oblast Azure, ve které se nachází vaše aplikace logiky.
Name --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, prostředí integrační služby, stavu a značek prostředků.

Příklad – Vytvoření aplikace logiky

V tomto příkladu se ve skupině testResourceGroup prostředků v umístění westusvytvoří pracovní postup s názvem testLogicApp . 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, newTestDefinition.jsonaby používal jiný definiční soubor JSON, a 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 se v rozhraní příkazového řádku zobrazí aktualizovaná definice pracovního postupu aplikace logiky. Pokud se aktualizace nezdaří, 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.

Váš příkaz musí obsahovat následující požadované parametry:

Parametr Hodnota Popis
Název --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 , který přeskočí potvrzovací výzvy, --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. Potvrzovací výzvu můžete přeskočit pomocí volitelného parametru --yes -y s vaším příkazem.

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

Pokud chcete potvrdit odstranění aplikace logiky, vypište aplikace 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ích postupů 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 nějakou dobu trvat. Mezitím se některé spuštění můžou vyzvednout pro 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, nebude mít znovu vytvořený pracovní postup 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. Jinak volání znovu vytvořených pracovních postupů selžou s chybou Unauthorized . Toto chování platí také pro pracovní postupy, které používají artefakty v účtech integrace a pracovních postupech, které volají 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

Váš příkaz musí obsahovat následující požadované parametry.

Parametr Hodnota Popis
Název --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í vašich výsledků.
Filtrovat --filter Typ filtru, který používáte v seznamu. Můžete filtrovat podle stavu (), triggeru (StateTrigger) 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 všechny povolené pracovní postupy ve skupině testResourceGroup prostředků vrátí 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 rozšíření Azure Logic Apps CLI není nainstalované. 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://docs.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

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

Parametr Hodnota Popis
Formát výstupu --output -o Změňte výstupní formát z výchozího formátu JSON.
Zobrazit pouze chyby --only-show-errors Potlačí upozornění a zobrazí pouze chyby.
Verbose --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 Microsoftu.

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