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 mengubah kustom.

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 subagent:

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 output dari subagen yang ditimbulkan 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 rinci tentang operasi dan kesalahan CLI. Setiap file log memiliki batas 5MB sebelum berguling. Mungkin ada beberapa log debug di direktori ini, seperti debug1.log dan debug2.log.

Masalah Umum

Masalah instalasi:

Jika instalasi gagal, pastikan Anda memiliki Node.js 22 atau lebih baru diinstal:

node --version

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

Masalah otentikasi:

Verifikasi AWS kredensil 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 menemukan 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. Verifikasi bahwa perintah build sudah benar untuk project 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 Support melalui AWS Konsol.

Saat membuka tiket dukungan, sertakan:

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

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

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

  • Langkah-langkah untuk mereproduksi masalah

  • AWS Transform versi CLI () atx --version

Masalah akses S3

Layanan kustom AWS Transform menjual URL S3 yang telah ditandatangani sebelumnya untuk memfasilitasi pengunggahan dan pengunduhan mesin klien file transformasi yang berpotensi besar. to/from 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 kredensyal IAM klien Anda tidak memerlukan izin S3 apa pun, tetapi terkadang konfigurasi server proxy mesin lokal Anda dan Kebijakan Titik Akhir VPC S3 jaringan Anda dapat membatasi lalu lintas ini.

Silakan periksa Lokasi Log untuk pesan kesalahan yang lebih rinci untuk membantu root menyebabkan kegagalan alat apa pun 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 ditetapkan untuk membatasi lalu lintas S3. Pastikan kebijakan titik akhir VPC S3 Anda GetObject mengizinkan PutObject dan beroperasi untuk AWS bucket milik layanan khusus Transform. 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-*/*"
}

DenyPernyataan eksplisit dalam kebijakan lebih diutamakan daripada pernyataan. Allow Tinjau kebijakan Titik Akhir VPC S3 Deny untuk pernyataan yang mungkin membatasi akses.