Editar configurações de aplicativo e host para aplicativos lógicos padrão em aplicativos lógicos do Azure de locatário único

Aplica-se a: Aplicativos Lógicos do Azure (Padrão)

Este guia explica como gerenciar configurações de tempo de execução e ambiente para aplicativos lógicos padrão em aplicativos lógicos do Azure de locatário único.

As configurações do aplicativo para um aplicativo lógico padrão 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. Os fluxos de trabalho executados localmente podem acessar essas configurações do aplicativo como variáveis de ambiente local, que são usadas por ferramentas de desenvolvimento local para valores que muitas vezes podem mudar entre ambientes. Por exemplo, esses valores podem conter cadeias de conexão. Quando você implanta no Azure, as configurações do aplicativo são ignoradas e não são incluídas na sua implantação.

Seu aplicativo lógico também tem configurações de host, que especificam as definições de configuração de tempo de execução e 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, parâmetros e implantação do aplicativo

Nos Aplicativos Lógicos do Azure multitenant, a sua implantação depende dos modelos do Azure Resource Manager (modelos ARM), que combinam e manipulam o provisionamento de recursos para aplicativos lógicos e infraestrutura. Esse design representa um desafio quando você precisa manter variáveis de ambiente para aplicativos lógicos em vários ambientes de desenvolvimento, teste e produção. Tudo em um modelo ARM é definido na implantação. Se você precisar alterar apenas uma única variável, terá que reimplantar tudo.

Nos Aplicativos Lógicos do Azure de locatário único , a implantação se torna 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 parâmetros para usar em seus fluxos de trabalho, você pode primeiro se concentrar em projetar seus fluxos de trabalho e, em seguida, inserir variáveis específicas do ambiente mais tarde. Você pode chamar e referenciar suas variáveis de ambiente em tempo de execução usando configurações e parâmetros do aplicativo. Dessa forma, não precisas de reimplementar com tanta frequência.

As configurações do aplicativo se integram ao Azure Key Vault. Você pode fazer referência direta a cadeias de caracteres seguras, como cadeias de conexão e chaves. Semelhante aos modelos ARM, onde você pode definir variáveis de ambiente no momento da implantação, você pode definir as configurações do aplicativo dentro da definição do fluxo de trabalho do aplicativo lógico. Em seguida, você pode capturar valores de infraestrutura gerados dinamicamente, como pontos de extremidade de conexão, cadeias de caracteres de armazenamento e muito mais. No entanto, as configurações do aplicativo têm limitações de tamanho e não podem ser referenciadas de determinadas áreas nos Aplicativos Lógicos do Azure.

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

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

Estrutura do projeto 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 no pacote NuGet (.NET), que pode ser convertido a partir do 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 .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 mais informações sobre como converter o seu projeto para usar o NuGet, consulte Ativar a autoria de conectores integrados.

O projeto baseado em pacote de extensão padrão tem uma estrutura de pasta e arquivo semelhante ao exemplo a seguir:

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 seu projeto, você pode encontrar as seguintes pastas e arquivos, juntamente com outros itens:

Referência para configurações do aplicativo - local.settings.json

No Visual Studio Code, no nível raiz do seu projeto de aplicativo lógico, o arquivo local.settings.json contém opções de configuração global que afetam todos os fluxos de trabalho nesse aplicativo lógico durante a execução em seu ambiente de desenvolvimento local. Quando seus fluxos de trabalho são executados localmente, essas configurações são acessadas como variáveis de ambiente local, e seus valores podem mudar frequentemente entre os vários ambientes onde você executa seus fluxos de trabalho. Para saber como ver e gerir estas definições, consulte Gerir definições da aplicação - local.settings.json.

As configurações de aplicativo nos Aplicativos Lógicos do Azure funcionam de forma semelhante às configurações de aplicativo no Azure Functions ou nos Aplicativos Web do Azure. Se você já usou esses outros serviços antes, talvez já esteja familiarizado com as configurações do aplicativo. Para obter mais informações, consulte Referência de configurações do aplicativo para o Azure Functions e Trabalhar com as Ferramentas Principais do Azure Functions - Arquivo de configurações locais.

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

Gerenciar configurações do aplicativo - local.settings.json

Para adicionar, atualizar ou excluir configurações do aplicativo, selecione e revise as seções a seguir para o portal do Azure, Visual Studio Code ou CLI do Azure. Para configurações de aplicativos específicas para aplicativos lógicos, consulte Referência para configurações de aplicativos - 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 para configurações de host - host.json

No Visual Studio Code, no nível raiz do seu projeto de aplicativo lógico, o arquivo de metadadoshost.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 aplicativo lógico, seja em execução local ou no Azure. Para saber como visualizar e gerenciar essas configurações, consulte Gerenciar configurações de host - host.json. Você também pode encontrar informações sobre limites relacionados na documentação Limites e configuração dos Aplicativos Lógicos do Azure .

Desempenho de orquestração de tarefas

Essas configurações afetam o desempenho e a capacidade dos Azure Logic Apps de instância única para 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 padrão.

Para especificar fluxos de trabalho individuais, use a seguinte sintaxe, em que cada ID de fluxo de trabalho é seguido por dois pontos (:) e é separado 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 o ID de execução seguindo o 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 de gatilho

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

Para um fluxo de trabalho que começa com um gatilho baseado em função, você pode tentar configurar o envio em lote onde houver suporte. No entanto, o processamento em lote nem sempre é a solução correta. Por exemplo, com gatilhos do Barramento de Serviço do Azure, um lote pode reter mensagens além da duração do bloqueio. Como resultado, qualquer ação, como concluir ou abandonar, falha em tais mensagens.

Duração da execução e retenção do histórico

Executar ações

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

Para operações internas que são executadas como chamadas de função no Azure Functions, adicione as configurações Runtime.FlowRunRetryableActionJobCallback.ActionJobExecutionTimeout e functionTimeout ao seu 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 conteúdo embutido ou usar blobs

Para cada loop

Até loops

Variables

Operações HTTP incorporadas

Operações HTTP Webhook incorporadas

Operações integradas do Armazenamento do Azure

Armazenamento de Blobs

Armazenamento de tabelas e filas

Partilha de ficheiros

Operações incorporadas do Azure Functions

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

Operações SFTP integradas

Operações gerenciadas do conector

Política de tentativa 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 Limites e referência de configuração - Mensagens. Para lidar com arquivos maiores que o limite, tente carregar seu conteúdo como um blob no 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 tempo de execução e valores que se aplicam a todos os fluxos de trabalho nesse aplicativo lógico, como valores padrão para taxa de transferência, capacidade, tamanho de dados e assim por diante, sejam eles executados localmente ou no Azure. Para configurações de host específicas para aplicativos lógicos, consulte Referência para configurações de host - host.json.

Conteúdo relacionado

• Criar parâmetros entre ambientes para entradas de fluxo de trabalho nos Aplicativos Lógicos do Azure
• Configurar a implantação de DevOps para aplicativos lógicos padrão em aplicativos lógicos do Azure de locatário único