Amazon Q Developer in GitHub でのコードの変換
注記
Amazon Q Developer for GitHub はプレビューリリースであり、変更される可能性があります。
コード変換機能を使用すると、既存のコードのコア機能を維持しながら、テクノロジースタックを更新し、パフォーマンスを向上させ、将来の互換性を確保できます。Amazon Q Developer を使用すると、技術的負債を回避し、長期的な持続可能性とスケーラビリティのためのアプリケーションを構築できます。
コード変換ラベルを問題に追加するか、/q transform スラッシュコマンドを使用すると、Amazon Q Developer はコードを Java バージョン 8 または 11 からバージョン 17 に変換します。次に、Amazon Q Developer は、メインラインにマージできる変更と変更の概要を含むプルリクエストを作成します。
Amazon Q Developer でのコード変換の実行回数は、1 か月あたりの回数制限があります。Amazon Q Developer アプリのインストールを AWS アカウントに登録することで、いつでも無料利用枠を増やすことができます。詳細については、「Amazon Q Developer コンソールの使用制限の引き上げと詳細の設定」を参照してください。
前提条件
Amazon Q Developer でコードベースを変換する前に、次の要件を考慮してください。
-
GitHub リポジトリで GitHub Actions が有効になっていることを確認します。詳細については、「GitHubドキュメント」の「GitHub を理解する
」および「ワークフローの有効化 」を参照してください。 -
.github/workflows/ディレクトリでワークフローファイルを作成して設定し、コード変換タスクを処理します。詳細については、「コード変換ワークフローのカスタマイズ」を参照してください。
前提条件を満たしたら、Amazon Q 変換エージェントラベルを適用し、GitHub リポジトリ内のコードベースをアップグレードできます。
重要
Amazon Q Developer アプリは、アクセスを許可する GitHub リポジトリに Amazon Q Developer エージェントラベルと Amazon Q 変換エージェントラベルを自動的に作成します。ラベルが自動的に作成されない場合や、意図せずに削除された場合は、GitHub で手動で作成できます。ラベルを Amazon Q Developer ラベルとして認識して処理するには、ラベルに Amazon Q Developer エージェントおよび Amazon Q 変換エージェントという名前を付ける必要があります。詳細については、「GitHub ドキュメント」の「ラベルの作成
コードベースをアップグレードするには
-
必要に応じて、GitHub 認証情報を使用して GitHub
アカウントにサインインします。 -
GitHub 組織に移動し、コードベースを変換するリポジトリに移動します。
-
[問題] を選択し、新しい問題を作成します。詳細については、「GitHub ドキュメント」の「Issue の作成
」を参照してください。 -
[タイトルの追加] テキスト入力フィールドで、コード変換のために Amazon Q Developer にコンテキストを提供するタイトルを入力します (例:「コードベースのアップグレード」)。問題の説明はコンテキストも提供するため、含める必要があります。
-
問題の作成時または既存の問題の設定時に、コード変換 Amazon Q Developer ラベルを適用するか、
/q transformスラッシュコマンドを使用できます。次のいずれかを行います:-
問題にラベルを適用するには、次のいずれかを実行します。
-
ブラウザ拡張機能として提供されている [Amazon Q への割り当て] ドロップダウンメニューを選択し、[Amazon Q 変換エージェント] ラベルを選択します。
-
右側のメニューで [ラベル] を選択し、[Amazon Q 変換エージェント] ラベルを選択します。
-
-
コメントで
/q transformスラッシュコマンドを使用するには:-
問題内で [コメントの追加] に移動し、コメントテキスト入力フィールドに「
/q transform」と入力します。 -
[コメント] を選択します。
-
-
-
[問題の作成] を選択して、Amazon Q Developer がコードを変換するために必要な詳細を含む問題の作成を完了します。
Amazon Q Developer が機能開発のコード変更の生成を完了すると、問題にコメントし、プルリクエストを開きます。
-
Amazon Q Developer が残したコメント (例:「
I finished upgrading your code and opened a pull request: Resolve Upgrade codebase.」) に移動し、プルリクエストリンクを選択します。[プルリクエスト] タブに移動し、Amazon Q Developer によって作成されたプルリクエストを選択することもできます。
-
[変更されたファイル] タブを選択して、変更を表示します。
-
提案されたコード変更に問題がない場合、プルリクエストをマージできます。詳細については、「pull request のマージ
」を参照してください。
Amazon Q Developer は、更新したファイルに関する詳細を含む変換の概要を提供するコメントを残します。概要は、コメントに記載されている build_logs.txt ファイルにあります。Amazon Q Developer が完全なコード変換を実行できない場合は、完全な変換を妨げたエラーに関する概要も表示されます。
