View a markdown version of this page

Memulai - AWS Transformasi
PrasyaratMenginstal AWS Ubah CLIMengonfigurasi AutentikasiMelakukan konfigurasi AWS RegionMenjalankan Transformasi Pertama AndaMemahami Hasil TransformasiMembuat Transformasi KustomAWS Transformasi Aplikasi Web (Opsional)

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memulai

Bagian ini menjelaskan cara mengatur AWS Transform kustom dan menjalankan transformasi pertama Anda.

Prasyarat

Sebelum menginstal AWS Transform custom, pastikan Anda memiliki yang berikut:

Platform yang Didukung

AWS Transform custom mendukung sistem operasi berikut:

  • Linux - Dukungan penuh untuk semua distribusi Linux

  • macOS - Dukungan penuh untuk sistem macOS

  • Windows - Dukungan penuh untuk Windows asli menggunakan Terminal Windows dan PowerShell (atx ctPerintah belum didukung pada Windows)

  • Subsistem Windows untuk Linux (WSL) - Didukung saat berjalan di bawah WSL

Perangkat Lunak yang Diperlukan

  • Node.js 22 atau yang lebih baru - Unduh dari https://nodejs.org/en/download

  • Git - Harus diinstal dan direktori kerja harus menjadi repo Git yang valid untuk menjalankan transformasi. Jalan git init; git add .; git commit -m "Initial commit" kan untuk menginisialisasi repo Git di direktori kerja Anda.

Persyaratan Jaringan

Koneksi internet dengan akses ke titik akhir berikut diperlukan:

  • transform-cli.awsstatic.com

  • transform-custom.<region>.api.aws

  • *.s3.amazonaws.com

Jika Anda bekerja di lingkungan yang dibatasi internet, perbarui aturan firewall untuk mengizinkan daftar URL ini.

Menginstal AWS Ubah CLI

Metode instalasi yang disarankan adalah menggunakan skrip instalasi. Pilih tab untuk sistem operasi Anda.

Untuk menginstal AWS Transform CLI

  1. Jalankan skrip instalasi:

    Linux and macOS
    curl -fsSL https://transform-cli.awsstatic.com/install.sh | bash
    Windows (PowerShell)

    Pada Windows asli, jalankan skrip instalasi dari Terminal Windows menggunakan PowerShell.

    irm https://transform-cli.awsstatic.com/install.ps1 | iex

  2. Verifikasi instalasi:

    atx --version

    Perintah harus menampilkan versi yang diinstal dari AWS Transform CLI.

Mengonfigurasi Autentikasi

AWS Transform kustom memerlukan AWS kredentif untuk diautentikasi dengan layanan. Konfigurasikan otentikasi menggunakan salah satu metode berikut.

Variabel lingkungan

Tetapkan variabel lingkungan berikut.

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"

Anda juga dapat menentukan profil menggunakan variabel AWS_PROFILE lingkungan.

Linux and macOS
export AWS_PROFILE=your_profile_name
Windows (PowerShell)
$env:AWS_PROFILE="your_profile_name"
catatan

Variabel lingkungan yang diset $env: el dengan in PowerShell berlaku untuk sesi saat ini saja. Untuk mempertahankannya di seluruh sesi, atur melalui System Properties > En vironment Vari ables, atau gunakan[System.Environment]::SetEnvironmentVariable().

AWS File KredenSIAL

Konfigurasikan kreden AWS SIAL dalam file kredenSIAL, terletak ~/.aws/credentials di Linux dan macOS, atau %USERPROFILE%\.aws\credentials di Windows:

[default]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key

Izin IAM

Kre AWS densibilitas Anda harus memiliki izin untuk memanggil layanan kustom AWS Transform. Sebaiknya lampirkan kebijakan AWSTransformCustomFullAccess AWS terkelola ke pengguna atau peran IAM Anda. Kebijakan ini menyediakan akses penuh ke kustom AWS Transform, termasuk izin untuk membuat peran terkait layanan yang diperlukan untuk emisi CloudWatch metrik ke akun Anda.

Untuk kontrol yang lebih terperinci, AWS Transform custom juga menyediakan kebijakan ter AWS kelola berikut:

Untuk informasi selengkapnya tentang kebijakan ini, lihat kebijakan ter AWS kelola untuk AWS Transformasi. Untuk kebijakan IAM kustom dengan izin tingkat sumber daya, lihat Panduan Referensi Otorisasi Layanan AWS Transformasi Kustom IAM.

catatan

  • Definisi transformasi adalah AWS sumber daya dengan ARN (Nama Sumber Daya Amazon). Anda dapat menggunakan kebijakan IAM untuk mengontrol akses ke transformasi atau grup transformasi tertentu dengan menentukan ARN transformasi dalam pernyataan sumber daya kebijakan IAM Anda. Tag dapat digunakan untuk kontrol akses yang dikelompokkan.

  • AWS IAM Identity Center diperlukan untuk mengakses AWS Transform, tetapi tidak diperlukan untuk menggunakan CLI.

Melakukan konfigurasi AWS Region

AWS Transform custom tersedia di AWS wilayah tertentu dan secara otomatis mendeteksi konfigurasi wilayah Anda menggunakan prioritas AWS CLI standar.

Wilayah yang Didukung

AWS Transform custom tersedia di AWS wilayah berikut:

  • us-east-1(AS Timur - Virginia Utara)

  • eu-central-1(Eropa - Frankfurt)

  • eu-west-2(Eropa - London)

  • ca-central-1(Kanada - Tengah)

  • ap-northeast-1(Asia Pasifik - Tokyo)

  • ap-northeast-2(Asia Pasifik - Seoul)

  • ap-southeast-2(Asia Pasifik - Sydney)

  • ap-south-1(Asia Pasifik - Mumbai)

Bagaimana wilayah ditentukan

CLI memeriksa sumber-sumber ini dalam urutan prioritas untuk menentukan wilayah mana yang akan digunakan:

  1. AWS_REGIONvariabel lingkungan (prioritas tertinggi)

  2. Variabel lingkungan AWS_DEFAULT_REGION

  3. Profil yang dipilih dalam file AWS konfigurasi (melalui variabel AWS_PROFILE lingkungan)

  4. Profil default dalam file AWS konfigurasi

  5. Fallback default ke us-east-1 jika tidak ada konfigurasi yang ditemukan

catatan

File AWS konfigurasi terletak ~/.aws/config di Linux dan macOS, atau %USERPROFILE%\.aws\config di Windows.

catatan

Jika ATX_CUSTOM_ENDPOINT disetel, wilayah akan diekstrak dari URL titik akhir dan mengganti semua pengaturan lainnya.

Mengatur Wilayah Anda

Pilih salah satu metode berikut untuk mengonfigurasi wilayah Anda:

Opsi 1: Variabel lingkungan (direkomendasikan untuk penggunaan sementara):

Linux and macOS
export AWS_REGION=<your-region>
Windows (PowerShell)
$env:AWS_REGION="<your-region>"

Opsi 2: Konfigur AWS asi CLI (direkomendasikan untuk pengaturan permanen): 

aws configure set region <your-region>

Opsi 3: Profile-specific konfigurasi:

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"

Opsi 4: Pengeditan file langsung:

Edit file AWS konfigurasi secara langsung (~/.aws/configdi Linux dan macOS, atau %USERPROFILE%\.aws\config di Windows):

[default]
region = <your-region>

[profile your_profile_name]
region = <your-region>

Memverifikasi Konfigurasi Wilayah Anda

Untuk memeriksa wilayah mana AWS Transform custom akan digunakan:

Periksa pengaturan wilayah saat ini: 

aws configure get region

Periksa variabel lingkungan:

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"

Lihat resolusi wilayah terperinci di log debug:

Linux and macOS
tail -f ~/.aws/atx/logs/debug.log
Windows (PowerShell)
Get-Content "$env:USERPROFILE\.aws\atx\logs\debug.log" -Wait -Tail 10

Contoh keluaran log yang menunjukkan sumber wilayah:

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"
}

Bid regionSource ang menunjukkan dari mana wilayah tersebut berasal (misalnya, “aws-config (profile: default)”, “AWS_REGION”, “default”).

penting

Jika konfigurasi wilayah Anda menunjuk ke wilayah yang tidak didukung, CLI akan menampilkan pesan kesalahan yang jelas dengan instruksi untuk memperbarui konfigurasi Anda ke wilayah yang didukung.

Menjalankan Transformasi Pertama Anda

Cara tercepat untuk memulai adalah dengan menggunakan transformasi yang AWS dikelola. AWS Transformasi yang dikelola adalah transformasi yang telah AWS dibuat sebelumnya dan diperiksa yang siap digunakan tanpa pengaturan apa pun.

Untuk menjalankan transformasi yang AWS dikelola secara interaktif: 

atx

Kemudian minta agen untuk melakukan transformasi:

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

Untuk menjalankan transformasi secara non-interaktif: 

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

Untuk informasi terperinci tentang mode eksekusi, opsi konfigurasi, dan flag perintah, lihatReferensi Perintah.

Memahami Hasil Transformasi

Ketika transformasi selesai, kustom AWS Transform menyediakan laporan yang menjelaskan hasilnya. Jika transformasi tidak divalidasi (misalnya berhasil membangun untuk aplikasi Java), laporan memberikan rekomendasi untuk tindakan lebih lanjut.

Sebagian besar transformasi dilakukan dalam beberapa langkah, menggunakan Git untuk melakukan yang menengah. Anda dapat meninjau perubahan yang dibuat oleh transformasi menggunakan perintah Git standar:

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

Membuat Transformasi Kustom

Ketika AWS transformasi yang dikelola tidak memenuhi kebutuhan Anda, Anda dapat membuat transformasi khusus yang disesuaikan dengan kebutuhan spesifik Anda.

Untuk membuat transformasi kustom

  1. Mulai AWS Transform CLI dalam mode interaktif:

    atx

  2. Beri tahu agen Anda ingin membuat transformasi baru dan jelaskan kebutuhan Anda.

  3. Menyediakan bahan referensi seperti dokumentasi dan sampel kode untuk meningkatkan kualitas.

  4. Uji dan perbaiki transformasi secara berulang.

  5. Publikasikan ke registri transformasi organisasi Anda.

Untuk petunjuk terperinci tentang membuat transformasi kustom, lihatAlur Kerja.

AWS Transformasi Aplikasi Web (Opsional)

Aplikasi web AWS Transform adalah antarmuka opsional untuk memantau kampanye transformasi skala besar di beberapa repositori. Sebelum menggunakan aplikasi web AWS Transform, Anda harus mengaktifkan identitas pengguna untuk mengakses AWS Transform di organisasi Anda. Untuk informasi tentang mengaktifkan AWS Transform, lihat Men yiapkan AWS Transform.

Untuk menggunakan aplikasi web AWS Transform:

  1. Kunjungi https://aws.amazon.com/transform/ dan masuk menggunakan kredensional Pusat Identitas AWS IAM.

  2. Pilih jenis pekerjaan “Custom/code” di aplikasi web AWS Transform.

  3. Beri tahu agen nama definisi transformasi yang ingin Anda gunakan.

  4. Aplikasi web menyediakan perintah AWS Transform CLI yang dapat dibagikan dengan tim Anda. Perintah ini memanggil definisi transformasi dan mencatat hasil eksekusi ke aplikasi web.

  5. Setelah hasil transformasi ditangkap, lihat statistik, pengukuran penghematan waktu, dan ajukan pertanyaan tentang kemajuan pekerjaan Anda di Dasbor.

Aplikasi web dirancang untuk operasi skala perusahaan di mana Anda memerlukan pemantauan transformasi terpusat di beberapa basis kode.

catatan

AWS IAM Identity Center diperlukan untuk mengakses aplikasi web AWS Transform. CLI tidak memerlukan Pusat Identitas IAM - hanya AWS kredenSIAL standar yang diperlukan.