View a markdown version of this page

Pemecahan masalah - AWS Transformasi
Lokasi LogMasalah UmumMendapatkan DukunganMasalah akses S3

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

Pemecahan masalah

Bagian ini memberikan panduan untuk memecahkan masalah umum dengan AWS Transform custom.

Lokasi Log

AWS Transform CLI memelihara log di lokasi berikut:

Log percakapan:

Linux and macOS
~/.aws/atx/custom/<conversation_id>/logs/<timestamp>-conversation.log
Windows
%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\<timestamp>-conversation.log

Log ini berisi riwayat percakapan lengkap untuk men-debug eksekusi transformasi tertentu.

Log subagen:

Linux and macOS
~/.aws/atx/custom/<conversation_id>/logs/subagents/<name>.log
Windows
%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\subagents\<name>.log

Log ini berisi keluaran dari subagen yang muncul oleh agen utama selama transformasi. Anda tidak perlu mengelola subagen secara langsung.

Log debug pengembang:

Linux and macOS
~/.aws/atx/logs/debug*.log
~/.aws/atx/logs/error.log
Windows
%USERPROFILE%\.aws\atx\logs\debug*.log
%USERPROFILE%\.aws\atx\logs\error.log

Log ini memberikan informasi terperinci tentang operasi dan kesalahan CLI. Setiap file log memiliki batas 5MB sebelum bergulir. Mungkin ada beberapa log debug di direktori ini, seperti debug1.log dan debug2.log.

Masalah Umum

Masalah instalasi:

Jika instalasi gagal, pastikan Anda menginstal Node.js 22 atau yang lebih baru:

node --version

Unduh Node.js dari https://nodejs.org/en/download jika diperlukan.

Masalah otentikasi:

Verifikasi AWS kredensibilitas Anda dikonfigurasi dengan benar:

aws sts get-caller-identity

Pastikan pengguna atau peran IAM Anda memiliki transform-custom:* izin yang diperlukan.

Masalah konektivitas jaringan:

Jika Anda mengalami kesalahan koneksi, verifikasi akses jaringan ke titik akhir yang diperlukan:

  • transform-cli.awsstatic.com

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

  • *.s3.amazonaws.com

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

Masalah konfigurasi wilayah:

Jika Anda mengalami kesalahan terkait wilayah:

  • Verifikasi wilayah Anda didukung

  • Periksa variabel lingkungan yang dapat menggantikan konfigurasi Anda: echo $AWS_REGION $AWS_DEFAULT_REGION

  • Periksa konfigurasi wilayah Anda: aws configure get region

  • Perbarui wilayah Anda jika diperlukan: aws configure set region <your-region>

  • Periksa log debug untuk detail resolusi wilayah

Masalah Git:

Pastikan Git diinstal dan repositori Anda berada di bawah kontrol sumber git:

git --version
git status

AWS Transform custom membutuhkan repositori berada di bawah kontrol sumber git.

Masalah eksekusi transformasi:

Jika transformasi gagal:

  1. Tinjau log percakapan di ~/.aws/atx/custom/<conversation_id>/logs/

  2. Periksa kegagalan build atau pengujian dalam output transformasi

  3. Pastikan perintah build benar untuk proyek Anda

  4. Coba jalankan transformasi dalam mode interaktif untuk memberikan umpan balik

Masalah dimulainya kembali percakapan:

Jika Anda tidak dapat melanjutkan percakapan:

  • Pastikan percakapan berusia kurang dari 30 hari

  • Periksa ID percakapan sudah benar

  • Pastikan Anda memiliki konektivitas jaringan

Mendapatkan Dukungan

Untuk bantuan tambahan, kunjungi AWS Dukungan melalui Kon AWS sol.

Saat membuka tiket dukungan, sertakan:

  • Log percakapan dari ~/.aws/atx/custom/<conversation_id>/logs/

  • Log subagen dari ~/.aws/atx/custom/<conversation_id>/logs/subagents/

  • Debug log dari ~/.aws/atx/logs/

  • Langkah-langkah untuk mereproduksi masalah

  • AWS Transformasikan versi CLI () atx --version

Masalah akses S3

Layanan kustom AWS Transform menjual URL S3 yang telah ditandatangani sebelumnya untuk memudahkan mengunggah dan mengunduh mesin to/from klien file transformasi yang berpotensi besar. Ini berarti bahwa CLI tidak hanya berinteraksi dengan titik akhir layanan AWS Transform tetapi juga berinteraksi dengan titik akhir layanan S3. Interaksi ini menggunakan URL yang telah ditandatangani sebelumnya sehingga kredentif IAM klien Anda tidak memerlukan izin S3 apa pun, tetapi terkadang konfigurasi server proxy mesin lokal Anda dan Kebijakan Titik Akhir S3 VPC jaringan Anda dapat membatasi lalu lintas ini.

Silakan periksa pesan kesalahan yang lebih rinci Lokasi Log untuk membantu akar penyebab kegagalan alat atau akses S3 ditolak terkait dengan mengunduh dan mengunggah file transformasi.

Jika Anda menggunakan VPN/Proxy server yang memanfaatkan variabel https_proxy dan no_proxy lingkungan, pertimbangkan untuk menambahkan nilai berikut ke nilai variabel no_proxy lingkungan Anda untuk melewati proxy untuk titik akhir layanan kustom S3 dan AWS Transform, misalnya:

Linux and macOS
export no_proxy=.s3.amazonaws.com,transform-custom.<region>.api.aws
Windows (PowerShell)
$env:no_proxy=".s3.amazonaws.com,transform-custom.<region>.api.aws"

Jika Anda menggunakan AWS PrivateLink untuk Amazon S3 di VPC Anda, ini mungkin memiliki kebijakan yang ditentukan untuk membatasi lalu lintas S3. Pastikan kebijakan titik akhir VPC S3 Anda mengizinkan GetObject dan PutObject beroperasi untuk bucket milik layanan kustom AWS Transform. Hal ini dapat dicapai dengan menambahkan pernyataan berikut ke kebijakan titik akhir VPC Anda:

{
    "Effect": "Allow",
    "Principal": "*",
    "Action": ["s3:PutObject","s3:GetObject"],
    "Resource": "arn:aws:s3:::aws-transform-custom-*/*"
}

Per Deny nyataan eksplisit dalam kebijakan lebih diutamakan daripada Allow pernyataan. Tinjau kebijakan S3 VPC Endpoint untuk Deny pernyataan yang mungkin membatasi akses.