Guida introduttiva: Creare e gestire flussi di lavoro con l'interfaccia della riga di comando di Azure in App per la logica di Azure

  • Articolo

Si applica a: App per la logica di Azure (A consumo)

Questa guida introduttiva illustra come creare e gestire flussi di lavoro automatizzati eseguiti in App per la logica di Azure usando l'estensione App per la logica dell'interfaccia della riga di comando di Azure (az logic). Dalla riga di comando è possibile creare un'app per la logica a consumo in App per la logica di Azure multi-tenant usando il file JSON per una definizione del flusso di lavoro dell'app per la logica. È quindi possibile gestire l'app per la logica eseguendo operazioni come list, show (get), update e delete dalla riga di comando.

Avviso

L'estensione app per la logica dell'interfaccia della riga di comando di Azure è attualmente sperimentale e non è coperta dall'assistenza clienti. Usare questa estensione dell'interfaccia della riga di comando con cautela, soprattutto se si sceglie di usare l'estensione negli ambienti di produzione.

Questo argomento di avvio rapido si applica attualmente solo ai flussi di lavoro dell'app per la logica a consumo eseguiti in App per la logica di Azure multi-tenant. L'interfaccia della riga di comando di Azure non è attualmente disponibile per i flussi di lavoro dell'app per la logica Standard eseguiti in App per la logica di Azure a tenant singolo. Per altre informazioni, vedere Differenze tra tipo di risorsa e host in App per la logica di Azure.

Se non si ha familiarità con App per la logica di Azure, informazioni su come creare il primo flusso di lavoro dell'app per la logica a consumo tramite il portale di Azure, in Visual Studio e in Visual Studio Code.

Prerequisiti

  • Un account Azure con una sottoscrizione attiva. Se non hai una sottoscrizione di Azure, crea un account gratuito.

  • L'interfaccia della riga di comando di Azure installata nel computer locale.

  • Estensione dell'interfaccia della riga di comando di App per la logica di Azure installata nel computer. Per installare questa estensione, usare il comando seguente: az extension add --name logic

  • Un gruppo di risorse di Azure in cui creare un'app per la logica.

Verifica dei prerequisiti

Prima di iniziare, convalidare l'ambiente:

Esempio - Creare un gruppo di risorse

Se non si dispone già di un gruppo di risorse per l'app per la logica, crearlo con il comando az group create. Il comando seguente ad esempio crea un gruppo di risorse denominato testResourceGroup nella posizione westus.

az group create --name testResourceGroup --location westus

L'output mostra provisioningState come Succeeded quando il gruppo di risorse viene creato correttamente:

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

Definizione flusso di lavoro

Prima di creare una nuova app per la logica o di aggiornare un'app per la logica esistente usando l'interfaccia della riga di comando di Azure, è necessaria una definizione flusso di lavoro per l'app per la logica. Nel portale di Azure è possibile visualizzare la definizione flusso di lavoro sottostante dell'app per la logica in formato JSON passando dalla visualizzazione Finestra di progettazione a Visualizzazione codice.

Quando si eseguono i comandi per creare o aggiornare l'app per la logica, la definizione flusso di lavoro viene caricata come parametro obbligatorio (--definition). È necessario creare la definizione flusso di lavoro come file JSON che segue lo schema del linguaggio di definizione flusso di lavoro.

Creare app per la logica dall'interfaccia della riga di comando

Per creare un flusso di lavoro dell'app per la logica dall'interfaccia della riga di comando di Azure, usare il comando az logic workflow create con un file JSON per la definizione.

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

Il comando deve includere i parametri obbligatori seguenti:

Parametro valore Descrizione
Definizione flusso di lavoro --definition File JSON con la definizione flusso di lavoro dell'app per la logica.
Ufficio --location -l Area di Azure in cui si trova l'app per la logica.
Nome --name -n Nome dell'app per la logica. Il nome può contenere solo lettere, numeri, trattini (-), caratteri di sottolineatura (_), parentesi (()) e punti (.). Il nome inoltre deve essere univoco tra le aree.
Nome gruppo di risorse --resource-group -g Gruppo di risorse di Azure in cui si intende creare un'app per la logica. Prima di iniziare, creare un gruppo di risorse se non ne è già presente uno per l'app per la logica.

È anche possibile includere parametri facoltativi aggiuntivi per configurare i controlli di accesso, gli endpoint, l'account di integrazione, lo stato e i tag delle risorse dell'app per la logica.

Esempio - Creare un'app per la logica

In questo esempio viene creato un flusso di lavoro denominato testLogicApp nel gruppo di risorse testResourceGroup nella posizione westus. Il file JSON testDefinition.json contiene la definizione flusso di lavoro.

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

Quando il flusso di lavoro viene creato correttamente, l'interfaccia della riga di comando mostra il codice JSON della nuova definizione flusso di lavoro. Se la creazione del flusso di lavoro non riesce, vedere l'elenco dei possibili errori.

Aggiornare app per la logica dall'interfaccia della riga di comando

Per aggiornare il flusso di lavoro di un'app per la logica dall'interfaccia della riga di comando di Azure, usare il comando az logic workflow create.

Il comando deve includere gli stessi parametri obbligatori usati quando si crea un'app per la logica. È anche possibile aggiungere gli stessi parametri facoltativi usati per la creazione di un'app per la logica.

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]

Esempio - Aggiornare l'app per la logica

In questo esempio il flusso di lavoro di esempio creato nella sezione precedente viene aggiornato in modo da usare un file di definizione JSON diverso, newTestDefinition.json, e aggiungere due tag di risorsa testTag1 e testTag2 con valori di descrizione.

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

Quando il flusso di lavoro viene aggiornato correttamente, l'interfaccia della riga di comando mostra la definizione flusso di lavoro aggiornata dell'app per la logica. Se l'aggiornamento non riesce, vedere l'elenco dei possibili errori.

Eliminare app per la logica dall'interfaccia della riga di comando

Per eliminare il flusso di lavoro di un'app per la logica dall'interfaccia della riga di comando di Azure, usare il comando az logic workflow delete.

Il comando deve includere i parametri obbligatori seguenti:

Parametro valore Descrizione
Name --name -n Nome dell'app per la logica.
Nome gruppo di risorse -resource-group -g Gruppo di risorse in cui si trova l'app per la logica.

È anche possibile includere un parametro facoltativo, --yes -y, per ignorare le richieste di conferma.

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

L'interfaccia della riga di comando chiede quindi di confermare l'eliminazione dell'app per la logica. È possibile ignorare la richiesta di conferma usando con il comando il parametro facoltativo --yes -y.

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

Per confermare l'eliminazione di un'app per la logica, elencare le app per la logica nell'interfaccia della riga di comando o visualizzare le app per la logica nel portale di Azure.

Esempio - Eliminare un'app per la logica

In questo esempio viene eliminato il flusso di lavoro di esempio creato in una sezione precedente.

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

Dopo aver risposto alla richiesta di conferma con y, l'app per la logica viene eliminata.

Considerazioni - Eliminare l'app per la logica

L'eliminazione di un'app per la logica influisce sulle istanze del flusso di lavoro nei modi seguenti:

  • App per la logica di Azure fa il massimo sforzo per annullare le esecuzioni in corso e in sospeso.

    Anche con un volume o un backlog di grandi dimensioni, la maggior parte delle esecuzioni viene annullata prima del completamento o dell'avvio. Tuttavia, il processo di annullamento potrebbe richiedere tempo. Nel frattempo, alcune esecuzioni potrebbero essere prelevate per l'esecuzione mentre il runtime funziona tramite il processo di annullamento.

  • App per la logica di Azure non crea o esegue nuove istanze del flusso di lavoro.

  • Se si elimina un flusso di lavoro e quindi si ricrea lo stesso flusso di lavoro, il flusso di lavoro ricreato non avrà gli stessi metadati del flusso di lavoro eliminato. È necessario ricampionare qualsiasi flusso di lavoro che ha chiamato il flusso di lavoro eliminato. In questo modo, il chiamante ottiene le informazioni corrette per il flusso di lavoro ricreato. In caso contrario, le chiamate al flusso di lavoro ricreato hanno esito negativo con un errore Unauthorized. Questo comportamento si applica anche ai flussi di lavoro che usano artefatti negli account di integrazione e nei flussi di lavoro che chiamano funzioni di Azure.

Mostrare le app per la logica nell'interfaccia della riga di comando

Per ottenere un flusso di lavoro specifico dell'app per la logica, usare il comando az logic workflow show.

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

Il comando deve includere i parametri obbligatori seguenti:

Parametro valore Descrizione
Name --name -n Nome dell'app per la logica.
Nome gruppo di risorse --resource-group -g Nome del gruppo di risorse in cui si trova l'app per la logica.

Esempio - Ottenere un'app per la logica

In questo esempio viene restituita l'app per la logica testLogicApp nel gruppo di risorse testResourceGroup con log completi per il debug.

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

Elencare le app per la logica nell'interfaccia della riga di comando

Per elencare le app per la logica per sottoscrizione, usare il comando az logic workflow list. Questo comando restituisce il codice JSON per i flussi di lavoro dell'app per la logica.

È possibile filtrare i risultati in base ai parametri facoltativi seguenti:

Parametro valore Descrizione
Nome gruppo di risorse --resource-group -g Nome del gruppo di risorse in base al quale filtrare i risultati.
Numero di articoli --top Numero di elementi inclusi nei risultati.
Filtro --filter Tipo di filtro che si sta usando nell'elenco. È possibile filtrare in base allo stato (State), al trigger (Trigger) e all'identificatore della risorsa a cui si fa riferimento (ReferencedResourceId). 
az logic workflow list [--filter]
                       [--resource-group]
                       [--top]

Esempio - Elencare le app per la logica

In questo esempio vengono restituiti tutti i flussi di lavoro abilitati nel gruppo di risorse testResourceGroup in un formato di tabella ASCII.

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

Errori

L'errore seguente indica che l'estensione app per la logica dell'interfaccia della riga di comando di Azure non è installata. Seguire la procedura descritta nella sezione relativa ai prerequisiti per installare l'estensione app per la logica nel computer.

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://video2.skills-academy.com/cli/azure/azure-cli-extensions-overview

L'errore seguente potrebbe indicare che il percorso di file per il caricamento della definizione flusso di lavoro non è corretto.

Expecting value: line 1 column 1 (char 0)

Parametri globali

Con i comandi az logic è possibile usare i parametri facoltativi globali dell'interfaccia della riga di comando di Azure seguenti:

Parametro valore Descrizione
Formato di output --output -o Cambia il formato di output rispetto al formato JSON predefinito.
Mostra solo errori --only-show-errors Non visualizza gli avvisi e mostra solo gli errori.
Verbose --verbose Mostra log dettagliati.
Debug --debug Mostra tutti i log di debug.
Messaggio di aiuto --help -h Visualizza la finestra della Guida.
Query --query Imposta una stringa di query JMESPath per l'output JSON.

Passaggi successivi

Per altre informazioni sull'interfaccia della riga di comando di Azure, vedere la documentazione sull'interfaccia della riga di comando di Azure.

È possibile trovare altri esempi di script dell'interfaccia della riga di comando App per la logica di Azure nel browser degli esempi di codice di Microsoft.

Successivamente, è possibile creare un'app per la logica di esempio tramite l'interfaccia della riga di comando di Azure usando una definizione del flusso di lavoro e uno script di esempio.

Creare un'app per la logica con uno script di esempio.