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

開始方法

このセクションでは、 AWS 変換カスタムをセットアップし、最初の変換を実行する方法について説明します。

前提条件

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 変換ウェブアプリケーションを使用するには:

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