Azure Logic Apps Migration Agentをカスタム解析器を作成して他のプラットフォームに拡張する

適用対象: Azure Logic Apps (Standard)

もし組織がVisual Studio CodeのAzure Logic Apps Migration Agent拡張機能が現在サポートしていない統合プラットフォーム(IBM IIB/ACE、DELL Boomi、Workatoなど)を使っている場合、そのプラットフォーム用のカスタムパーサーを作成・追加することでエージェントを拡張できます。 バージョン1.12.1には、BizTalk Server、MuleSoft Anypoint、TIBCO BusinessWorksの登録サポートが含まれています。 この拡張機能はレジストリベースのパーサーアーキテクチャを採用しており、組み込みおよび外部パーサの両方をサポートしています。

この記事では、ソース統合プラットフォームの成果物を移行エージェントの一般的な中間表現 (IR) 形式に変換するカスタム パーサーを作成して追加する方法について説明します。 このJSONドキュメントは、プラットフォームに依存しない形でアーティファクトを記述しています。 プラットフォーム固有のスキルを備えた組み込みパーサは、5つの移行段階すべてに参加できます。 外部パーサ拡張はディスカバリーのみをカバーします。

前提条件

開始する前に、次のリソースがあることを確認します。

パーサー アーキテクチャ

移行エージェントにプラットフォーム サポートを追加するには、次の方法を使用します。

すべてのパーサーは、ソース プラットフォーム成果物を JSON ドキュメントとして共通の IR 形式に変換します。 移行エージェントは、計画、変換、検証の各段階で IR 形式を使用します。 パーサー レジストリは、組み込みパーサー プラグインと外部パーサー プラグインの両方をサポートします。

MuleSoftのRAMLおよびOpenAPI仕様パーサー、そして汎用XMLパーサーはバージョン1.12.1のスタブです。

手順 1: 組み込みのパーサーを追加する

1. src/parsers/<your-platform>/で、新しいパーサー モジュールを作成します。

   src/parsers/
   ├── biztalk/              # Reference implementation
   │   ├── index.ts
   │   ├── types.ts
   │   ├── BizTalkProjectParser.ts
   │   ├── BizTalkOrchestrationParser.ts
   │   └── ...
   ├── <your-platform>/      # Your new parser
   │   ├── index.ts
   │   ├── types.ts
   │   └── <your-platform-parser-name>.ts
   

2. 各パーサーが IParser インターフェイスを実装していることを確認します。

   import { IParser, ParserCapabilities, ParseResult, ParseOptions } from '../types';
   import { IRDocument, createEmptyIRDocument } from '../../ir/types';
   
   export class YourPlatformParser implements IParser {
       get capabilities(): ParserCapabilities {
           return {
               platform: '<your-platform>',
               fileExtensions: ['.<your-extension>'],
               fileTypes: ['flow'],
               supportsFolder: false,
               description: 'Parses <your-platform> integration flows.',
           };
       }
   
       canParse(filePath: string): boolean {
           return filePath.endsWith('.<your-extension>');
       }
   
       async parse(
           filePath: string,
           options?: ParseOptions
       ): Promise<ParseResult> {
           const ir = createEmptyIRDocument();
           // Parse the source file and populate the IR document.
           // For the complete schema, see docs/IRSchema.md.
           return { ir, stats: { /* parsing statistics */ } };
       }
   }
   

3. パーサーを src/parsers/index.tsに登録します。

   import { <your-platform-parser-name> } from './<your-platform>';
   
   export function initializeParsers(): void {
       // ... existing parsers ...
       defaultParserRegistry.register(new <your-platform-parser-name>());
   }
   

   ヒント

   完全に動作するリファレンスとして、 src/parsers/biztalk/で BizTalk パーサーの実装を使用します。

手順 2: プラットフォーム固有のスキルを追加する

Markdown ファイルとして、スキルは移行ステージごとに AI 命令を提供します。 GitHub Copilot エージェントに対して、特定のプラットフォーム用に成果物をどのように分析、計画、そして変換するかを指示します。

これらのスキルを見つけるには、プラットフォーム固有のバリアントを使用した resources/skills/ を調べる必要があります。

resources/skills/
├── detect-logical-groups/
│   ├── biztalk/SKILL.md
│   ├── mulesoft/SKILL.md
│   └── <your-platform>/SKILL.md
├── source-to-logic-apps-mapping/
│   ├── biztalk/SKILL.md
│   ├── mulesoft/SKILL.md
│   └── <your-platform>/SKILL.md
└── ... (13 skills total)

各 SKILL.md ファイルでは、YAML frontmatter とそれに続く Markdown コンテンツが使用されます。次に例を示します。

---
name: source-to-logic-apps-mapping
description: >-
   Component mapping for \<*your-platform*\> components to their equivalents in Azure Logic Apps (Standard).
---

手順 3: プラットフォームを Azure Logic Apps (Standard) コンポーネントにマップする

1. 次の表を確認して、アダプター マッピングを作成します。

   < your-platform> コンポーネント	Azure Logic Apps に相当するもの	ネイティブ。	注記
   HTTP リスナー	HTTP トリガー	Yes	Built-in
   データベース コネクタ	SQL Server コネクタ	Yes	Built-in

2. 次の表の各スキルに対して、必要な <your-platform>/SKILL.md スキルバリアントを作成します。

   ヒント

   サポートされているプラットフォーム ( biztalk/SKILL.md など) のスキルを出発点としてコピーし、プラットフォームに合わせてコンテンツを調整します。

   GitHub Copilot エージェント	Skill	Purpose
   @migration-analyser	detect-logical-groups	成果物を論理フロー グループにグループ化するためのルール
   @migration-analyser	analyse-source-design	ソース アーキテクチャの分析と視覚化の生成に関する規則
   @migration-analyser	dependency-and-decompilation-analysis	不足している依存関係を識別するための規則
   すべてのエージェント	source-to-logic-apps-mapping	ソースからAzure Logic Appsへのコンポーネントごとのマッピング
   @migration-planner	logic-apps-planning-rules	移行計画を生成するための規則
   @migration-converter	conversion-task-plan-rules	変換タスクを作成するためのルール
   @migration-converter	scaffold-logic-apps-project	標準ロジック アプリ プロジェクト構造をスキャフォールディングするための規則
   @migration-converter	workflow-json-generation-rules	workflow.json ファイルを生成するための規則
   @migration-converter	connections-json-generation-rules	connections.json ファイルを生成するための規則
   @migration-converter	dotnet-local-functions-logic-apps	.NETローカル関数を生成するための規則
   @migration-converter	no-stubs-code-generation	生成されたコードが完了していることを確認するための規則
   @migration-converter	runtime-validation-and-testing	ランタイムの検証とテストの規則
   @migration-converter	cloud-deployment-and-testing	クラウドのデプロイとテストの規則

手順 4: プラットフォームを登録する

1. src/types/platforms.ts ファイルで、サポートされているプラットフォームの一覧にプラットフォームを追加します。

    export type SourcePlatform = 'biztalk' | 'mulesoft' | 'tibco' | '<your-platform>';
   
   export const SUPPORTED_PLATFORMS: PlatformInfo[] = [
       // ... existing platforms ...
       {
           id: '<your-platform>',
           label: '<your-platform-name>',
           description: '<your-platform> version <version-number>',
           icon: '$(server)',
           filePatterns: ['.<your-extension>', '.<your-config>'],
       },
   ];
   

2. src/stages/discovery/PlatformDetector.ts ファイルに検出ロジックを追加します。

3. src/stages/discovery/SourceFolderService.ts ファイルに、ファイル パターンを追加します。

手順 5 (省略可能): IR の例を追加する

プラットフォームの成果物を IR スキーマにマップする方法を文書化するには、 docs/IRExamples_YourPlatform.md ファイルを追加します。 次の例が存在し、テンプレートとして機能します。

代替手段: 外部パーサー拡張機能

外部パーサー拡張機能は、エージェントがソース ファイルを解析する移行エージェントの検出ステージのみを対象としています。 スキル、プラットフォーム検出、AI を利用した計画と変換では、extension のGitHub リポジトリに直接貢献する必要があります。

ただし、リポジトリに直接貢献しない場合は、parse プラグイン API。

import * as vscode from 'vscode';

export async function activate(context: vscode.ExtensionContext) {
    const agent = vscode.extensions.getExtension('ms-azuretools.logicapps-migration-agent');

    if (agent) {
        const api = await agent.activate();
        api.registerParser(new MyPlatformParser(), {
            priority: 10,
        });
    }
}

パーサー プラグイン API

関連するコンテンツ

• 統合プラットフォームからAzure Logic Appsへの移行自動化

次のステップ