Editar configurações de host e aplicativo 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)

Nos 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.

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

Nos Aplicativos Lógicos do Azure multilocatário, a 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, você não precisa reimplantar 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 do Azure Resource Manager (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 para valores que mudam em fluxos de trabalho entre ambientes para Aplicativos Lógicos do Azure de locatário único
• 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 em pacote NuGet (.NET), que você pode converter do tipo padrão

Com base nesses tipos, seu projeto inclui pastas e arquivos ligeiramente diferentes. Um projeto baseado em NuGet inclui uma pasta .bin que contém pacotes e outros arquivos de biblioteca. Um projeto baseado em pacote não inclui a pasta .bin e outros arquivos. Alguns cenários exigem um projeto baseado em 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 seu projeto para usar o NuGet, consulte Habilitar a criação de conector interno.

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

MyBundleBasedLogicAppProjectName
| .vscode
| Artifacts
  || Maps 
     ||| MapName1
     ||| ...
  || Schemas
     ||| SchemaName1
     ||| ...
| WorkflowName1
  || workflow.json
  || ...
| WorkflowName2
  || workflow.json
  || ...
| workflow-designtime
| .funcignore
| connections.json
| host.json
| local.settings.json

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

Referência para configurações de aplicativos - local.settings.json

No Visual Studio Code, no nível raiz do seu projeto de aplicativo lógico, o arquivo de 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 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.

Para que seu fluxo de trabalho seja executado corretamente, algumas configurações do aplicativo são necessárias.

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, CLI do Azure ou modelo ARM (Bicep). Para configurações de aplicativo específicas para aplicativos lógicos, consulte o guia de referência para configurações de aplicativo disponíveis - 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 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 aplicativo lógico, seja em execução local ou no Azure. Para ver e gerir estas definições, consulte Gerir definições de anfitrião - 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.

Taxa de transferência de orquestração de tarefas

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

Ambas 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.

O exemplo a seguir mostra a sintaxe dessas configurações em que cada ID de fluxo de trabalho é seguido por dois pontos (:) e separados por ponto-e-vírgula (;):

"Jobs.CleanupJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2:",
"Jobs.SuspendedJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2>:"

Gatilhos baseados em recorrência

Simultaneidade do acionador

As configurações a seguir funcionam apenas para fluxos de trabalho que começam com um gatilho baseado em recorrência para conectores internos baseados em provedor de serviços. 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

Entradas e saídas

Paginação

Fragmentação

Armazenar conteúdo embutido ou usar blobs

Para cada loop

Até loops

Variáveis

Operações HTTP incorporadas

Operações HTTP Webhook incorporadas

Operações internas do Armazenamento do Azure

Armazenamento de Blobs

Armazenamento de tabelas e filas

Partilha de ficheiros

Operações internas do Azure Functions

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

Operações SFTP integradas

Operações gerenciadas do conector

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

Limitações

• 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 do 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, revise o guia de referência para configurações de tempo de execução e implantação disponíveis - host.json.

Portal do Azure - host.json

Para rever as definições de anfitrião para a sua aplicação lógica baseada em inquilino único no portal do Azure, siga estes passos:

1. Na caixa de pesquisa do portal do Azure, localize e abra seu aplicativo lógico.

2. No menu do aplicativo lógico, em Ferramentas de Desenvolvimento, selecione Ferramentas Avançadas.

3. Na página Ferramentas Avançadas, selecione Ir, que abre o ambiente Kudu para seu aplicativo lógico.

4. Na barra de ferramentas Kudu, no menu Depurar console , selecione CMD.

5. No portal do Azure, pare seu aplicativo lógico.

   1. No menu do aplicativo lógico, selecione Visão geral.

   2. Na barra de ferramentas do painel Visão geral , selecione Parar.

6. No menu do aplicativo lógico, em Ferramentas de Desenvolvimento, selecione Ferramentas Avançadas.

7. No painel Ferramentas Avançadas, selecione Ir, que abre o ambiente Kudu para seu aplicativo lógico.

8. Na barra de ferramentas Kudu, abra o menu Depurar console e selecione CMD.

   Uma janela do console é aberta para que você possa navegar até a pasta wwwroot usando o prompt de comando. Ou, você pode procurar a estrutura de diretórios que aparece acima da janela do console.

9. Navegue pelo seguinte caminho até a pasta wwwroot : ...\home\site\wwwroot.

10. Acima da janela do console, na tabela de diretórios, ao lado do arquivo host.json , selecione Editar.

11. Depois que o arquivo host.json abrir, revise todas as configurações de host que foram adicionadas anteriormente para seu aplicativo lógico.

    Para obter mais informações sobre as configurações do host, consulte o guia de referência para configurações de host disponíveis - host.json.

Para adicionar uma configuração, siga estas etapas:

1. Antes de adicionar ou editar configurações, pare seu aplicativo lógico no portal do Azure.

   1. No menu do aplicativo lógico, selecione Visão geral.
   2. Na barra de ferramentas do painel Visão geral , selecione Parar.

2. Regresse ao ficheiro host.json . Sob o extensionBundle objeto, adicione o extensions objeto, que inclui os workflow objetos e settings , por exemplo:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

3. settings No objeto, adicione uma lista simples com as configurações de host que você deseja usar para todos os fluxos de trabalho em seu aplicativo lógico, sejam esses fluxos de trabalho executados localmente ou no Azure, por exemplo:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

4. Quando terminar, lembre-se de selecionar Salvar.

5. Agora, reinicie seu aplicativo lógico. Retorne à página Visão geral do aplicativo lógico e selecione Reiniciar.

Código do Visual Studio - host.json

Para revisar as configurações de host para seu aplicativo lógico no Visual Studio Code, execute estas etapas:

1. Em seu projeto de aplicativo lógico, no nível do projeto raiz, localize e abra o arquivo host.json .

2. No objeto, em workflows e settings, revise todas as extensions configurações de host que foram adicionadas anteriormente para seu aplicativo lógico. Caso contrário, o extensions objeto não aparecerá no arquivo.

   Para obter mais informações sobre as configurações do host, consulte o guia de referência para configurações de host disponíveis - host.json.

Para adicionar uma configuração de host, siga estas etapas:

1. No arquivo host.json, sob o extensionBundle objeto, adicione o extensions objeto, que inclui os workflow objetos e settings , por exemplo:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

2. settings No objeto, adicione uma lista simples com as configurações de host que você deseja usar para todos os fluxos de trabalho em seu aplicativo lógico, sejam esses fluxos de trabalho executados localmente ou no Azure, por exemplo:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

Próximos passos

• Criar parâmetros para valores que mudam em fluxos de trabalho entre ambientes para Aplicativos Lógicos do Azure de locatário único
• Configurar implementação DevOps para Azure Logic Apps de inquilino único