翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Q Developer を使用したコマンドラインでのコード変換
<a name="transform-CLI"></a>

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)

## ローカル環境でのコードの構築
<a name="local-builds"></a>

変換中、Amazon Q はローカル環境で検証ビルドを実行します。Amazon Q は、サーバー側でコードを複数のステップで変換します。各ステップの後、Amazon Q はローカル環境にコードを送信し、変更をビルドしてテストします。その後、コードをサーバー側に送信して変換を続行します。

ローカル環境のビルドは、Amazon Q がプライベートリソースへのアクセスを必要とするテストを実行できるようにすることで、変換されたコードを検証するのに役立ちます。ローカル環境で AI 生成コードの構築に関連するセキュリティリスクを最小限に抑えるために、Amazon Q は生成するコードを確認し、セキュリティ上の懸念に対応するように更新します。

**注記**  
Amazon Q は、プロジェクトのリクエスト、説明、コンテンツに基づいて変換を実行します。セキュリティを維持するには、外部で未検証のアーティファクトをプロジェクトリポジトリに含めないようにし、機能とセキュリティの両方について変換されたコードを常に検証します。

## コマンド
<a name="commands"></a>

これらのコマンドを実行する手順については、「[Amazon Q Developer のコマンドラインで変換を実行する](run-CLI-transformations.md)」を参照してください。

変換を設定し、Amazon Q Developer Pro に対して認証するには、以下を実行します。

```
qct configure
```

Java アップグレードの変換を開始するには、次のコマンドを実行します。*<your-source-java-version>* には、`JAVA_1.8`、`JAVA_8`、`JAVA_11`、`JAVA_17`、または `JAVA_21` を入力できます。*<your-target-java-version>* には、`JAVA_17` または `JAVA_21` を入力できます。`--source_version` および `--target_version` はオプションです。`--trust` フラグを使用すると、セキュリティを維持するためにコードを検証しながら変換を実行できます。

```
qct transform --source_folder <path-to-folder>
    --source_version <your-source-java-version>        
    --target_version <your-target-java-version>
    --trust
```

SQL 変換を開始するには、以下を実行します。

```
qct transform --source_folder <path-to-folder>
    --sql_conversion_config_file <path-to-sql-config-file>
```

使用している変換用のコマンドラインツールのバージョンを確認するには、以下を実行します。

```
qct -v
```

変換に関するヘルプを表示するには、以下を実行します。

```
qct -h
```

変換ジョブの履歴を表示するには、以下を実行します。

```
qct history
```

変換ジョブ履歴の表示と管理の詳細については、「[コマンドラインでのジョブ履歴の表示](transformation-job-history.md#cli-job-history)」を参照してください。