Copilot CLI でGitHub Copilotモダン化を使用して.NETアプリをAzureに移行する

概要

Copilot CLI の GitHub Copilot modernization プラグインを使用して、.NET アプリケーションを Azure に移行する方法について説明します。

プラグインは、.NET アプリケーションを評価し、実行可能な最新化計画を生成し、移行を実行する自律的なマルチエージェント ワークフローをターミナルから提供します。 Azure移行、CVE の脆弱性の修正、アプリケーションの再設計がサポートされています。

実行可能事項

[前提条件]

• Copilot CLI をインストールします。
• GitHub Copilot サブスクリプション。 Copilot プランを参照してください。

プラグインをインストールする

1. ターミナルで copilot を実行して CLI Copilot開始します。

   copilot
   

2. マーケットプレースを追加し、プラグインをインストールします。

   copilot plugin marketplace add microsoft/github-copilot-modernization
   copilot plugin install github-copilot-modernization@github-copilot-modernization
   

3. インストールされているプラグインを一覧表示して、プラグインがインストールされていることを確認します。

   /plugin list
   

   一覧に github-copilot-modernization:modernize が表示されます。

プラグインを更新する

新しいバージョンが利用可能になったときにプラグインを更新するには、次のコマンドを実行します。

copilot plugin update github-copilot-modernization@github-copilot-modernization

モダン化タスクを開始する

オプション 1: エージェントから直接開始する

.NET プロジェクト フォルダーに移動し、最新化エージェントCopilot CLI を開始します。

cd /path/to/your/dotnet-project
copilot --agent=github-copilot-modernization:modernize

オプション 2: Copilot CLI 内でエージェントを選択する

既に Copilot CLI セッションに参加している場合は、/agent コマンドを使用してモダン化エージェントに切り替えます。

/agent

一覧から github-copilot-modernization:modernize を選択します。

モダン化プロンプトを実行する

エージェントがアクティブになったら、自然言語で必要なものを説明します。

copilot> modernize my application

または、より具体的に指定します。

copilot> modernize my .NET application for Azure
copilot> migrate this app from local SQL Server to Azure SQL Database
copilot> fix CVE vulnerabilities in my project

無人実行の場合は、 --allow-all フラグを使用します。

copilot --agent=github-copilot-modernization:modernize --allow-all

ワークフローのしくみ

プラグインは、自動的に実行される 3 フェーズ ワークフローを使用します。 各フェーズを手動で呼び出す必要はありません。オーケストレーターは、要求に基づいてルーティングを処理します。

フェーズ 1: 評価

• .NET のプロジェクト構造を検出し、適切な分析ツールを使用します。
• 依存関係、フレームワーク、バージョンを分析します。
• 最新化の機会とリスクを特定します。
• 結果を .github/modernize/assessment/に保存します。

フェーズ 2: 計画

• 評価結果とエンタープライズ プレイブックの制約 (存在する場合) を読み込みます。
• 実行可能タスク プランを生成します。
• プランを .github/modernize/<app>/plan.md して tasks.jsonに保存します。

フェーズ 3: 実行

• タスクの種類に基づいて、特殊な Executor エージェントにタスクをルーティングします。
• 各 Executor は、移行パターンについてナレッジ ベースを照会します。
• 失敗した場合の自動再試行で進行状況を監視します。
• レビュー用のタスクごとの詳細なコミットを作成します。

オーケストレーターは、意図に応じて複数のエントリ ポイントをサポートします。

エンタープライズモダン化ポリシーを定義する

組織は、最新化の意図 (ターゲット アーキテクチャ、アップグレード標準、コンプライアンス ポリシー) を プレイブックを通じてワークフローに直接埋め込むことができます。 このアプローチにより、生成されたすべてのプランが、各決定を手動で確認することなく、エンタープライズ標準と一致することを保証します。

プレイブックを設定する

Markdown ファイルをプロジェクトの .github/modernize/playbook/ ディレクトリに配置します。 計画フェーズでは、このフォルダー内のすべての .md ファイルが自動的に読み取られ、タスク計画が生成される前に評価結果とマージされます。

プレイブックで定義できる内容

プレイブックの例

.github/modernize/playbook/enterprise-standards.mdでファイルを作成します。

# Enterprise Modernization Standards

## Target Architecture
- Use Azure Container Apps for microservices deployments
- Use Azure Service Bus for all asynchronous messaging
- Use Azure SQL Database for relational data
- Use Azure Blob Storage for file storage

## Security & Compliance
- All services must authenticate using Managed Identity — no connection strings or passwords in code
- All public endpoints must be behind Azure Front Door

## Guardrails
- Do not use Azure Functions for long-running processes
- All infrastructure must be defined in Bicep

固定の名前付けや構造は必要ありません。オーケストレーターは、各ファイルの目的をその内容から推測します。

組み込みの既定値

プレイブックがない場合、プラグインは適切な既定値を適用します。

• Azure: 認証のマネージド ID、リレーショナル データのマネージド データベース サービス。
• Messaging: オンプレミス メッセージング → Azure Service Bus。
• インフラストラクチャ: 既定では Bicep。

一般的なシナリオ

Azure移行

copilot --agent=github-copilot-modernization:modernize
copilot> modernize my .NET application for Azure

ローカル SQL Serverから Azure SQL に移行する

copilot --agent=github-copilot-modernization:modernize
copilot> migrate this app from local SQL Server to Azure SQL Database with managed identity

ファイル I/O から Azure Blob Storage に移行する

copilot --agent=github-copilot-modernization:modernize
copilot> migrate this app from local file I/O to Azure Blob Storage

CVE とセキュリティ修正

copilot --agent=github-copilot-modernization:modernize
copilot> fix CVE vulnerabilities in my project

アプリケーションの再設計

copilot --agent=github-copilot-modernization:modernize
copilot> rearchitect my monolithic application into microservices

完全な最新化

copilot --agent=github-copilot-modernization:modernize
copilot> modernize my application

Troubleshooting

プラグインが見つかりません

# Verify marketplace is added
copilot plugin marketplace list

# Re-add marketplace if needed
copilot plugin marketplace add microsoft/github-copilot-modernization

# Reinstall
copilot plugin install github-copilot-modernization@github-copilot-modernization

評価に失敗する: アプリケーションが見つかりません

• プロジェクト ルートに .csproj または .sln ファイルが含まれていることを確認します。
• Copilot CLI を起動する前に、正しいディレクトリにいることを確認してください。

MCP サーバーの問題

プラグインは、その構成で定義されている MCP サーバーを使用します。 問題が発生した場合は、プラグインを再インストールして MCP 構成をリセットします。

フィードバックを提供する

GitHub Copilot CLI フィードバック フォームを使用して、GitHub Copilot CLI に関するフィードバックを共有します。

リファレンス

• GitHub Copilot CLI の使用
• GitHub Copilot モダン化プラグイン