Share via


Exportar fluxos de trabalho de Consumo para uma aplicação lógica Standard

Os fluxos de trabalho de aplicações lógicas padrão, que são executados no Azure Logic Apps de inquilino único, oferecem muitas capacidades novas e melhoradas. Por exemplo, obtém isolamento de computação, integração de rede virtual e pontos finais privados, juntamente com o alojamento do Ambiente dos Serviços Aplicacionais, o desenvolvimento local e a depuração com o Visual Studio Code, baixa latência com fluxos de trabalho sem estado e muito mais.

Se quiser obter as vantagens dos fluxos de trabalho Standard, mas os fluxos de trabalho forem executados no Azure Logic Apps multi-inquilino, pode agora mover os fluxos de trabalho de Consumo para o Azure Logic Apps de inquilino único. Esta mudança faz sentido em cenários que requerem algumas das capacidades Standard, como isolamento e integração de rede, menor latência ou melhor previsibilidade dos custos.

Agora pode exportar aplicações lógicas de Consumo para uma aplicação lógica Standard. Com o Visual Studio Code e a extensão mais recente do Azure Logic Apps (Standard), exporta as suas aplicações lógicas como fluxos de trabalho com monitorização de estado para um projeto de aplicação lógica Standard. Em seguida, pode atualizar, testar e depurar localmente os fluxos de trabalho para os preparar para reimplementação. Quando estiver pronto, pode implementar diretamente a partir do Visual Studio Code ou através do seu próprio processo de DevOps.

Nota

A capacidade de exportação não migra os fluxos de trabalho. Em vez disso, esta ferramenta replica artefactos, tais como definições de fluxo de trabalho, ligações, artefactos de conta de integração, entre outros. Os recursos da aplicação lógica de origem, os fluxos de trabalho, o histórico de acionadores, o histórico de execuções e outros dados permanecem intactos.

Controla o processo de exportação e o seu percurso de migração. Pode testar e validar os fluxos de trabalho exportados para sua satisfação com o ambiente de destino. Escolhe quando desativar ou eliminar as suas aplicações lógicas de origem.

Este artigo fornece informações sobre o processo de exportação e mostra como exportar os fluxos de trabalho da aplicação lógica de um ISE para um projeto de aplicação lógica Standard local no Visual Studio Code.

Limitações e problemas conhecidos

  • A ferramenta de exportação não exporta quaisquer informações de infraestrutura, como as definições da conta de integração.

  • A ferramenta de exportação pode exportar fluxos de trabalho de aplicações lógicas com acionadores com definições de simultaneidade. No entanto, o Azure Logic Apps de inquilino único ignora estas definições.

  • As aplicações lógicas têm de existir na mesma região se quiser exportá-las no mesmo projeto de aplicação lógica Standard.

  • Por predefinição, as credenciais de ligação não são clonadas a partir de fluxos de trabalho da aplicação lógica de origem. Antes de os fluxos de trabalho da aplicação lógica poderem ser executados, terá de voltar a autenticar estas ligações após a exportação.

  • Por predefinição, se um conector do Azure tiver uma versão de conector incorporada, a ferramenta de exportação converte automaticamente o conector do Azure no conector incorporado. Não existe nenhuma opção para optar ativamente por não participar neste comportamento.

Tipos de operação exportáveis

Operação Tipo JSON
Acionador Incorporado: Http, HttpWebhook, Recurrence, manual (Pedido)

Gerido: ApiConnectionApiConnectionNotification, ApiConnectionWebhook
Ação Incorporado: AppendToArrayVariable, , AppendToStringVariable, Compose, DecrementVariableForeach, Http, HttpWebhook, IncrementVariableIf, , InitializeVariable, JavaScriptCode, Join, , ParseJson, Response, , , Scope, Select, , SetVariable, , Switch, Table, Terminate, , UntilWait

- Gerido: ApiConnection, ApiConnectionWebhook

Pré-requisitos

  • Uma ou mais aplicações lógicas para implementar na mesma subscrição e região do Azure, por exemplo, E.U.A. Leste 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 ao nível do grupo de recursos contribuidor do Azure, se selecionar a opção Implementar conectores geridos.

  • Reveja e cumpra os requisitos para configurar o Visual Studio Code com a extensão Azure Logic Apps (Standard).

Nota

Certifique-se de que instala a versão 2.0.16 ou superior para a extensão do Azure Logic Apps (Standard) para o Visual Studio Code. Alguns cenários de conversão requerem o estruturador de fluxo de trabalho mais recente, que está disponível a partir desta versão.

Agrupar aplicações lógicas para exportação

Com a extensão do Azure Logic Apps (Standard), pode combinar vários fluxos de trabalho de aplicações lógicas de Consumo num único projeto de aplicação lógica Standard. No Azure Logic Apps de inquilino único, um recurso de aplicação lógica Standard pode ter vários fluxos de trabalho. Com esta abordagem, pode pré-validar os fluxos de trabalho para que não perca quaisquer dependências quando seleciona aplicações lógicas para exportação.

Considere as seguintes recomendações quando selecionar aplicações lógicas para exportação:

  • Agrupe aplicações lógicas em que os fluxos de trabalho partilham os mesmos recursos, como artefactos de conta de integração, mapas e esquemas, ou utilize recursos através de uma cadeia de processos.

  • Para a organização e o número de fluxos de trabalho por aplicação lógica, veja Melhores práticas e recomendações.

Exportar fluxos de trabalho de Consumo para um projeto local

Selecionar aplicações lógicas para exportação

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

  2. Na Barra de Atividade do Visual Studio Code, selecione Azure para abrir a janela do Azure (Shift + Alt + A).

    Captura de ecrã a mostrar a Barra de Atividade do Visual Studio Code com o ícone do Azure selecionado.

  3. Na barra de ferramentas da secção Área de Trabalho , no menu Azure Logic Apps , selecione Exportar Aplicação Lógica.

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

  4. Depois de o separador Exportar abrir, selecione a sua subscrição e região do Azure e, em seguida, selecione Seguinte.

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

  5. Selecione as aplicações lógicas a exportar. Cada aplicação lógica selecionada aparece na lista Aplicações lógicas selecionadas na parte lateral. Quando terminar, selecione Seguinte.

    Dica

    Também pode procurar aplicações lógicas e filtrar no grupo de recursos.

    Captura de ecrã a mostrar a secção

    A ferramenta de exportação começa a validar se as aplicações lógicas selecionadas são elegíveis para exportação.

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

  1. Após a conclusão da validação da exportação, reveja os resultados ao expandir a entrada para cada aplicação lógica.

    • As aplicações lógicas com erros não são elegíveis para exportação. Tem de remover estas aplicações lógicas da lista de exportação até as corrigir na origem. Para remover uma aplicação lógica da lista, selecione Anterior.

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

      Captura de ecrã a mostrar a secção

    • As aplicações lógicas que passam a validação com ou sem avisos continuam a ser elegíveis para exportação. Para continuar, selecione Exportar se todas as aplicações forem validadas com êxito ou selecione Exportar com avisos se as aplicações tiverem avisos.

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

      Captura de ecrã a mostrar a secção

    A tabela seguinte fornece mais informações sobre cada ícone e estado de validação:

    Ícone de validação Estado de validação
    Ícone de êxito Validação aprovada por item, pelo que a exportação pode continuar sem problemas para resolver.
    Ícone Com falha Falha na validação do item, pelo que a exportação não pode continuar.

    A entrada de validação do item com falha aparece automaticamente expandida e fornece informações sobre a falha de validação.
    Ícone de aviso O item passou a 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 do item com um aviso aparece automaticamente expandida e fornece informações sobre o aviso e a remediação pós-exportação necessária.
  2. Depois de aparecer a secção Concluir exportação , em Localização de exportação, procure e selecione uma pasta local para o seu novo projeto de aplicação lógica Standard.

    Captura de ecrã a mostrar a secção

  3. Se o fluxo de trabalho tiver ligações geridas que pretende implementar, o que só é recomendado para ambientes de não produção, selecione Implementar ligações geridas, que mostra os grupos de recursos existentes na sua subscrição do Azure. Selecione o grupo de recursos onde pretende implementar as ligações geridas.

    Captura de ecrã a mostrar a secção

  4. Em Após os passos de exportação, reveja os passos necessários após a exportação, por exemplo:

    Captura de ecrã a mostrar a secção

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

    A ferramenta de exportação transfere o projeto para a localização da pasta selecionada, expande o projeto no Visual Studio Code e implementa quaisquer ligações geridas, se tiver selecionado essa opção.

    Captura de ecrã a mostrar a secção

  6. Após a conclusão deste processo, o Visual Studio Code abre uma nova área de trabalho. Agora pode fechar com segurança a janela de exportação.

  7. No projeto da aplicação lógica Standard, abra e reveja o ficheiro README.md para obter os passos necessários após a exportação.

    Captura de ecrã a mostrar um novo projeto de aplicação lógica Standard com README.md ficheiro aberto.

Passos pós-exportação

Passos de remediação

Alguns fluxos de trabalho de aplicações lógicas exportadas requerem passos de remediação pós-exportação para serem executados na plataforma Standard.

  1. No projeto da aplicação lógica Standard, abra o ficheiro README.md e reveja os passos de remediação dos fluxos de trabalho exportados. A ferramenta de exportação gera o ficheiro README.md, que contém todos os passos de pós-exportação necessários.

  2. Antes de fazer alterações ao fluxo de trabalho da aplicação lógica de origem, certifique-se de que testa o novo recurso e fluxos de trabalho da aplicação lógica Standard.

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

Se exportar ações que dependem de uma conta de integração, terá de configurar manualmente a sua aplicação lógica Standard com uma ligação de referência para a conta de integração que contém os artefactos necessários. Para obter mais informações, veja Ligar a conta de integração a uma aplicação lógica Standard.

Ações e definições do Batch

Se exportar ações que utilizam ações do Batch com várias configurações armazenadas numa conta de integração, terá de configurar manualmente as ações do Batch com os valores corretos após a exportação. Para obter mais informações, veja Enviar, receber e processar mensagens em lote no Azure Logic Apps.

Estrutura de pastas do projeto

Após a conclusão do processo de exportação, o projeto da aplicação lógica Standard contém novas pastas e ficheiros juntamente com a maioria dos outros num projeto típico de aplicação lógica Standard.

A tabela seguinte descreve estas novas pastas e ficheiros adicionados pelo processo de exportação:

Pasta Ficheiro Descrição
.development\deployment LogicAppStandardConnections.parameters.json Ficheiro de parâmetros de modelo do Azure Resource Manager para implementar conectores geridos
LogicAppStandardConnections.template.json Definição de modelo do Azure Resource Manager para implementar conectores geridos
LogicAppStandardInfrastructure.parameters.json Ficheiro de parâmetros de modelo do Azure Resource Manager para implementar o recurso da aplicação lógica Standard
LogicAppStandardInfrastructure.template.json Definição de modelo do Azure Resource Manager para implementar o recurso da aplicação lógica Standard
.logs\export exportReport.json Exportar ficheiro não processado de resumo do relatório, que inclui todos os passos necessários para a remediação pós-exportação
exportValidation.json Ficheiro não processado do relatório de validação, que inclui os resultados de validação para cada aplicação lógica exportada
README.md Ficheiro Markdown com resumo dos resultados da exportação, incluindo as aplicações lógicas criadas e todos os passos seguintes necessários

Passos seguintes