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 ct`Perintah 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..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
```
------
1. 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`](security-iam-awsmanpol.md#security-iam-awsmanpol-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](using-service-linked-roles.md#using-service-linked-roles-custom) yang diperlukan untuk emisi CloudWatch metrik ke akun Anda.
Untuk kontrol yang lebih terperinci, AWS Transform custom juga menyediakan kebijakan AWS terkelola berikut:
+ [`AWSTransformCustomExecuteTransformations`](security-iam-awsmanpol.md#security-iam-awsmanpol-AWSTransformCustomExecuteTransformations)— Menyediakan akses untuk mengeksekusi transformasi.
+ [`AWSTransformCustomManageTransformations`](security-iam-awsmanpol.md#security-iam-awsmanpol-AWSTransformCustomManageTransformations)— Menyediakan akses untuk membuat, memperbarui, membaca, dan menghapus sumber daya transformasi, serta menjalankan transformasi.
Untuk informasi selengkapnya tentang kebijakan ini, lihat [kebijakan AWS terkelola untuk AWS Transform](security-iam-awsmanpol.md). Untuk kebijakan IAM kustom dengan izin tingkat sumber daya, lihat Panduan Referensi Otorisasi Layanan [IAM Kustom AWS Transform](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awstransformcustom.html).
**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_REGION`variabel lingkungan (prioritas tertinggi)
1. Variabel lingkungan `AWS_DEFAULT_REGION`
1. Profil yang dipilih dalam file AWS konfigurasi (melalui variabel `AWS_PROFILE` lingkungan)
1. Profil default dalam file AWS konfigurasi
1. 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=
```
------
#### [ Windows (PowerShell) ]
```
$env:AWS_REGION=""
```
------
**Opsi 2: Konfigurasi AWS CLI (direkomendasikan untuk pengaturan permanen):**
```
aws configure set region
```
**Opsi 3: Profile-specific konfigurasi:**
------
#### [ 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"
```
------
**Opsi 4: Pengeditan file langsung:**
Edit file AWS konfigurasi secara langsung (`~/.aws/config`di Linux dan macOS, `%USERPROFILE%\.aws\config` atau di Windows):
```
[default]
region =
[profile your_profile_name]
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"
}
```
`regionSource`Bidang 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, lihat[Referensi Perintah](custom-command-reference.md).
## 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 {{}}
```
## 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
```
1. Beri tahu agen bahwa Anda ingin membuat transformasi baru dan jelaskan kebutuhan Anda.
1. Menyediakan bahan referensi seperti dokumentasi dan sampel kode untuk meningkatkan kualitas.
1. Uji dan perbaiki transformasi secara iteratif.
1. Publikasikan ke registri transformasi organisasi Anda.
Untuk petunjuk rinci tentang membuat transformasi kustom, lihat[Alur kerja](custom-workflows.md).
## 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](https://docs.aws.amazon.com/transform/latest/userguide/transform-setup.html).
**Untuk menggunakan aplikasi web AWS Transform:**
1. Kunjungi https://aws.amazon.com/transform/ dan masuk menggunakan kredensyal AWS IAM Identity Center.
1. Pilih jenis pekerjaan “Custom/code” di aplikasi web AWS Transform.
1. Beri tahu agen nama definisi transformasi yang ingin Anda gunakan.
1. 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.
1. 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.