Exemplo de script da CLI do Azure - criar um aplicativo lógico

Aplica-se a: Aplicativos Lógicos do Azure (Consumo)

Esse script cria um aplicativo lógico de exemplo por meio da extensão Aplicativos Lógicos da CLI do Azure, (az logic). Para obter um guia detalhado sobre como criar e gerenciar aplicativos lógicos por meio da CLI do Azure, consulte o Guia de início rápido de aplicativos lógicos para a CLI do Azure.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se não tiver uma subscrição do Azure, crie uma conta gratuita.
• A CLI do Azure instalada no seu computador local.
• A extensão de CLI do Azure para Aplicações Lógicas instalada no seu computador. Para instalar esta extensão, use este comando: az extension add --name logic
• Uma definição de fluxo de trabalho para seu aplicativo lógico. Esse arquivo JSON deve seguir o esquema de linguagem de definição de fluxo de trabalho.
• Uma ligação de API a uma conta de e-mail através de um conector de Aplicações Lógicas do Azure suportado no mesmo grupo de recursos que a sua aplicação lógica. Este exemplo usa o conector do Outlook do Office 365 , mas você também pode usar outros conectores, como Outlook.com.

Verificação de pré-requisitos

Valide seu ambiente antes de começar:

• Entre no portal do Azure e verifique se a sua assinatura está ativa executando az login.

• Verifique sua versão da CLI do Azure em um terminal ou janela de comando executando az --version. Para obter a versão mais recente, consulte as notas de versão mais recentes.

  • Se não tiver a versão mais recente, atualize a instalação seguindo o guia de instalação do seu sistema operativo ou plataforma.

Exemplo de explicação do fluxo de trabalho

Este exemplo de arquivo de definição de fluxo de trabalho cria o mesmo exemplo básico de fluxo de trabalho do aplicativo lógico de consumo como no início rápido do portal do Azure.

Este fluxo de trabalho de exemplo:

1. Especifica um esquema, $schema, para o aplicativo lógico.

2. Define um gatilho para o aplicativo lógico na lista de gatilhos, triggers. O gatilho repete-se (recurrence) a cada 3 horas. As ações são acionadas quando um novo item de feed é publicado (When_a_feed_item_is_published) para o RSS feed especificado (feedUrl).

3. Define uma ação para o aplicativo lógico na lista de ações, actions. A ação envia um email (Send_an_email_(V2)) através do Microsoft 365 com detalhes dos itens de feed RSS, conforme especificado na seção body (body) das entradas da ação (inputs).

Definição de fluxo de trabalho de exemplo

Antes de executar o script de exemplo, você deve primeiro criar uma definição de fluxo de trabalho de exemplo.

1. Crie um arquivo testDefinition.json JSON no seu computador.

2. Copie o seguinte conteúdo para o arquivo JSON:

   
   {
       "definition": {
           "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
           "actions": {
               "Send_an_email_(V2)": {
                   "inputs": {
                       "body": {
                           "Body": "<p>@{triggerBody()?['publishDate']}<br>\n@{triggerBody()?['title']}<br>\n@{triggerBody()?['primaryLink']}</p>",
                           "Subject": "@triggerBody()?['title']",
                           "To": "test@example.com"
                       },
                       "host": {
                           "connection": {
                               "name": "@parameters('$connections')['office365']['connectionId']"
                           }
                       },
                       "method": "post",
                       "path": "/v2/Mail"
                   },
                   "runAfter": {},
                   "type": "ApiConnection"
               }
           },
           "contentVersion": "1.0.0.0",
           "outputs": {},
           "parameters": {
               "$connections": {
                   "defaultValue": {},
                   "type": "Object"
               }
           },
           "triggers": {
               "When_a_feed_item_is_published": {
                   "inputs": {
                       "host": {
                           "connection": {
                               "name": "@parameters('$connections')['rss']['connectionId']"
                           }
                       },
                       "method": "get",
                       "path": "/OnNewFeed",
                       "queries": {
                           "feedUrl": "https://www.pbs.org/now/rss.xml"
                       }
                   },
                   "recurrence": {
                       "frequency": "Hour",
                       "interval": 3
                   },
                   "splitOn": "@triggerBody()?['value']",
                   "type": "ApiConnection"
               }
           }
       },
       "parameters": {
           "$connections": {
               "value": {
                   "office365": {
                       "connectionId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/office365",
                       "connectionName": "office365",
                       "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/westus/managedApis/office365"
                   },
                   "rss": {
                       "connectionId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/rss",
                       "connectionName": "rss",
                       "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/westus/managedApis/rss"
                   }
               }
           }
       }
   }
   
   

3. Atualize os valores do marcador de posição com as suas próprias informações:

   1. Substitua o endereço de e-mail do marcador de posição ("To": "test@example.com"). Você precisa usar um endereço de e-mail compatível com conectores de aplicativos lógicos. Para mais informações, consulte os pré-requisitos.

   2. Substitua detalhes adicionais do conector se estiver usando outro conector de email que não o conector do Outlook do Office 365.

   3. Substitua os valores de assinatura do placeholder (00000000-0000-0000-0000-000000000000) pelos seus identificadores de ligação (connectionId e id) no parâmetro de ligações ($connections) com os seus próprios valores de assinatura.

4. Salve suas alterações.

Exemplo de script

Antes de executar este script de exemplo, execute este comando para se conectar ao Azure:

az login

Em seguida, navegue até o diretório no qual você criou sua definição de fluxo de trabalho. Por exemplo, se você criou o arquivo JSON de definição de fluxo de trabalho na área de trabalho:

cd ~/Desktop

Em seguida, execute esse script para criar um aplicativo lógico.

#!/bin/bash

# Create a resource group

az group create --name testResourceGroup --___location westus

# Create your logic app

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

Limpeza da implantação

Depois de terminar de usar o script de exemplo, execute o seguinte comando para remover seu grupo de recursos e todos os seus recursos aninhados, incluindo o aplicativo lógico.

az group delete --name testResourceGroup --yes

Explicação do script

Este script de exemplo usa os seguintes comandos para criar um novo grupo de recursos e aplicativo lógico.

Próximos passos

Para obter mais informações sobre a CLI do Azure, consulte a documentação da CLI do Azure.

Você pode encontrar exemplos adicionais de script da CLI de Aplicativos Lógicos no navegador de exemplos de código da Microsoft.