Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a: Aplicativos Lógicos do Azure (Padrão)
O processo de migração para projetos de integração pode estagnar quando artefactos de origem complexos são difíceis de transformar em recursos implantáveis no Azure Logic Apps (Standard). Na fase de Conversão, o Azure Logic Apps Migration Agent no Visual Studio Code utiliza os resultados aprovados do planeamento para criar e executar um plano ordenado de tarefa de conversão. Este processo cria artefactos que incluem definições padrão de fluxos de trabalho, configurações de ligação e ficheiros de suporte.
Este artigo descreve como o Azure Logic Apps Migration Agent cria tarefas de conversão que mapeiam os artefactos de integração de origem para recursos de projetos de Standard Logic Apps prontos a implementar e como o agente executa essas tarefas para produzir artefactos de projeto prontos para serem implementados e executados.
Ações da fase de conversão
No Agente de Migração Azure Logic Apps, depois de terminar a atividade Plan Logic App Design, a atividade Criar Tarefas de Conversão fica disponível. Quando seleciona a atividade Criar Tarefas de Conversão, o agente do Copilot do GitHub @migration-converter cria as tarefas de conversão necessárias para gerar os artefactos do projeto da aplicação lógica alvo.
Depois de rever estas tarefas e selecionar a atividade Executar Tarefas de Conversão, o @migration-converter GitHub agente do Copilot processa as tarefas necessárias por ordem de dependência. A tarefa opcional Cloud Deployment & Testing não está incluída nesta ação e requer aprovação separada.
1: Gerar artefactos de projeto de aplicação lógica
O @migration-converter agente gera as saídas descritas nas secções seguintes.
Estrutura básica do projeto
O @migration-converter agente cria primeiro um espaço de trabalho no Visual Studio Code e um projeto de aplicação Standard Logic sob a out pasta. Tarefas de conversão posteriores adicionam uma ou mais definições de workflow, ligações, artefactos e um projeto de Funções .NET quando o plano aprovado as exige:
out/
└── <workspace-name>/
├── <workspace-name>.code-workspace
├── <logic-app-name>/
│ ├── host.json
│ ├── local.settings.json
│ ├── connections.json # Added when connectors are configured
│ ├── <workflow-name>/
│ │ └── workflow.json
│ ├── Artifacts/ # Added only when required
│ └── lib/custom/ # Added when local functions are built
└── Functions/ # Added only when local functions are required
O exemplo seguinte mostra o @migration-converter agente a criar a estrutura do andaime do projeto e os ficheiros:
Ficheiro de definição de workflow
Para cada fluxo de trabalho do plano aprovado, o agente @migration-converter gera um ficheiro workflow.json que contém as seguintes operações do fluxo de trabalho:
| Operation | Description |
|---|---|
| Trigger | Cada fluxo de trabalho começa sempre com um único gatilho, que é o ponto de entrada do fluxo. O agente mapeia este disparador a partir das portas de receção ou ouvintes na fonte. |
| Action | Cada fluxo de trabalho tem uma ou mais ações que executam tarefas. O agente mapeia estas ações a partir das formas de orquestração, processadores de fluxo ou atividades na fonte. |
| Condições ou ciclos | Ações que executam a lógica de controlo do fluxo, como Se, Para cada e Até. O agente traduz estas ações a partir de formas e ciclos de decisão na fonte. |
| Alcances | Ações com run-after configurações que podes usar para configurar o tratamento de erros. |
Configurações de conexão
O @migration-converter agente gera um connections.json ficheiro, que armazena as configurações necessárias para operações de conectores nos seus fluxos de trabalho.
A tabela seguinte descreve os grupos de conectores de alto nível:
| Grupo de conectores | Descrição e exemplos |
|---|---|
| Integrado | Conectores com operações que correm no mesmo processo que o runtime do Azure Logic Apps (Standard). Por exemplo, estes conectores incluem Request, File System, HTTP, Armazenamento de Blobs do Azure, Service Bus, SQL Server, AS2, EDIFACT, X12, e outros. Para mais informações, consulte: - Conectores integrados nas Aplicações Lógicas do Azure - Azure Logic Apps (Padrão) referência de conectores incorporados |
| Partilhado ou "gerido" | Conectores com operações que executam no Azure multicliente. Por exemplo, estes conectores incluem Salesforce, SAP, Office 365 Outlook, Power BI, SharePoint, entre outros. Azure Logic Apps suporta mais de 1.400 conectores partilhados para Microsoft, Azure e outras plataformas em ambientes na nuvem, no local e híbridos. Para mais informações, consulte Conectores geridos ou partilhados em Azure Logic Apps. |
| Personalizado | Conectores criados por outros editores ou pela sua organização para APIs personalizadas ou outros serviços. Para mais informações, consulte Criar conectores personalizados incorporados para fluxos de trabalho padrão. |
Para mais informações, consulte O que são conectores no Azure Logic Apps.
Funções locais .NET
Se tiveres componentes da plataforma de origem que não tenham um conector equivalente direto no Azure Logic Apps (Standard), o agente @migration-converter pode criar um projeto .NET Functions separado e compilar funções locais na pasta lib/custom do projeto de aplicação lógica. Este comportamento ocorre frequentemente em cenários onde se tem o seguinte:
- Lógica personalizada de transformação de dados
- Regras complexas de análise sintática ou validação
- Chamadas para sistemas on-premises através de protocolos personalizados
- Avaliação das regras de negócio
2. Verificar a completude e qualidade da saída
O agente @migration-converter utiliza a capacidade no-stubs-code-generation, que exige que a saída gerada não contenha implementações incompletas, código de marcador nem comentários TODO. Este requisito não substitui a revisão manual ou os testes em tempo de execução.
A competência aplica os seguintes padrões a ficheiros gerados:
| Standard | Description |
|---|---|
| Sem esboços ou códigos provisórios | Todo o código gerado é completo e funcional. |
| JSON válido | Todos os ficheiros workflow.json e connections.json são válidos e cumprem o esquema Azure Logic Apps. |
| Referências corretas | As ações do fluxo de trabalho referem-se às ligações e parâmetros corretos. |
| Tratamento de erros | Os fluxos de trabalho incluem os escopos adequados para o tratamento de erros. |
Para preparar a saída gerada para a fase de Validação, onde executa localmente os fluxos de trabalho para testes, certifique-se de inspecionar manualmente as definições do fluxo de trabalho, as ligações e quaisquer funções locais .NET geradas em busca de imprecisões.
Importante
Como boa prática, revê sempre quaisquer resultados gerados por IA antes de os usares. Tais resultados podem conter informação incorreta.
Para mais informações, consulte Quickstart: Migrar um projeto de integração usando o Azure Logic Apps Migration Agent.
Conteúdo relacionado
- Automação de migração das plataformas de integração para Azure Logic Apps
- Quickstart: Migrar um projeto de integração usando o Agente de Migração Azure Logic Apps