Exportar fluxos de trabalho de consumo para um aplicativo lógico padrão

Os fluxos de trabalho de aplicativos lógicos padrão, que são executados em Aplicativos Lógicos do Azure de locatário único, oferecem muitos recursos novos e aprimorados. Por exemplo, você obtém isolamento de computação, integração de rede virtual e pontos de extremidade privados, juntamente com hospedagem do Ambiente de Serviços de Aplicativo, desenvolvimento local e depuração usando o Visual Studio Code, baixa latência com fluxos de trabalho sem monitoração de estado e muito mais.

Se você quiser os benefícios dos fluxos de trabalho Padrão, mas seus fluxos de trabalho forem executados em Aplicativos Lógicos do Azure multilocatário, agora você pode mover seus fluxos de trabalho de Consumo para Aplicativos Lógicos do Azure de locatário único. Essa mudança faz sentido em cenários que exigem alguns dos recursos padrão, como isolamento e integração de rede, menor latência ou melhor previsibilidade de custos.

Agora você pode exportar aplicativos lógicos de consumo para um aplicativo lógico padrão. Usando o Visual Studio Code e a extensão mais recente dos Aplicativos Lógicos do Azure (Padrão), você exporta seus aplicativos lógicos como fluxos de trabalho com monitoração de estado para um projeto de aplicativo lógico Padrão. Em seguida, você pode atualizar, testar e depurar localmente seus fluxos de trabalho para prepará-los para a reimplantação. Quando estiver pronto, você poderá implantar diretamente do Visual Studio Code ou por meio de seu próprio processo de DevOps.

Nota

O recurso de exportação não migra seus fluxos de trabalho. Em vez disso, essa ferramenta replica artefatos, como definições de fluxo de trabalho, conexões, artefatos de conta de integração e outros. Os recursos do aplicativo de lógica de origem, fluxos de trabalho, histórico de gatilho, histórico de execução e outros dados permanecem intactos.

Você controla o processo de exportação e sua jornada de migração. Você pode testar e validar seus fluxos de trabalho exportados para sua satisfação com o ambiente de destino. Você escolhe quando desativar ou excluir seus aplicativos lógicos de origem.

Este artigo fornece informações sobre o processo de exportação e mostra como exportar seus fluxos de trabalho de aplicativo lógico de um fluxo de trabalho de consumo para um projeto de aplicativo lógico padrão local no Visual Studio Code.

Problemas e limitações conhecidos

  • A ferramenta de exportação não exporta nenhuma informação de infraestrutura, como configurações de conta de integração.

  • A ferramenta de exportação pode exportar fluxos de trabalho de aplicativos lógicos com gatilhos que têm configurações de simultaneidade. No entanto, os Aplicativos Lógicos do Azure de locatário único ignoram essas configurações.

  • Os aplicativos lógicos devem existir na mesma região se você quiser exportá-los dentro do mesmo projeto de aplicativo lógico padrão.

  • Por padrão, as credenciais de conexão não são clonadas dos fluxos de trabalho do aplicativo lógico de origem. Antes que os fluxos de trabalho do aplicativo lógico possam ser executados, você terá que autenticar novamente essas conexões após a exportação.

  • Por padrão, se um conector do Azure tiver uma versão interna do conector, a ferramenta de exportação converterá automaticamente o conector do Azure para o conector interno. Não existe nenhuma opção para desativar esse comportamento.

Tipos de operação exportáveis

Operação Tipo JSON
Acionador Built-in: Http, HttpWebhook, , Recurrence( manual Solicitação)

Gerido: ApiConnection ApiConnectionNotification, ApiConnectionWebhook
Ação Incorporado: , , , Compose, , SwitchIncrementVariableIfHttpWebhookHttpForeachTerminateParseJsonResponseScopeJoinSetVariableUntilSelectInitializeVariableJavaScriptCodeTableDecrementVariableAppendToStringVariableAppendToArrayVariableWait

- Gerido: ApiConnection, ApiConnectionWebhook

Pré-requisitos

  • Um ou mais aplicativos lógicos para implantar na mesma assinatura e região do Azure, por exemplo, Leste dos EUA 2.

  • Acesso ao nível da subscrição do leitor do Azure à subscrição onde as aplicações lógicas estão atualmente implementadas.

  • Acesso no nível do grupo de recursos do contribuidor do Azure, se você selecionar a opção para Implantar conectores gerenciados.

  • Analise e atenda aos requisitos de como configurar o Visual Studio Code com a extensão Azure Logic Apps (Standard).

Nota

Certifique-se de instalar a versão 2.0.16 ou superior para a extensão Azure Logic Apps (Standard) para Visual Studio Code. Alguns cenários de conversão exigem o designer de fluxo de trabalho mais recente, que está disponível com esta versão.

Aplicativos lógicos de grupo para exportação

Com a extensão Aplicativos Lógicos do Azure (Padrão), você pode combinar vários fluxos de trabalho de aplicativo lógico de consumo em um único projeto de aplicativo lógico Padrão. Nos Aplicativos Lógicos do Azure de locatário único, um recurso de aplicativo lógico padrão pode ter vários fluxos de trabalho. Com essa abordagem, você pode pré-validar seus fluxos de trabalho para não perder nenhuma dependência ao selecionar aplicativos lógicos para exportação.

Considere as seguintes recomendações ao selecionar aplicativos lógicos para exportação:

  • Aplicativos lógicos de grupo onde os fluxos de trabalho compartilham os mesmos recursos, como artefatos de conta de integração, mapas e esquemas, ou usam recursos por meio de uma cadeia de processos.

  • Para a organização e o número de fluxos de trabalho por aplicativo lógico, revise Práticas recomendadas e recomendações.

Exportar fluxos de trabalho de consumo para um projeto local

Selecionar aplicativos lógicos para exportação

  1. No Visual Studio Code, entre no Azure, se ainda não o fez.

  2. Na Barra de Atividades de Código do Visual Studio, selecione Azure para abrir a janela do Azure (Shift + Alt + A).

    Captura de ecrã a mostrar a Barra de Atividades de Código do Visual Studio com o ícone do Azure selecionado.

  3. Na barra de ferramentas da seção Espaço de trabalho, no menu Aplicativos Lógicos do Azure, selecione Exportar aplicativo lógico.

    Captura de ecrã a mostrar a janela do Azure, a barra de ferramentas da secção Espaço de Trabalho e a opção Exportar Aplicação Lógica selecionada.

  4. Depois que a guia Exportar for aberta, selecione sua assinatura e região do Azure e selecione Avançar.

    Captura de ecrã a mostrar o separador Exportar com a subscrição do Azure e a região selecionadas.

  5. Selecione os aplicativos lógicos a serem exportados. Cada aplicativo lógico selecionado aparece na lista Aplicativos lógicos selecionados ao lado.

    Gorjeta

    Você também pode pesquisar aplicativos lógicos e filtrar por grupo de recursos.

    Captura de ecrã a mostrar a secção

    A ferramenta de exportação começa a validar se os aplicativos lógicos selecionados estão qualificados para exportação.

  6. Na seção Opções avançadas, você pode selecionar as seguintes opções:

    Opção Predefinido Description
    Gerar modelo de infraestrutura Ativado O processo de exportação cria modelos de infraestrutura, que incluem um modelo ARM para o aplicativo lógico Standard e um modelo ARM para cada conexão exportada gerenciada pelo Azure.
    Credenciais de conexão de clone Inativo O processo de exportação clona credenciais da conexão gerenciada pelo Azure original para a nova conexão gerenciada pelo Azure criada no Azure, como parte da implantação. Funciona apenas nos casos em que a conexão exportada permanece uma conexão gerenciada pelo Azure, por exemplo, uma conexão do Office 365 Outlook.

    Importante: Use cuidadosamente esta opção. Por padrão, duas novas conexões apontarão para o mesmo recurso, o que pode criar condições de corrida.
    Padrão para conta de integração como fonte para transformações e validação Inativo Faça referência a arquivos de mapa e esquema localmente ou em uma conta de integração. Se habilitado, não copie mapas e esquemas para o projeto de destino. Requer que você adicione uma referência a uma conta de integração na configuração do aplicativo para seu aplicativo lógico. Por padrão, as ações Transformar XML e Validação XML usam a conta de integração como origem.
    Exportar conectores personalizados como ações de Gerenciamento de API Inativo Se habilitado, conectores personalizados são criados como ações de Gerenciamento de API, em vez de ações HTTP, para que você possa implementar ações personalizadas como operações de API no Gerenciamento de API. Para obter mais informações, consulte Opções padrão dos Aplicativos Lógicos do Azure para se conectar a serviços ao cliente ou APIs.
  7. Quando tiver terminado, selecione Seguinte.

Rever os resultados da validação de exportação

  1. Após a conclusão da validação de exportação, revise os resultados expandindo a entrada para cada aplicativo lógico.

    • Os aplicativos lógicos com erros não são elegíveis para exportação. Você deve remover esses aplicativos lógicos da lista de exportação até corrigi-los na origem. Para remover um aplicativo lógico da lista, selecione Voltar.

      Por exemplo, SourceLogicApp2 tem um erro e não pode ser exportado até que seja corrigido:

      Captura de tela mostrando a seção 'Revisar status de exportação' e o status de validação do fluxo de trabalho do aplicativo lógico com erro.

    • Os aplicativos lógicos que passam na validação com ou sem avisos ainda são elegíveis para exportação. Para continuar, selecione Exportar se todos os aplicativos forem validados com êxito ou selecione Exportar com avisos se os aplicativos tiverem avisos.

      Por exemplo, SourceLogicApp3 tem um aviso, mas você ainda pode continuar a exportar:

      Captura de ecrã a mostrar a secção

    A tabela a seguir fornece mais informações sobre cada ícone e status de validação:

    Ícone de validação Estado de validação
    Ícone de sucesso O item passou na validação, para que a exportação possa continuar sem problemas a resolver.
    Ícone com falha O item falhou na validação, portanto, a exportação não pode continuar.

    A entrada de validação para o item com falha aparece automaticamente expandida e fornece informações sobre a falha de validação.
    Ícone de aviso O item passou na validação com um aviso, mas a exportação pode continuar com a resolução pós-exportação necessária.

    A entrada de validação para o item com um aviso aparece automaticamente expandida e fornece informações sobre o aviso e a correção pós-exportação necessária.
  2. Depois que a seção Concluir exportação for exibida, para Local de exportação, procure e selecione uma pasta local para seu novo projeto de aplicativo lógico padrão.

    Captura de tela mostrando a seção 'Concluir exportação' e a propriedade 'Local de exportação' com a pasta do projeto de exportação local selecionada.

  3. Se o seu fluxo de trabalho tiver conexões gerenciadas que você deseja implantar, o que só é recomendado para ambientes que não são de produção, selecione Implantar conexões gerenciadas, que mostra os grupos de recursos existentes em sua assinatura do Azure. Selecione o grupo de recursos onde você deseja implantar as conexões gerenciadas.

    Captura de tela mostrando a seção 'Concluir exportação' com a pasta de exportação local selecionada, 'Implantar conexões gerenciadas' selecionada e o grupo de recursos de destino selecionado.

  4. Em Após as etapas de exportação, revise todas as etapas pós-exportação necessárias, por exemplo:

    Captura de tela mostrando a seção

  5. Com base no seu cenário, selecione Exportar e concluir ou Exportar com avisos e concluir.

    A ferramenta de exportação baixa seu projeto para o local da pasta selecionada, expande o projeto no Visual Studio Code e implanta todas as conexões gerenciadas, se você selecionou essa opção.

    Captura de ecrã a mostrar a secção 'Estado da exportação' com o progresso da exportação.

  6. Após a conclusão desse processo, o Visual Studio Code abre um novo espaço de trabalho. Agora você pode fechar com segurança a janela de exportação.

  7. No seu projeto de aplicativo lógico padrão, abra e revise o arquivo de README.md para obter as etapas de pós-exportação necessárias.

    Captura de tela mostrando um novo projeto de aplicativo lógico padrão com README.md arquivo aberto.

Etapas pós-exportação

Passos de remediação

Alguns fluxos de trabalho de aplicativos lógicos exportados exigem etapas de correção pós-exportação para serem executados na plataforma Standard.

  1. No seu projeto de aplicativo lógico padrão, abra o arquivo de README.md e revise as etapas de correção para seus fluxos de trabalho exportados. A ferramenta de exportação gera o arquivo README.md, que contém todas as etapas pós-exportação necessárias.

  2. Antes de fazer qualquer alteração no fluxo de trabalho do aplicativo lógico de origem, certifique-se de testar o novo recurso e fluxos de trabalho do aplicativo lógico padrão.

Ações e configurações da conta de integração

Se você exportar ações que dependem de uma conta de integração, precisará configurar manualmente seu aplicativo lógico padrão com um link de referência para a conta de integração que contém os artefatos necessários. Para obter mais informações, consulte Vincular conta de integração a um aplicativo lógico padrão.

Ações e configurações em lote

Se você exportar ações que usam ações em lote com várias configurações armazenadas em uma conta de integração, será necessário configurar manualmente as ações em lote com os valores corretos após a exportação. Para obter mais informações, consulte Enviar, receber e processar mensagens em lote nos Aplicativos Lógicos do Azure.

Estrutura de pastas do projeto

Após a conclusão do processo de exportação, seu projeto de aplicativo lógico padrão contém novas pastas e arquivos ao lado da maioria dos outros em um projeto típico de aplicativo lógico padrão.

A tabela a seguir descreve essas novas pastas e arquivos adicionados pelo processo de exportação:

Pasta Ficheiro Description
.desenvolvimento\implantação LogicAppStandardConnections.parameters.json Arquivo de parâmetros de modelo do Azure Resource Manager para implantar conectores gerenciados
LogicAppStandardConnections.template.json Definição de modelo do Azure Resource Manager para implantar conectores gerenciados
LogicAppStandardInfrastructure.parameters.json Arquivo de parâmetros de modelo do Azure Resource Manager para implantar recurso de aplicativo lógico padrão
LogicAppStandardInfrastructure.template.json Definição de modelo do Azure Resource Manager para implantar recurso de aplicativo lógico padrão
.logs\exportação exportReport.json Exportar arquivo bruto de resumo do relatório, que inclui todas as etapas necessárias para a correção pós-exportação
exportValidation.json Arquivo bruto de relatório de validação, que inclui os resultados de validação para cada aplicativo lógico exportado
README.md Arquivo Markdown com resumo dos resultados de exportação, incluindo os aplicativos lógicos criados e todas as próximas etapas necessárias

Próximos passos