翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon Q Developer を使用したコマンドラインでのコード変換 Amazon Q Developer コマンドライン変換ツールを使用して、コマンドラインからアプリケーションを変換できます。コードを変換するには、ソースコードと必要な設定ファイルへのパスを指定します。Amazon Q は一連のステップで新しいコードを生成します。変換全体を通して、Amazon Q はローカル環境でコードをビルドして、変更を検証します。詳細については、「[ローカル環境でのコードの構築](#local-builds)」を参照してください。Amazon Q は、コード変更をコミットする新しいブランチをリポジトリに作成します。変換が完了したら、ブランチを元のブランチにマージして、変更をコードベースに組み込むことができます。 開始するには、コマンドラインツールをインストールして認証し、変換を設定して開始するコマンドを確認します。 **Topics** + [ローカル環境でのコードの構築](#local-builds) + [コマンド](#commands) + [Amazon Q Developer のコマンドラインで変換を実行する](run-CLI-transformations.md) + [コマンドラインでの変換のトラブルシューティング](troubleshooting-CLI-transformations.md) + [Amazon Q Developer コマンドライン変換ツールのバージョン履歴](transform-CLI-versions.md) ## ローカル環境でのコードの構築 変換中、Amazon Q はローカル環境で検証ビルドを実行します。Amazon Q は、サーバー側でコードを複数のステップで変換します。各ステップの後、Amazon Q はローカル環境にコードを送信し、変更をビルドしてテストします。その後、コードをサーバー側に送信して変換を続行します。 ローカル環境のビルドは、Amazon Q がプライベートリソースへのアクセスを必要とするテストを実行できるようにすることで、変換されたコードを検証するのに役立ちます。ローカル環境で AI 生成コードの構築に関連するセキュリティリスクを最小限に抑えるために、Amazon Q は生成するコードを確認し、セキュリティ上の懸念に対応するように更新します。 **注記** Amazon Q は、プロジェクトのリクエスト、説明、コンテンツに基づいて変換を実行します。セキュリティを維持するには、外部で未検証のアーティファクトをプロジェクトリポジトリに含めないようにし、機能とセキュリティの両方について変換されたコードを常に検証します。 ## コマンド これらのコマンドを実行する手順については、「[Amazon Q Developer のコマンドラインで変換を実行する](run-CLI-transformations.md)」を参照してください。 変換を設定し、Amazon Q Developer Pro に対して認証するには、以下を実行します。 ``` qct configure ``` Java アップグレードの変換を開始するには、次のコマンドを実行します。** には、`JAVA_1.8`、`JAVA_8`、`JAVA_11`、`JAVA_17`、または `JAVA_21` を入力できます。** には、`JAVA_17` または `JAVA_21` を入力できます。`--source_version` および `--target_version` はオプションです。`--trust` フラグを使用すると、セキュリティを維持するためにコードを検証しながら変換を実行できます。 ``` qct transform --source_folder --source_version --target_version --trust ``` SQL 変換を開始するには、以下を実行します。 ``` qct transform --source_folder --sql_conversion_config_file ``` 使用している変換用のコマンドラインツールのバージョンを確認するには、以下を実行します。 ``` qct -v ``` 変換に関するヘルプを表示するには、以下を実行します。 ``` qct -h ``` 変換ジョブの履歴を表示するには、以下を実行します。 ``` qct history ``` 変換ジョブ履歴の表示と管理の詳細については、「[コマンドラインでのジョブ履歴の表示](transformation-job-history.md#cli-job-history)」を参照してください。 # Amazon Q Developer のコマンドラインで変換を実行する Amazon Q Developer コマンドラインツールを使用してコマンドラインでコードを変換するには、次の手順を実行します。 ## 前提条件 コマンドラインで変換を開始する前に、次の前提条件を満たす必要があります。 + Java コードバージョンをアップグレードする場合、プロジェクトは [Amazon Q で Java バージョンをアップグレードするための前提条件を満たしている](code-transformation.md#java-upgrade-prerequisites)こと。 + Java アプリケーションで埋め込み SQL を変換する場合、アプリケーションは [Amazon Q で埋め込み SQL を変換するための前提条件を満たしている](transform-sql.md#sql-transform-prereqs)こと。 + コマンドライン環境に Python がインストールされていること。これは、コマンドラインツールのインストール方法です。現在サポートされている Python の最小バージョンは 3.12 です。 + macOS または Linux で変換を実行していること。 + アプリケーションのサイズは 2 GB 以下であること。 + Amazon Q でアップグレードする特定の依存関係がある場合、[依存関係のアップグレードファイル](#step-3-dependency-upgrade-file)を設定済みであること。 ## ステップ 1: 認証方法を選択し、アクセス許可を追加する IAM アイデンティティセンターを認証して、コマンドラインで変換を実行できます。適切なアクセス許可を持っていることを確認します。 **注記** カスタマーマネージドキーは、コマンドラインで実行する変換ではサポートされていません。 ### アクセス許可を追加する 認証に使用する Amazon Q Developer サブスクリプションに関連付けられている IAM ID には、コマンドラインで変換を実行するアクセス許可が必要です。続行する前に、IAM ID に [ユーザーにコマンドラインでの変換の実行を許可する](id-based-policy-examples-users.md#id-based-policy-examples-allow-cli-transformations) で定義されたアクセス許可があることを確認します。 ### Amazon Q Developer サブスクリプションを介した IAM アイデンティティセンターの認証 IAM アイデンティティセンターで認証するには、ユーザーが管理者によって[ワークフォースユーザーとして Amazon Q Developer Pro にサブスクライブ](subscribe-users.md)されており、ユーザーがサブスクリプションを通じて認証するための開始 URL を指定する必要があります。ユーザーまたは管理者は、Amazon Q Developer コンソールで開始 URL を確認することができます。詳細については、[Amazon Q Developer で使用する開始 URL の表示](manage-account-details.md) を参照してください。 必要なアクセス許可を追加するには、「[アクセス許可を追加する](#transform-CLI-add-permissions)」を参照してください。 [ステップ 4: 設定および認証](#step-4-configure-auth) で開始 URL を指定します。 ## ステップ 2: ツールのインストール 1. [変換用の Amazon Q コマンドラインツールをダウンロード](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.2.2.zip)して解凍します。 コマンドラインツールの以前のバージョンをダウンロードするには、「[バージョン履歴](transform-CLI-versions.md)」を参照してください。 1. ツールをインストールするには、Python で仮想環境を設定することをお勧めします。仮想環境を作成するには、ツールをインストールするディレクトリでターミナルウィンドウを開き、以下を実行します。 ``` python -m venv qct-cli ``` 1. 仮想環境を有効にするには、次の手順を実行します。 ``` source qct-cli/bin/activate ``` 1. コマンドラインにツールをインストールするには、マシンアーキテクチャに基づいて、ツールを解凍した場所へのパスで次のコマンドを実行します。 ------ #### [ Linux\$1aarch64 ] ``` pip install /Linux_aarch64/amzn_qct_cli-1.2.2-py3-none-any.whl ``` ------ #### [ Linux\$1x86\$164 ] ``` pip install /Linux_x86_64/amzn_qct_cli-1.2.2-py3-none-any.whl ``` ------ **注記** 変換に古いバージョンのコマンドラインツールを使用している場合は、`1.2.2` をダウンロードした[バージョン](transform-CLI-versions.md)に置き換えます。 1. ツールがインストールされていることを確認するには、以下を実行します。 ``` which qct ``` ## ステップ 3: 依存関係のアップグレードファイルを作成する (オプション) *依存関係のアップグレードファイル*、プロジェクトの依存関係を一覧表示する YAML ファイル、および変換中にアップグレードするバージョンを Amazon Q に提供できます。依存関係のアップグレードファイルを提供することで、Amazon Q がアップグレードについて認識していないサードパーティーおよびファーストパーティーの依存関係を指定できます。 ファーストパーティーの依存関係とは、組織が管理し、ローカルまたは組織のプライベートネットワークでのみ利用可能なライブラリ、プラグイン、フレームワークを指します。Amazon Q は、ローカル環境でビルドを実行する際に、ファーストパーティーの依存関係にアクセスできます。詳細については、「[ローカル環境でのコードの構築](transform-CLI.md#local-builds)」を参照してください。サードパーティーの依存関係は、公開されているか、組織に固有ではないオープンソースの依存関係です。 YAML ファイルでアップグレードするファーストパーティーの依存関係を指定できます。Amazon Q は JDK アップグレード中にそれらをアップグレードします (例: Java 8 から 17 など)。最初の JDK アップグレード後に別の変換 (17 から 17 または 21 から 21) を開始して、サードパーティーの依存関係をアップグレードできます。 Amazon Q が最小限の JDK アップグレードを実行したら、別の変換を開始して、すべてのサードパーティーの依存関係をアップグレードできます。または、サードパーティーの依存関係とそのバージョンを YAML ファイルで指定して、ライブラリのアップグレード変換中にのみそれらの依存関係をアップグレードすることもできます。 Amazon Q では、変換中に依存関係のアップグレードファイルを指定するように求められます。指定する場合は、まずファイルが正しく設定されていることを確認します。YAML ファイルには、次のフィールドが必要です。 + name - 依存関係のアップグレードファイルの名前。 + description (オプション) - 依存関係のアップグレードファイルと、使用する変換の指定。 + dependencyManagement - アップグレードする依存関係とプラグインのリストが含まれています。 + dependencies - アップグレードするライブラリの名前とバージョンが含まれています。 + plugins - アップグレードするプラグインの名前とバージョンが含まれています。 + identifier - ライブラリ、プラグイン、またはその他の依存関係の名前。 + targetVersion - アップグレード先の依存関係のバージョン。 + versionProperty (オプション) - アプリケーションの `pom.xml` ファイルの `properties` タグで設定されている、定義する依存関係のバージョン。 + originType - 依存関係がファーストパーティーかサードパーティーか (FIRST\$1PARTY または THIRD\$1PARTY のいずれかで指定)。 以下は、依存関係のアップグレード YAML ファイルの例と、Amazon Q が解析するために必要な設定です。 ``` name: dependency-upgrade description: "Custom dependency version management for Java migration from JDK 8/11/17 to JDK 17/21" dependencyManagement: dependencies: - identifier: "com.example:library1" targetVersion: "2.1.0" versionProperty: "library1.version" # Optional originType: "FIRST_PARTY" - identifier: "com.example:library2" targetVersion: "3.0.0" originType: "THIRD_PARTY" plugins: - identifier: "com.example.plugin" targetVersion: "1.2.0" versionProperty: "plugin.version" # Optional originType: "THIRD_PARTY" ``` ## ステップ 4: 設定および認証 変換を開始する前に、IAM アイデンティティセンターで認証し、変換の設定の詳細を指定する必要があります。 1. 変換設定プロセスを開始するには、次のコマンドを実行します。 ``` qct configure ``` 1. サポートされている Java バージョンごとに JDK パスを入力するように求められます。Java アプリケーションのソースバージョンの JDK へのパスのみを指定する必要があり、ターゲットバージョンを指定する必要はありません。 1. 次に、IAM アイデンティティセンターで認証するには、Amazon Q Developer Pro サブスクリプションプロファイルの開始 URL を入力するように求められます。 次に、サブスクライブした AWS リージョン を の形式で入力します`us-east-1`。サポートされているリージョンのリストについては「[サポート対象のリージョン](regions.md)」を参照してください。リージョンコードの一覧については、「*AWS 全般のリファレンス guide*」の「[Regional endpoints ](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints)」を参照してください。 1. 設定は configuration.ini ファイルに保存されます。 ## ステップ 5: 変換を実行する 実行する変換のタイプを選択して、必要な設定とコマンドを表示します。 **注記** クライアント側のビルドでは安定したネットワーク接続が必要であるため、コード変換中にローカルマシンをオフまたは閉じないでください。 ------ #### [ Java upgrade ] **変換プランの変更** Java バージョンのアップグレード中、Amazon Q は変換プランを生成し、変換を開始する前に確認できます。プランに対して次の変更をリクエストすることができます。 + プランに含まれる一覧からどのライブラリを Amazon Q がアップグレードするか + プロンプトの例: + 、、 のみをアップグレードする + または をアップグレードしない + ライブラリをアップグレードするターゲットバージョン + プロンプトの例: + の代わりに をこのバージョンにアップグレードする + Amazon Q でどのステップを実行するか + プロンプトの例: + ステップ 1～7 のみを完了する + ステップ 5～9 を実行しない + アップグレードする依存関係を追加する (新しい JDK バージョンにアップグレードする場合のみ選択可) + プロンプトの例: + も にアップグレードする **Java コードのアップグレード** 1. 次のコマンドを実行して、Java アップグレードの変換を開始します。`` を変換するコードを含むフォルダへのパスに、`` を `JAVA_17` または `JAVA_21` に、それぞれ置き換えます。 ``` qct transform --source_folder --target_version ``` 追加のコマンドオプション: + アップグレードする依存関係を指定する場合は、依存関係のアップグレードファイルへのパスを指定して `--dependency_upgrade_file` オプションを追加します。 + 変換プランを確認または更新しない場合は、コマンドに `--no-interactive` フラグを追加します。Amazon Q はプランに関するフィードバックを求めません。また、変更をリクエストする機会もありません。 1. Maven バージョンは、変換を開始する前に検証されます。サポートされている最小バージョンがある場合は、次の出力が表示されます。 ``` Running command: mvn --version at: path/to/current/directory Your Maven version is supported for transformations. ``` サポートされている Maven バージョンがない場合は、更新して続行する必要があります。詳細については、「[前提条件](#CLI-transformation-prerequisites)」を参照してください。 1. `--no-interactive` フラグを追加しなかった場合、Amazon Q は変換プランに関するフィードバックを提供するようプロンプトが表示されます。変更を英語の自然言語で説明できます。Amazon Q は、リクエストした変更をサポートできる場合はプランを更新します。 1. Amazon Q が変換を開始します。変換中にステータスの更新が出力されます。完了すると、Amazon Q は変換結果、ログ、および設定ファイルが出力されるパスを提供します。 アップグレードされたコードは、Amazon Q が作成した新しいブランチにコミットされます。Amazon Q は、`qct configure` の実行時に選択した内容に応じて、1 つ以上のコミットでコードをコミットします。 1. Java バージョンのアップグレード後に別の変換を実行している場合は、最初の変換からの変更をコミットしたのと同じブランチで 2 番目の変換を開始します。 ------ #### [ SQL conversion ] 開始する前に [Amazon Q Developer を使用した Java アプリケーションの埋め込み SQL の変換](transform-sql.md) を読み、このタイプの変換の前提条件を理解してください。 1. 埋め込み SQL を変換するには、まず [AWS DMS スキーマ変換](https://docs.aws.amazon.com/dms/latest/sbs/schema-conversion-oracle-postgresql.html) からスキーマメタデータファイルへのパスを含む YAML ファイルを作成する必要があります。 必要なファイル形式は次のとおりです。 ``` schema_conv_metadata_path: ``` 1. 次のコマンドを実行して、SQL 変換を開始します。`` を変換するコードを含むフォルダへのパスに、`` をステップ 1 で作成した YAML ファイルへのパスに、それぞれ置き換えます。 ``` qct transform --source_folder --sql_conversion_config_file ``` 1. Amazon Q がスキーマメタデータファイルで複数のスキーマを検出した場合、変換を停止し、検出されたスキーマの一覧を提供します。SQL 変換に使用するスキーマを選択し、YAML ファイルに新しいフィールド `schema: ` を追加します。 1. Amazon Q が変換を開始します。変換中にステータスの更新が出力されます。完了すると、Amazon Q は変換結果、ログ、および設定ファイルが出力されるパスを提供します。 アップグレードされたコードは、Amazon Q が作成した新しいブランチにコミットされます。 ------ ## 変換の一時停止またはキャンセル 現在の変換ジョブを一時停止またはキャンセルできます。変換ジョブは、再開するまで最大 12 時間一時停止できます。 **コード変換ジョブを一時停止またはキャンセルするには、次の手順を実行します。** 1. CLI ターミナルで、キーボードの **Ctrl\$1C** を押します。 1. 変換を一時停止するかキャンセルするかを選択します。 + コード変換ジョブを一時停止する場合は、`1` を入力します。12 時間以内にジョブを再開して、QCT コマンド ``qct transform --source_folder=≤/Path/Given/Originally/To/QCT>`` を使用してコード変換を続行できます。 + コード変換ジョブをキャンセルする場合は、`2` を入力します。 # コマンドラインでの変換のトラブルシューティング 以下の情報は、Amazon Q Developer のコマンドラインでアプリケーションを変換する際の一般的な問題のトラブルシューティングに役立ちます。 ## ベアラートークンが更新されないのはなぜですか? 次のエラーが表示された場合は、認証に使用されるベアラートークンを更新する必要があります。 ``` Refreshing bearer token ('Error refreshing bearer token due to: ', InvalidGrantException('An error occurred (InvalidGrantException) when calling the CreateToken operation: ')) ('Error getting bearer token due to: ', RuntimeError(('Error refreshing bearer token due to: ', InvalidGrantException('An error occurred (InvalidGrantException) when calling the CreateToken operation: ')))) ``` このエラーを修正するには、次のコマンドを実行します。 ``` rm ~/.aws/qcodetransform/credentials.json ``` 古い認証情報ファイルを削除したら、`qct transform` を再度実行して変換を再開します。 ## コマンドラインツールの最新バージョンが使用されていないのはなぜですか? 変換用に新しいバージョンのコマンドラインツールをダウンロードしても、以前のバージョンのツールが引き続き使用されることがあります。 ツールの最新バージョンを使用するには、[最新バージョン](transform-CLI-versions.md)をダウンロードします。次に、マシンアーキテクチャに基づいて、ツールを解凍した場所へのパスで次のコマンドを実行します。 ------ #### [ Linux\$1aarch64 ] ``` pip install /Linux_aarch64/amzn_qct_cli-1.2.2-py3-none-any.whl --force-reinstall ``` ------ #### [ Linux\$1x86\$164 ] ``` pip install /Linux_x86_64/amzn_qct_cli-1.2.2-py3-none-any.whl --force-reinstall ``` ------ **注記** 変換に古いバージョンのコマンドラインツールを使用している場合は、`1.2.2` をダウンロードした[バージョン](transform-CLI-versions.md)に置き換えます。 # Amazon Q Developer コマンドライン変換ツールのバージョン履歴 Amazon Q Developer コマンドライン変換ツールの現在および過去のリリースの詳細については、次の情報を参照してください。この表には、各バージョンのダウンロードリンク、リリース日、リリースノートが含まれています。 **** | バージョン | リリース日 | リリースノート | | --- | --- | --- | | [1.2.2 (最新)](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.2.2.zip) | 2026 年 2 月 26 日 | AWS Transform custom のプロモーションバナーを QCT CLI に追加しました。変換コマンドの実行とヘルプテキストにバナーが表示されます。バナー出力を抑制する新しい --skip-banner フラグ。 | | [1.2.1](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.2.1.zip) | 2025 年 9 月 9 日 | 最初のプロジェクトアップロード中にファーストパーティーの親 POM を含めるように Maven 拡張機能を更新 | | [1.2.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.2.0.zip) | 2025 年 8 月 7 日 | Maven Java プロジェクトのジョブ履歴の表示とモジュール構造の視覚化のサポートが追加されました。 | | [1.1.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.1.0.zip) | 2025 年 7 月 21 日 | 変換に関するテレメトリの収集のサポートが含まれています。 | | [1.0.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-1.0.0.zip) | 2025 年 6 月 27 日 | コマンドライン変換ツールは一般公開されており、Amazon Q Developer Pro サブスクリプションでのみ AWS IAM Identity Center による認証をサポートしています。欧州 (フランクフルト) リージョンでのサブスクリプションのサポートが追加されました。 | | [0.6.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.6.0.zip) | 2025 年 6 月 6 日 | 依存関係のアップグレードファイルの提供と変換プランのイテレーションサポートが含まれています。 | | [0.5.2](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.5.2.zip) | 2025 年 4 月 16 日 | ファーストパーティーの依存関係を持つアプリケーションのジョブと失敗を再開する際の問題を解決するためのバグ修正。 | | [0.5.1](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.5.1.zip) | 2025 年 3 月 13 日 | IAM で認証する場合、 AWS リージョンを指定する必要はなくなりました。出力ログのジョブステータスに関するバグ修正も含まれています。 | | [0.5.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.5.0.zip) | 2025 年 2 月 28 日 | を介した IAM による認証のサポートが含まれています AWS CLI。 | | [0.4.1](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.4.1.zip) | 2025 年 2 月 17 日 | Amazon Q Developer サブスクリプションが設定され AWS リージョン ている の入力のサポートを含むバグ修正。 | | [0.4.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.4.0.zip) | 2025 年 2 月 14 日 | Java アプリケーションを Java 21 にアップグレードするためのサポートが含まれています。 | | [0.3.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.3.0.zip) | 2025 年 2 月 12 日 | Java アプリケーションでの埋め込み SQL の変換のサポートが含まれています。 | | [0.2.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.2.0.zip) | 2025 年 2 月 3 日 | 複数のコミットでアップグレードされた Java コードを受信するためのサポートが含まれています。 | | [0.1.0](https://desktop-release.codewhisperer.us-east-1.amazonaws.com/amzn_qct_cli/amzn_qct_cli-0.1.0.zip) | 2024 年 11 月 27 日 | 初回リリース。コマンドラインから Java コードバージョンをアップグレードするためのサポートが含まれています。 |