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: ApiConnection ApiConnectionNotification , ApiConnectionWebhook |
Ação | Incorporado: AppendToArrayVariable , , AppendToStringVariable , Compose , DecrementVariable Foreach , Http , HttpWebhook , IncrementVariable If , , InitializeVariable , JavaScriptCode , Join , , ParseJson , Response , , , Scope , Select , , SetVariable , , Switch , Table , Terminate , , Until Wait - 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
No Visual Studio Code, inicie sessão no Azure, se ainda não o fez.
Na Barra de Atividade do Visual Studio Code, selecione Azure para abrir a janela do Azure (Shift + Alt + A).
Na barra de ferramentas da secção Área de Trabalho , no menu Azure Logic Apps , selecione Exportar Aplicação Lógica.
Depois de o separador Exportar abrir, selecione a sua subscrição e região do Azure e, em seguida, selecione Seguinte.
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.
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
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:
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:
A tabela seguinte fornece mais informações sobre cada ícone e estado de validação:
Ícone de validação Estado de validação Validação aprovada por item, pelo que a exportação pode continuar sem problemas para resolver. 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.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.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.
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.
Em Após os passos de exportação, reveja os passos necessários após a exportação, por exemplo:
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.
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.
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.
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.
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.
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 |