翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
注記
Amazon Q Developer の変換機能はプレビューリリースであり、変更される可能性があります。
.NET ステップ 1: サインインとオンボーディング
-
「」のステップに従います前提条件。
-
「」のステップに従いますワークスペースのセットアップ。
.NET ステップ 2: ジョブの作成
-
ワークスペースのランディングページで、.NET ジョブの作成を選択します。
-
チャットウィンドウで、Q からジョブの詳細を確認するよう求められます。
.NET ステップ 3: コネクタを設定する
Q がコードを評価し、自動的に変換できるジョブを特定するには、リポジトリへのコネクタを設定する必要があります。
.NET 変換の場合、Q は次のタイプのリポジトリへのコネクタをサポートします。
-
GitHub
Q は、変換されたコードを送信するために、同じリポジトリ内の書き込み可能なブランチにもアクセスする必要があります。
必要に応じて、左側のペインで Amazon Q とチャットしてサポートを受けてください。Q がガイドし、コネクタの設定に必要な情報の入力を求めます。
このステップには、以下が含まれる場合があります。
-
コードベースをインポート AWS アカウント するための別の を作成します。
-
その識別 AWS アカウント。
-
（必須) GitHub アプリを インスタンスに追加します AWS CodeConnections。
-
（必須) データソースとの AWS CodeConnections 接続を作成します。
-
その接続を識別します。
-
Amazon Q Developer コンソールで接続を検証するように Amazon Q Developer 管理者に依頼します。
-
AWS アカウント 管理者にワークスペースに IAM ロールを割り当てて、接続を使用できるように依頼します。
-
データ転送を開始する準備ができていることを Q に確認します。
詳細については AWS CodeConnections、「 デベロッパーツールコンソールユーザーガイド」の「接続とは」を参照してください。
IAM ロールの詳細については、「AWS Identity and Access Management ユーザーガイド」の「IAM ロール」を参照してください。
制限：
-
Q は現在、 に関する質問、または以下へのコネクタをサポートしていません。 AWS CodePipeline
-
Q は、アプリ ID を使用してのみソースコントロールに接続できます。Q はユーザー名とパスワードを使用してソースに接続できません。
-
ソースコードファイルを Q に直接アップロードすることはできません。Q がアクセスするには、サポートされているリポジトリに配置する必要があります。
コネクタを設定する場合、接続先のアカウントの管理者が接続を受け入れる必要があります。接続を受け入れるには、コネクタアクセプターポリシーで付与されたアクセス許可が必要です。
.NET ステップ 4: 評価
このステップでは、Amazon Q がコードを分析してモダナイゼーション計画を提案し、アプリケーションを .NET 8.0 以降に変換するために必要な中間ステップとタスクの概要を説明します。
コネクタが設定されると、Q はソースコードリポジトリ (リポ) を自動的に分析し始め、移植用にサポートされているプロジェクトタイプを持つリポのリストを識別します。各リポジトリには、複数の .NET プロジェクトを含めることができます。すべてのリポジトリとプロジェクトを評価することで、.NET の変換エージェントは複数のリポジトリにわたる .NET プロジェクト間の依存関係を特定して、変換が成功するようにできます。
分析が完了すると、Q はリポジトリのリスト、各リポジトリ内の .NET プロジェクトの数、変換用に選択するデフォルトブランチ、および最後のコミット日時を提供します。
デフォルトでは、Q はリポジトリ内でサポートされているすべての .NET プロジェクトを選択し、変換に含めるか、変換から除外する特定の .NET プロジェクト、ソリューション、ブランチを選択するオプションがあります。
リポジトリプロジェクトと .NET プロジェクトを選択すると、Q は自動的に変換プロセスを開始します。
.NET 8.0+ への変換でサポートされている .NET のレガシーバージョン：
-
.NET Framework バージョン 3.5 以降
-
.NET Core 3.1、.NET 5
-
.NET 6
-
.NET 7
制限
-
Q は変換できないジョブを識別します。Q が変換できないジョブのタイプは次のとおりです。
-
[Libraries] (ライブラリ)
-
コンソールアプリケーション
-
ウェブ API
-
MVC (UI レイヤーなし）
-
WCF
-
ユニットテストプロジェクト (nunit、xunit、MSTest)
-
-
Q は、既に .NET 8.0 以降にあるアプリケーションを変換しません。
-
Q は元のリポジトリブランチを編集または削除しません。Q は、変換されたコードを配置したブランチにのみ書き込み、編集、または削除できます。
.NET ステップ 5: 一括変換
変換するリポジトリとプロジェクトを選択すると、Q は関連する .NET アプリケーションの変換を自動的に開始します。Q はソースコードを MDE にダウンロードし、マネージド KMS キーを使用して暗号化します。次に、Q はモダナイズされるリポジトリ全体のジョブの依存関係ツリーを構築します。依存関係ツリーに基づいて、エージェントはリポジトリ全体で並行して変換を開始します。その途中で、Q は情報が必要な場合、または何らかのアクションを実行する必要がある場合に入力を求めます。
変換の進行状況は、次の 2 つの方法で追跡できます。
-
作業ログ – これにより、Q が実行するアクションと、人間による入力リクエスト、およびそれらのリクエストに対するレスポンスの詳細なログが提供されます。
-
ダッシュボード – 変換の概要を提供します。変換されたジョブの数、適用された変換、および変換の完了までの推定時間に関するメトリクスが表示されます。
制限
Q は、適切なアクセス許可を持たないユーザーからの質問を拒否します。たとえば、読み取り専用ユーザーはジョブ変換をキャンセルしたり、ジョブを削除したりすることはできません。
.NET ステップ 6: コードのレビューと完了
この時点で、ジョブが正常に変換されたか、ビルドエラーで部分的に変換されました。
このステップでは、Q Developer 変換ウェブエクスペリエンスから Visual Studio IDE の Q に移行します。Visual Studio の Q を使用して、プロジェクトの変換を検証し、必要に応じて変更を加えることができます。
Visual Studio で Amazon Q 拡張機能を設定する方法については、「」を参照してくださいIDE での Amazon Q Developer の使用。
レビューには 2 つのシナリオがあり、ユーザー入力はシナリオによって異なります。
-
ジョブが完全に変換されました – Q はジョブを完全に変換しました。顧客はこの変換されたコードを確認し、変更に満足したら、変換の完了に進むことができます。これにより、コード承認者または管理者ペルソナがこのアクションを確認するために必要なアクションの入力応答を求められます。管理者が承認すると、Q はジョブ変換ステータスを完了としてマークします。
-
ジョブが部分的に変換されました – Q はジョブを部分的に変換し、ジョブには HILT アクションを必要とするビルドエラーがあります。このシナリオでは、ビルドエラーを確認し、手動で問題に対処できます。管理者がコードを確認して承認すると、Q は変換を続行し、ジョブのビルドエラーを更新します。引き続きこの進行状況を追跡し、すべてのビルドエラーが解決されるまで、必要に応じてさらにアクションを実行できます。
