翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # 開始方法 このセクションでは、 AWS 変換カスタムをセットアップし、最初の変換を実行する方法について説明します。 ## 前提条件 AWS Transform custom をインストールする前に、以下があることを確認してください。 ### サポートされているプラットフォーム AWS 変換カスタムは、次のオペレーティングシステムをサポートしています。 + **Linux** - すべての Linux ディストリビューションのフルサポート + **macOS** - macOS システムのフルサポート + **Windows** - Windows ターミナルと PowerShell を使用したネイティブ Windows のフルサポート (`atx ct`コマンドはまだ Windows ではサポートされていません) + **Linux 用 Windows サブシステム (WSL)** - WSL で実行されている場合にサポートされます ### 必要なソフトウェア + **Node.js 22 以降** - https://nodejs.org/en/download からダウンロード + **Git** - 変換を実行するには、インストールする必要があり、作業ディレクトリが有効な Git リポジトリである必要があります。を実行して`git init; git add .; git commit -m "Initial commit"`、作業ディレクトリで Git リポジトリを初期化します。 ### ネットワークの要件 次のエンドポイントにアクセスできるインターネット接続が必要です。 + `transform-cli.awsstatic.com` + `transform-custom..api.aws` + `*.s3.amazonaws.com` インターネットが制限された環境で作業している場合は、ファイアウォールルールを更新してこれらの URLs。 ## Transform CLI AWS のインストール 推奨されるインストール方法は、 インストールスクリプトを使用することです。オペレーティングシステムのタブを選択します。 ** AWS Transform CLI をインストールするには** 1. インストールスクリプトを実行します。 ------ #### [ Linux and macOS ] ``` curl -fsSL https://transform-cli.awsstatic.com/install.sh | bash ``` ------ #### [ Windows (PowerShell) ] ネイティブ Windows では、PowerShell を使用して Windows ターミナルからインストールスクリプトを実行します。 ``` irm https://transform-cli.awsstatic.com/install.ps1 | iex ``` ------ 1. インストールを確認します。 ``` atx --version ``` コマンドには、インストールされているバージョンの 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" ``` ------ **注記** PowerShell `$env:`の で設定された環境変数は、現在のセッションにのみ適用されます。セッション間で永続化するには、**システムプロパティ** > **環境変数**で設定するか、 を使用します`[System.Environment]::SetEnvironmentVariable()`。 ### 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`](security-iam-awsmanpol.md#security-iam-awsmanpol-AWSTransformCustomFullAccess) AWS 管理ポリシーを IAM ユーザーまたはロールにアタッチすることをお勧めします。このポリシーは、アカウントへの CloudWatch メトリクスの[放出に必要なサービスにリンクされたロール](using-service-linked-roles.md#using-service-linked-roles-custom)を作成するアクセス許可を含む、 AWS 変換カスタムへのフルアクセスを提供します。 より詳細な制御のために、 AWS Transform custom には以下の AWS 管理ポリシーも用意されています。 + [`AWSTransformCustomExecuteTransformations`](security-iam-awsmanpol.md#security-iam-awsmanpol-AWSTransformCustomExecuteTransformations) – 変換を実行するためのアクセスを提供します。 + [`AWSTransformCustomManageTransformations`](security-iam-awsmanpol.md#security-iam-awsmanpol-AWSTransformCustomManageTransformations) – 変換リソースを作成、更新、読み取り、削除したり、変換を実行したりするためのアクセスを提供します。 これらのポリシーの詳細については、[AWSAWS 「Transform の マネージドポリシー](security-iam-awsmanpol.md)」を参照してください。リソースレベルのアクセス許可を持つカスタム IAM ポリシーについては、「カスタム [AWS IAM サービス認可の変換リファレンスガイド](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awstransformcustom.html)」を参照してください。 **注記** 変換定義は、ARNs AWS リソースネーム) を持つリソースです。IAM ポリシーを使用して、IAM ポリシーリソースステートメントで変換 ARN を指定することで、特定の変換または変換グループへのアクセスを制御できます。タグは、グループ化されたアクセスコントロールに使用できます。 AWS AWS 変換にアクセスするには IAM アイデンティティセンターが必要ですが、 CLI を使用する必要はありません。 ## AWS リージョンの設定 AWS 変換カスタムは特定の AWS リージョンで使用でき、標準の AWS CLI 優先順位を使用してリージョン設定を自動的に検出します。 ### サポート対象のリージョン AWS 変換カスタムは、次の AWS リージョンで使用できます。 + `us-east-1` (米国東部 - バージニア北部) + `eu-central-1` (欧州 - フランクフルト) + `eu-west-2` (欧州 - ロンドン) + `ca-central-1` (カナダ - 中央) + `ap-northeast-1` (アジアパシフィック - 東京) + `ap-northeast-2` (アジアパシフィック - ソウル) + `ap-southeast-2` (アジアパシフィック - シドニー) + `ap-south-1` (アジアパシフィック - ムンバイ) ### リージョンの決定方法 CLI は、これらのソースを優先度順にチェックして、使用するリージョンを決定します。 1. `AWS_REGION` 環境変数 (最高優先度) 1. `AWS_DEFAULT_REGION` 環境変数 1. AWS 設定ファイルで選択したプロファイル (`AWS_PROFILE`環境変数経由) 1. AWS 設定ファイルのデフォルトプロファイル 1. 設定が見つからない`us-east-1`場合のデフォルトのフォールバック **注記** AWS 設定ファイルは、`~/.aws/config`Linux および macOS の場合は 、Windows `%USERPROFILE%\.aws\config`の場合は にあります。 **注記** `ATX_CUSTOM_ENDPOINT` が設定されている場合、リージョンはエンドポイント URL から抽出され、他のすべての設定が上書きされます。 ### リージョンの設定 次のいずれかの方法を選択して、リージョンを設定します。 **オプション 1: 環境変数 (一時的な使用に推奨):** ------ #### [ Linux and macOS ] ``` export AWS_REGION= ``` ------ #### [ Windows (PowerShell) ] ``` $env:AWS_REGION="" ``` ------ **オプション 2: AWS CLI 設定 (永続的なセットアップに推奨):** ``` aws configure set region ``` **オプション 3: プロファイル固有の設定:** ------ #### [ Linux and macOS ] ``` aws configure set region --profile your_profile_name export AWS_PROFILE=your_profile_name ``` ------ #### [ Windows (PowerShell) ] ``` aws configure set region --profile your_profile_name $env:AWS_PROFILE="your_profile_name" ``` ------ **オプション 4: ファイルを直接編集する:** 設定ファイルを直接編集します (`~/.aws/config`Linux AWS および macOS の場合、または Windows `%USERPROFILE%\.aws\config`の場合）。 ``` [default] region = [profile your_profile_name] 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」) が表示されます。 **重要** リージョン設定がサポートされていないリージョンを指している場合、CLI は、サポートされているリージョンに設定を更新する手順を含む明確なエラーメッセージを表示します。 ## 最初の変換の実行 開始する最も簡単な方法は、 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 ``` 実行モード、設定オプション、コマンドフラグの詳細については、「」を参照してください[コマンドリファレンス](custom-command-reference.md)。 ## 変換結果について 変換が完了すると、 AWS Transform custom は結果を記述するレポートを提供します。変換が検証されなかった場合 (Java アプリケーションのビルドが成功した場合など）、レポートには今後のアクションに関する推奨事項が表示されます。 ほとんどの変換は複数のステップで実行され、Git を使用して中間変換をコミットします。変換によって行われた変更は、標準の Git コマンドを使用して確認できます。 ``` git status git log git diff {{}} ``` ## カスタム変換の作成 AWSマネージド変換がニーズに合わない場合は、特定の要件に合わせたカスタム変換を作成できます。 **カスタム変換を作成するには** 1. インタラクティブモードで AWS 変換 CLI を起動します。 ``` atx ``` 1. 新しい変換を作成するエージェントに指示し、要件を記述します。 1. 品質を向上させるために、ドキュメントやコードサンプルなどの参考資料を提供します。 1. 変換を繰り返しテストして絞り込みます。 1. 組織の変換レジストリに公開します。 カスタム変換を作成する詳細な手順については、「」を参照してください[ワークフロー](custom-workflows.md)。 ## AWS ウェブアプリケーションの変換 (オプション) AWS Transform ウェブアプリケーションは、複数のリポジトリで大規模な変換キャンペーンをモニタリングするためのオプションのインターフェイスです。 AWS 変換ウェブアプリケーションを使用する前に、組織内の AWS 変換にアクセスするためのユーザー ID を有効にする必要があります。 AWS 変換を有効にする方法については、[AWS 「変換の設定](https://docs.aws.amazon.com/transform/latest/userguide/transform-setup.html)」を参照してください。 ** AWS 変換ウェブアプリケーションを使用するには:** 1. https://aws.amazon.com/transform/ にアクセスして、IAM アイデンティティセンター AWS の認証情報を使用してサインインします。 1. AWS 変換ウェブアプリケーションで「カスタム/コード」ジョブタイプを選択します。 1. 使用する変換定義の名前をエージェントに伝えます。 1. ウェブアプリケーションは、チームと共有できる AWS Transform CLI コマンドを提供します。このコマンドは変換定義を呼び出し、実行結果をウェブアプリケーションに記録します。 1. 変換結果がキャプチャされたら、統計情報、時間節約の測定値を表示し、Dashboard でジョブの進行状況について質問します。 ウェブアプリケーションは、複数のコードベースにわたる変換を一元的にモニタリングする必要があるエンタープライズ規模のオペレーション向けに設計されています。 **注記** AWS AWS Transform ウェブアプリケーションにアクセスするには、IAM Identity Center が必要です。CLI には IAM Identity Center は必要ありません。標準の AWS 認証情報のみが必要です。