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

AWS Transform custom の開始方法

このセクションでは、インターフェイスの選択、カスタム AWS 変換の設定、最初の変換の実行方法について説明します。

AWS 変換カスタムを実行する場所を選択する

コマンドライン、Kiro Power、エージェントプラグイン、または IDE プラグインから AWS Transform custom を実行します。各オプションは、同じ AWSマネージド変換定義とカスタム変換定義へのアクセスを提供します。

AWS Transform CLI

ターミナルワークフロー、スクリプト、オートメーションに AWS Transform CLI を使用します。このオプションでは、セットアップを手動で完了します。を確認しAWS 変換 CLI の前提条件、次に を確認しますTransform CLI AWS のインストール。

Kiro Power

Kiro IDE のガイド付き会話ワークフローに AWS Transform Kiro Power を使用します。

1. Kiro IDE を開き、Powers パネルに移動します。

2. AWS 変換を検索してインストールします。

3. Kiro Chat を開き、Power を選択し、Try power を選択します。

インストール後、カスタム AWS 変換をセットアップし、リポジトリで使用できる変換を表示するように Kiro に依頼します。

GitHub のインポートオプションと認証情報については、「」を参照してくださいKiro パワー。

Agent plugin

AWS 変換するリポジトリの Claude Code、Codex、または Cursor で Transform エージェントプラグインを使用します。

Claude Code で をインストールするには

AWS エージェントプラグインマーケットプレイスを追加し、 AWS 変換プラグインをインストールします。

/plugin marketplace add awslabs/agent-plugins
/plugin install aws-transform@agent-plugins-for-aws

Codex またはカーソルに をインストールするには

GitHub ウェブサイトの エージェントプラグインリポジトリ README のインストール手順に従います。詳細については、「エージェントプラグイン」を参照してください。

インストール後、コーディングエージェントに AWS Transform custom を設定し、リポジトリで使用できる変換を表示するように依頼します。

IDE plugin

AWS Transform IDE プラグインを使用して、VS Code または Open VSX 互換エディタから変換定義を作成して実行します。

• VS Code: VS Code Marketplace からプラグインをインストールします。

• Open VSX: Open VSX レジストリからプラグインをインストールします。

詳細については、「IDE プラグイン」を参照してください。

AWS Transform CLI を選択した場合は、次の CLI の前提条件に進みます。別のオプションを選択した場合は、選択したタブの設定手順に従ってください。

複数のリポジトリにわたる変換キャンペーンの集中モニタリングについては、「」を参照してくださいAWS ウェブアプリケーションの変換 (オプション)。

AWS 変換 CLI の前提条件

AWS Transform custom をインストールする前に、以下があることを確認してください。

サポートされているプラットフォーム

AWS 変換カスタムは、次のオペレーティングシステムをサポートしています。

必要なソフトウェア

ネットワークの要件

次のエンドポイントにアクセスできるインターネット接続が必要です。

インターネットが制限された環境で作業している場合は、ファイアウォールルールを更新して、これらの URLs。

Transform CLI AWS のインストール

推奨されるインストール方法は、 インストールスクリプトを使用することです。オペレーティングシステムのタブを選択します。

AWS Transform CLI をインストールするには

認証の設定

AWS 変換カスタムには、 サービスで認証するための AWS 認証情報が必要です。次のいずれかの方法を使用して認証を設定します。

環境可変

次の環境変数を設定します。

Linux and macOS

export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_SESSION_TOKEN=your_session_token

Windows (PowerShell)

$env:AWS_ACCESS_KEY_ID="your_access_key"
$env:AWS_SECRET_ACCESS_KEY="your_secret_key"
$env:AWS_SESSION_TOKEN="your_session_token"

AWS_PROFILE 環境変数を使用してプロファイルを指定することもできます。

Linux and macOS

export AWS_PROFILE=your_profile_name

Windows (PowerShell)

$env:AWS_PROFILE="your_profile_name"

AWS 認証情報ファイル

Linux および macOS、または Windows %USERPROFILE%\.aws\credentialsの にある AWS 認証情報ファイル~/.aws/credentialsで認証情報を設定します。

[default]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key

IAM 許可

AWS 認証情報には、 AWS 変換カスタムサービスを呼び出すためのアクセス許可が必要です。AWSTransformCustomFullAccess AWS 管理ポリシーを IAM ユーザーまたはロールにアタッチすることをお勧めします。このポリシーは、アカウントへの CloudWatch メトリクスの放出に必要なサービスにリンクされたロールを作成するアクセス許可を含む、 AWS 変換カスタムへのフルアクセスを提供します。

より詳細な制御のために、 AWS Transform custom には以下の AWS 管理ポリシーも用意されています。

これらのポリシーの詳細については、AWSAWS 「Transform の マネージドポリシー」を参照してください。リソースレベルのアクセス許可を持つカスタム IAM ポリシーについては、「カスタム AWS IAM サービス認可の変換リファレンスガイド」を参照してください。

AWS リージョンの設定

AWS 変換カスタムは特定の AWS リージョンで使用でき、標準の AWS CLI 優先順位を使用してリージョン設定を自動的に検出します。

サポート対象のリージョン

AWS 変換カスタムは、次の AWS リージョンで使用できます。

リージョンの決定方法

CLI は、これらのソースを優先度順にチェックして、使用するリージョンを決定します。

リージョンの設定

リージョンを設定するには、次のいずれかの方法を選択します。

オプション 1: 環境変数 (一時的な使用に推奨):

Linux and macOS

export AWS_REGION=<your-region>

Windows (PowerShell)

$env:AWS_REGION="<your-region>"

オプション 2: AWS CLI 設定 (永続的なセットアップに推奨):

aws configure set region <your-region>

オプション 3: プロファイル固有の設定:

Linux and macOS

aws configure set region <your-region> --profile your_profile_name
export AWS_PROFILE=your_profile_name

Windows (PowerShell)

aws configure set region <your-region> --profile your_profile_name
$env:AWS_PROFILE="your_profile_name"

オプション 4: ファイルを直接編集する:

設定ファイルを直接編集します (~/.aws/configLinux AWS および macOS の場合、または Windows %USERPROFILE%\.aws\configの場合）。

[default]
region = <your-region>

[profile your_profile_name]
region = <your-region>

リージョン設定の検証

Transform AWS custom が使用するリージョンを確認するには:

現在のリージョン設定を確認します。

aws configure get region

環境変数を確認します。

Linux and macOS

echo "AWS_REGION: $AWS_REGION"
echo "AWS_DEFAULT_REGION: $AWS_DEFAULT_REGION"
echo "AWS_PROFILE: $AWS_PROFILE"

Windows (PowerShell)

echo "AWS_REGION: $env:AWS_REGION"
echo "AWS_DEFAULT_REGION: $env:AWS_DEFAULT_REGION"
echo "AWS_PROFILE: $env:AWS_PROFILE"

デバッグログで詳細なリージョン解決を表示します。

Linux and macOS

tail -f ~/.aws/atx/logs/debug.log

Windows (PowerShell)

Get-Content "$env:USERPROFILE\.aws\atx\logs\debug.log" -Wait -Tail 10

リージョンソースを示すログ出力の例:

2026-01-07 22:34:28 [DEBUG]: Initializing FrontendServiceClient with config:
{
  "endpoint": "https://transform-custom.us-east-1.api.aws",
  "region": "us-east-1",
  "regionSource": "AWS_REGION"
}

regionSource フィールドには、リージョンの派生元 (例：「aws-config (プロファイル: default)」、AWS_REGION」、「default」) が表示されます。

最初の変換の実行

開始する最も簡単な方法は、 AWSマネージド変換を使用することです。 AWSマネージド変換は、事前に構築され、 AWS検証された変換であり、セットアップなしですぐに使用できます。

AWSマネージド変換をインタラクティブに実行するには:

atx

次に、変換を実行するようにエージェントに依頼します。

Execute the AWS/java-aws-sdk-v1-to-v2 transformation on the codebase at ./my-java-project

変換を非インタラクティブに実行するには:

atx custom def exec -n AWS/java-aws-sdk-v1-to-v2 -p ./my-java-project -c "mvn clean install" -x -t

実行モード、設定オプション、コマンドフラグの詳細については、「」を参照してくださいコマンドリファレンス。

変換結果について

変換が完了すると、 AWS Transform custom は結果を記述するレポートを提供します。変換が検証されなかった場合 (Java アプリケーションのビルドが成功した場合など）、レポートには今後のアクションに関する推奨事項が表示されます。

ほとんどの変換は複数のステップで実行され、Git を使用して中間変換をコミットします。変換によって行われた変更は、標準の Git コマンドを使用して確認できます。

git status
git log
git diff <original commit-id> 

カスタム変換の作成

AWSマネージド変換がニーズに合わない場合は、特定の要件に合わせたカスタム変換を作成できます。

カスタム変換を作成するには

カスタム変換を作成する詳細な手順については、「」を参照してくださいワークフロー。

AWS ウェブアプリケーションの変換 (オプション)

AWS Transform ウェブアプリケーションは、複数のリポジトリで大規模な変換キャンペーンをモニタリングするためのオプションのインターフェイスです。 AWS 変換ウェブアプリケーションを使用する前に、組織内の AWS 変換にアクセスするためのユーザー ID を有効にする必要があります。 AWS 変換を有効にする方法については、AWS 「変換の設定」を参照してください。

AWS 変換ウェブアプリケーションを使用するには:

ウェブアプリケーションは、複数のコードベースにわたる変換を一元的にモニタリングする必要があるエンタープライズ規模のオペレーション向けに設計されています。