Editar configurações de aplicativo e host para aplicativos lógicos Standard nos Aplicativos Lógicos do Azure de locatário único

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

Este guia explica como gerenciar configurações de runtime e ambiente para aplicativos lógicos Standard em Aplicativos Lógicos do Azure de locatário único.

As configurações do aplicativo para um aplicativo lógico Standard especificam as opções de configuração global que afetam todos os fluxos de trabalho nesse aplicativo lógico. No entanto, essas configurações se aplicam somente quando esses fluxos de trabalho são executados em seu ambiente de desenvolvimento local. Durante a execução local, os fluxos de trabalho podem acessar essas configurações de aplicativo como variáveis de ambiente local, que são usadas por ferramentas de desenvolvimento locais para valores que geralmente podem trocar de ambiente. Por exemplo, esses valores podem conter cadeias de conexão. Quando você faz a implantação no Azure, as configurações de aplicativo são ignoradas e não são incluídas na implantação.

Seu aplicativo lógico também tem configurações de host, que especificam as configurações de runtime e os valores que se aplicam a todos os fluxos de trabalho nesse aplicativo lógico, por exemplo, valores padrão para taxa de transferência, capacidade, tamanho de dados e assim por diante, sejam eles executados localmente ou no Azure.

As configurações são pares chave-valor que definem o nome e o valor da configuração.

Configurações de aplicativo, parâmetros e implantação

Em aplicativos lógicos multilocatários do Azure, a implantação depende de modelos do Azure Resource Manager (modelos do ARM), que integram e gerenciam o provisionamento de recursos tanto para os aplicativos lógicos quanto para a infraestrutura. Esse design representa um desafio quando você precisa manter variáveis de ambiente para aplicativos lógicos entre vários ambientes de desenvolvimento, teste e produção. Em um modelo do ARM, tudo é definido na implantação. Se você tiver que alterar apenas uma variável, precisará reimplantar tudo.

Nos Aplicativos Lógicos do Azure de locatário único , a implantação fica mais fácil porque você pode separar o provisionamento de recursos entre aplicativos e infraestrutura. Você pode usar parâmetros para abstrair valores que podem mudar entre ambientes. Ao definir os parâmetros a serem usados nos fluxos de trabalho, você pode primeiro se concentrar em criar os fluxos de trabalho, e inserir as variáveis específicas do ambiente mais tarde. Você pode chamar e referenciar as variáveis de ambiente em runtime usando parâmetros e configurações de aplicativo. Dessa forma, não será preciso reimplantá-las com frequência.

As configurações de aplicativo se integram ao Azure Key Vault. Você pode referenciar diretamente cadeias de caracteres seguras, tais como cadeias de conexão e chaves. De modo semelhante aos modelos do ARM, em que é possível definir variáveis de ambiente no momento da implantação, você pode definir as configurações de aplicativo na definição de fluxo de trabalho do aplicativo lógico. Em seguida, você pode capturar os valores da infraestrutura gerados dinamicamente, como pontos de extremidade de conexão, cadeias de caracteres de armazenamento, entre outros. No entanto, as configurações de aplicativo têm limitações de tamanho e não podem ser referenciadas em algumas áreas nos Aplicativos Lógicos do Azure.

Para obter mais informações sobre como configurar seus aplicativos lógicos para implantação, confira a seguinte documentação:

• Criar parâmetros que abrangem vários ambientes para entradas de fluxo de trabalho nos Aplicativos Lógicos do Azure
• Visão geral da implantação do DevOps para aplicativos lógicos baseados em locatário único
• Configurar a implantação do DevOps para aplicativos lógicos baseados em locatário único

Estrutura do projeto do Visual Studio Code

No Visual Studio Code, seu projeto de aplicativo lógico tem um dos seguintes tipos:

• Baseado em pacote de extensão (Node.js), que é o tipo padrão
• Baseado em pacote NuGet (.NET), que você pode converter pelo tipo padrão

Com base nesses tipos, seu projeto pode incluir pastas ou arquivos ligeiramente diferentes. Por exemplo, um projeto baseado em pacote nuget tem uma pasta .bin que contém pacotes e outros arquivos de biblioteca. Um projeto baseado em pacote de extensão não inclui essa pasta de .bin .

Alguns cenários exigem um projeto baseado em pacote NuGet para que seu aplicativo seja executado, por exemplo, quando você deseja desenvolver e executar operações internas personalizadas. Para obter mais informações sobre como converter o projeto para usar o NuGet, confira Habilitar a criação de conector integrado.

O projeto baseado em pacote de extensão padrão tem uma estrutura de arquivos e pasta semelhante ao seguinte exemplo:

MyWorkspaceName
| MyBundleBasedLogicAppProjectName
  || .vscode
  || Artifacts
     ||| Maps 
         |||| MapName1
         |||| ...
     ||| Rules
     ||| Schemas
         |||| SchemaName1
         |||| ...
  || lib
     ||| builtinOperationSdks
         |||| JAR
         |||| net472
     ||| custom
  || WorkflowName1
     ||| workflow.json
     ||| ...
  || WorkflowName2
     ||| workflow.json
     ||| ...
  || workflow-designtime
     ||| host.json
     ||| local.settings.json
  || .funcignore
  || connections.json
  || host.json
  || local.settings.json

No nível raiz do projeto, você pode encontrar as seguintes pastas e arquivos junto com outros itens:

Referência para configurações de aplicativo – local.settings.json

No Visual Studio Code, no nível raiz do projeto de aplicativo lógico, o arquivo local.settings.json contém opções de configuração globais que afetam todos os fluxos de trabalho nesse aplicativo lógico durante a execução em seu ambiente de desenvolvimento local. Quando os fluxos de trabalho são executados localmente, essas configurações são acessadas como variáveis de ambiente local e os valores delas geralmente podem mudar entre os vários ambientes em que você executar os fluxos de trabalho. Para saber como exibir e gerenciar essas configurações, consulte Gerenciar configurações do aplicativo – local.settings.json.

As configurações de aplicativo dos Aplicativos Lógicos do Azure funcionam de modo semelhante às configurações de aplicativo do Azure Functions ou dos Aplicativos Web do Azure. Se você já usou esses outros serviços antes, talvez já tenha se familiarizado com as configurações de aplicativo. Para obter mais informações, consulte a referência de configurações de aplicativo para o Azure Functions e o Work with Azure Functions Core Tools – arquivo de configurações local.

A tabela a seguir descreve as configurações de aplicativo que seu aplicativo lógico usa. Algumas configurações são necessárias para que seu aplicativo lógico funcione corretamente:

Gerenciar as configurações de aplicativo – local.settings.json

Para adicionar, atualizar ou excluir configurações de aplicativo, selecione e examine as seções a seguir para o portal do Azure, o Visual Studio Code ou a CLI do Azure. Para configurações de aplicativo específicas para aplicativos lógicos, consulte Referência para configurações de aplicativo – local.settings.json.

az logicapp config appsettings list --name <MyLogicApp> --resource-group <MyResourceGroup>

az logicapp config appsettings set --name <MyLogicApp> --resource-group <MyResourceGroup> --settings CUSTOM_LOGIC_APP_SETTING=12345 

Referência de configurações de host – host.json

No Visual Studio Code, no nível raiz do projeto de Logic App, o arquivo de metadados host.json contém as configurações de tempo de execução e os valores padrão que se aplicam a todos os fluxos de trabalho em um recurso de Logic App, seja em execução local ou no Azure. Para saber como exibir e gerenciar essas configurações, consulte Gerenciar configurações de host – host.json. Encontre também informações de limites relacionadas na documentação Limites e configuração dos Aplicativos Lógicos do Azure.

Produtividade da orquestração de trabalho

Essas configurações afetam a produtividade e a capacidade dos Aplicativos Lógicos do Azure de locatário único de executar operações de fluxo de trabalho.

As configurações a seguir são usadas para interromper manualmente e excluir imediatamente os fluxos de trabalho especificados no aplicativo lógico Standard.

Para especificar fluxos de trabalho individuais, use a sintaxe a seguir em que cada ID de fluxo de trabalho é seguida por dois-pontos (:) e é separada por um ponto-e-vírgula (;):

"Jobs.CleanupJobPartition": "<workflow-ID-1>:;<workflow-ID-2>",
"Jobs.SuspendedJobPartition": "<workflow-ID-1>:;<workflow-ID-2>:",
"SequencerJobs.SuspendedSequencerPartition": "<workflow-ID-1>:;<workflow-ID-2>:"

Para cancelar uma execução específica, forneça a ID de execução seguindo a ID do fluxo de trabalho com 2D como separador, por exemplo:

"Jobs.SuspendedJobPartition": "<workflow-ID-1>:2D<run-ID>;",

Gatilhos baseados em recorrência

Simultaneidade do gatilho

As configurações de simultaneidade a seguir se aplicam somente a fluxos de trabalho que começam com um gatilho baseado em recorrência para conectores internos baseados no provedor de serviços e controlam o número de fluxos de trabalho executados simultaneamente ou ao mesmo tempo.

Para um fluxo de trabalho que começa com um gatilho baseado em função, você poderá tentar configurar o envio em lote quando houver suporte. No entanto, nem sempre o envio em lote é a solução correta. Por exemplo, com os gatilhos do Barramento de Serviço do Azure, um lote pode manter as mensagens além da duração do bloqueio. Como resultado, qualquer ação, seja concluída ou abandonada, falha nessas mensagens.

Duração de execução e retenção de histórico

Executar ações

Alterar o valor do tempo limite de execução para operações internas baseadas em funções

Para operações internas que são executadas como chamadas de função no Azure Functions, adicione as configurações de host Runtime.FlowRunRetryableActionJobCallback.ActionJobExecutionTimeout e functionTimeout ao arquivo host.json, conforme mostrado no exemplo a seguir:

{
   "version": "2.0",
   "extensionBundle": {
      "id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
      "version": "[1.*, 2.0.0)"
   },
   "extensions": {
      "workflow": {
         "settings": {
            "Runtime.FlowRunRetryableActionJobCallback.ActionJobExecutionTimeout": "01:00:00"
         }
      }
   },
   "functionTimeout": "01:00:00"
}

Entradas e saídas

Pagination

Chunking

Armazenar o conteúdo em linha ou usar blobs

Loops For each

Loops Until

Variables

Operações HTTP internas

Operações internas do webhook HTTP

Operações de Armazenamento do Microsoft Azure internas

Armazenamento de Blobs

Armazenamento de tabelas e filas

Compartilhamento de arquivo

Operações internas do Azure Functions

Operações internas do Barramento de Serviço do Azure

Operações internas do SFTP

Operações do conector gerenciado

Política de repetição para todas as outras operações

Limitations

Tamanho máximo do conteúdo:

Por padrão, os gatilhos internos, como HTTP ou Solicitação, são limitados ao tamanho da mensagem descrito em Referência de limites e configuração: mensagens. Para lidar com arquivos maiores que o limite, tente carregar seu conteúdo como um blob para Armazenamento de Blobs do Azure e obtenha seu conteúdo usando o conector de Blob do Azure.

Gerenciar configurações de host – host.json

Você pode adicionar, atualizar ou excluir configurações de host, que especificam as definições de configuração de runtime e os valores que se aplicam a todos os fluxos de trabalho desse aplicativo lógico, como valores padrão para taxa de transferência, capacidade, tamanho de dados etc., sejam eles executados localmente ou no Azure. Para configurações de host específicas de aplicativos lógicos, consulte Referência para configurações de host – host.json.

Conteúdo relacionado

• Criar parâmetros que abrangem vários ambientes para entradas de fluxo de trabalho nos Aplicativos Lógicos do Azure
• Configurar a implantação do DevOps para aplicativos lógicos Standard nos Aplicativos Lógicos do Azure com locatário único