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

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

Nos Aplicativos Lógicos do Azure de locatário único, as configurações de aplicativo de 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 no 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 definições de configuração de runtime e os valores que se aplicam a todos os fluxos de trabalho desse aplicativo lógico, por exemplo, valores padrão para taxa de transferência, capacidade, tamanho de dados etc., sejam eles executados localmente ou no Azure.

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

Nos Aplicativos Lógicos do Azure multilocatário, a implantação depende de modelos do ARM (modelos do Resource Manager), que combinam e processam o provisionamento de recursos para os aplicativos lógicos e 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. Tudo em um modelo do ARM é definido na implantação. Se você precisar 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, pois você pode separar o provisionamento de recursos entre os aplicativos e a infraestrutura. Use parâmetros para eliminar valores que podem mudar entre ambientes. Ao definir os parâmetros a serem usados nos fluxos de trabalho, primeiro, você pode 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, como cadeias de conexão e chaves. De modo semelhante aos modelos do ARM (modelos do Azure Resource Manager), em que você pode definir variáveis de ambiente no momento da implantação, defina 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 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 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, o projeto incluirá 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 o aplicativo seja executado, como quando você deseja desenvolver e executar operações personalizadas. Para obter mais informações sobre como converter o projeto para usar o NuGet, confira Habilitar a criação de conector integrado.

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

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 projeto, você pode encontrar os seguintes arquivos e pastas 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 global que afetam todos os fluxos de trabalho desse aplicativo lógico durante a execução no 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 ver e gerenciar essas configurações, examine Gerenciar configurações de 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, examine a Referência de configurações de aplicativo do Azure Functions e Trabalhar com o Azure Functions Core Tools – Arquivo de configurações local.

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

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

Para adicionar, atualizar ou excluir as configurações do aplicativo, selecione e examine as seções a seguir do portal do Azure, do Visual Studio Code, da CLI do Azure ou do modelo do ARM (Bicep). Para obter configurações de aplicativo específicas de aplicativos lógicos, examine o guia de referência das 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 de configurações de host – host.json

No Visual Studio Code, no nível raiz do projeto de aplicativo lógico, o arquivo de metadados host.json contém as configurações de runtime e os valores padrão que se aplicam a todos os fluxos de trabalho de um recurso de aplicativo lógico, sejam executados localmente ou no Azure. Para ver e gerenciar essas configurações, examine 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.

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

O exemplo a seguir mostra a sintaxe dessas configurações em que cada ID de fluxo de trabalho é seguida por dois-pontos (:) e separada por um 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 gatilho

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 quando houver suporte. No entanto, nem sempre o envio em lote é a solução correta. Por exemplo, com gatilhos de 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

Ações de execução

Entradas e saídas

Paginação

Agrupamento

Armazenar o conteúdo em linha ou usar blobs

Loops For each

Loops Until

Variáveis

Operações HTTP internas

Operações de webhook HTTP internas

Operações de Armazenamento do Microsoft Azure internas

Armazenamento de blob

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

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 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, examine o guia de referência das configurações de runtime e implantação disponíveis – host.json.

Portal do Azure – host.json

Para examinar as configurações de host do aplicativo lógico baseado em locatário único no portal do Azure, siga estas etapas:

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

2. No menu do aplicativo lógico, acesse Ferramentas de desenvolvimento e selecione Ferramentas avançadas.

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

4. Na barra de ferramentas do Kudu, abra o menu do Console de depuração e selecione CMD.

5. No portal do Azure, interrompa o 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 Interromper.

6. No menu do aplicativo lógico, acesse Ferramentas de desenvolvimento e selecione Ferramentas avançadas.

7. No painel Ferramentas avançadas, selecione Ir. O ambiente Kudu será aberto no seu aplicativo lógico.

8. Na barra de ferramentas do Kudu, abra o menu do Console de depuração e selecione CMD.

   A janela do console será aberta, de modo que você poderá procurar a pasta wwwroot usando o prompt de comando. Se preferir, procure a estrutura de diretório exibida 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. Após a abertura do arquivo host.json, examine as configurações de host adicionadas anteriormente ao aplicativo lógico.

    Para obter mais informações sobre as configurações de host, examine o guia de referência das configurações de host disponíveis – host.json.

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

1. Antes de adicionar ou editar as configurações, interrompa o 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 Interromper.

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

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

3. No objeto settings, adicione uma lista simples com as configurações de host que você deseja usar para todos os fluxos de trabalho no 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 o aplicativo lógico. Volte à página Visão geral do aplicativo lógico e selecione Reiniciar.

Visual Studio Code – host.json

Para examinar as configurações de host do aplicativo lógico no Visual Studio Code, siga estas etapas:

1. No projeto do aplicativo lógico, no nível do projeto raiz, encontre e abra o arquivo host.json.

2. No objeto extensions, em workflows e settings, examine as configurações de host adicionadas anteriormente ao aplicativo lógico. Caso contrário, o objeto extensions não será exibido no arquivo.

   Para obter mais informações sobre as configurações de host, examine o guia de referência das configurações de host disponíveis – host.json.

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

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

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

2. No objeto settings, adicione uma lista simples com as configurações de host que você deseja usar para todos os fluxos de trabalho no 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óximas etapas

• Criar parâmetros para valores que mudam em fluxos de trabalho entre ambientes para aplicativos lógicos do Azure de locatário único
• Configurar a implantação do DevOps para aplicativos lógicos do Azure de locatário único