View a markdown version of this page

Memulai - AWS Transformasi
PrasyaratMenginstal AWS Transformasi CLIMengonfigurasi AutentikasiMelakukan konfigurasi AWS RegionMenjalankan Transformasi Pertama AndaMemahami Hasil TransformasiMembuat Transformasi KustomAWS Transform 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 custom 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)

  • Windows Subsystem for Linux (WSL) - Didukung saat berjalan di bawah WSL

Perangkat Lunak yang Diperlukan

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

  • Git - Harus diinstal dan direktori kerja harus berupa repo Git yang valid untuk menjalankan transformasi. Jalankan git init; git add .; git commit -m "Initial commit" 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 Transformasi 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 CLI AWS Transform yang diinstal.

Mengonfigurasi Autentikasi

AWS Transform custom memerlukan AWS kredensyal untuk mengautentikasi dengan layanan. Konfigurasikan otentikasi menggunakan salah satu metode berikut.

Variabel lingkungan

Mengatur 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 ditetapkan $env: dengan PowerShell berlaku untuk sesi saat ini saja. Untuk mempertahankannya di seluruh sesi, atur melalui System Properties > Environment Variables, atau gunakan[System.Environment]::SetEnvironmentVariable().

AWS Berkas Kredensial

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

[default]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key

Izin IAM

AWS Kredensyal 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 AWS terkelola berikut:

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

catatan

  • Definisi transformasi adalah AWS sumber daya dengan ARN (Amazon Resource Names). Anda dapat menggunakan kebijakan IAM untuk mengontrol akses ke transformasi atau kelompok transformasi tertentu dengan menentukan ARN transformasi dalam laporan 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 Kustom Transform 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 am Main)

  • 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, %USERPROFILE%\.aws\config atau di Windows.

catatan

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

Mengatur Wilayah Anda

Pilih salah satu metode ini 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: Konfigurasi AWS 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, %USERPROFILE%\.aws\config atau di Windows):

[default]
region = <your-region>

[profile your_profile_name]
region = <your-region>

Memverifikasi Konfigurasi Wilayah Anda

Untuk memeriksa wilayah mana yang akan digunakan kustom AWS Transform:

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

regionSourceBidang menunjukkan dari mana wilayah itu 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 terkelola adalah transformasi pra-dibuat dan AWS 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 rinci tentang mode eksekusi, opsi konfigurasi, dan flag perintah, lihatReferensi Perintah.

Memahami Hasil Transformasi

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

Sebagian besar transformasi dilakukan dalam beberapa langkah, menggunakan Git untuk melakukan yang perantara. 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 transformasi AWS-managed tidak memenuhi kebutuhan Anda, Anda dapat membuat transformasi kustom yang disesuaikan dengan kebutuhan spesifik Anda.

Untuk membuat transformasi kustom

  1. Mulai AWS Transform CLI dalam mode interaktif:

    atx

  2. Beri tahu agen bahwa 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 iteratif.

  5. Publikasikan ke registri transformasi organisasi Anda.

Untuk petunjuk rinci tentang membuat transformasi kustom, lihatAlur kerja.

AWS Transform 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 Menyiapkan AWS Transform.

Untuk menggunakan aplikasi web AWS Transform:

  1. Kunjungi https://aws.amazon.com/transform/ dan masuk menggunakan kredensyal AWS IAM Identity Center.

  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 kredensyal standar yang diperlukan.