View a markdown version of this page

Khusus - AWS Transformasi
Apa itu AWS Ubah kustom?Memahami Konsep KunciPengantar perintah transformasi khusus

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

Khusus

Apa itu AWS Ubah kustom?

AWS Transform custom menggunakan agentic AI untuk melakukan modernisasi skala besar perangkat lunak, kode, pustaka, dan kerangka kerja untuk mengurangi utang teknis. Ini menangani beragam skenario termasuk peningkatan versi bahasa, migrasi API dan layanan, peningkatan dan migrasi kerangka kerja, refactoring kode, dan transformasi khusus organisasi.

Melalui pembelajaran berkelanjutan, agen meningkatkan dari setiap eksekusi dan umpan balik pengembang, memberikan transformasi berkualitas tinggi dan berulang tanpa memerlukan keahlian otomatisasi khusus.

Kemampuan Kunci

AWS Transform custom menyediakan kemampuan berikut:

  • Definisi transformasi berbasis bahasa alami - Buat transformasi khusus menggunakan bahasa alami, dokumentasi, dan sampel kode

  • Eksekusi transformasi - Terapkan transformasi secara konsisten dan andal di beberapa basis kode

  • Pembelajaran berkelanjutan - Secara otomatis meningkatkan kualitas transformasi dari setiap eksekusi

  • AWS-transformasi terkelola - Gunakan transformasi yang siap digunakan dan diperiksa untuk skenario AWS umum

Pola Transformasi

AWS Transform custom mendukung beragam pola transformasi untuk memenuhi kebutuhan modernisasi Anda. Setiap pola memiliki karakteristik kompleksitas yang berbeda berdasarkan ruang lingkup dan sifat perubahan yang diperlukan.

Pola Deskripsi Kompleksitas Contoh
Migrasi API dan Layanan Migrasi antara versi API atau layanan yang setara sambil mempertahankan fungsionalitas Sedang AWS SDK v1 → v2 (Jawa, Python,), Boto2 → Boto3, JUnit 4 → 5, JavaScript javax → jakarta
Upgrade Versi Bahasa Memutakhirkan ke versi yang lebih baru dari bahasa pemrograman yang sama, mengadopsi fitur baru dan mengganti fungsionalitas yang tidak digunakan lagi Low-Medium Java 8 → 17, Python 3.9 → 3.13, 12 → 22, peningkatan versi Node.js TypeScript
Upgrade Kerangka Memutakhirkan ke versi yang lebih baru dari kerangka kerja yang sama, mengatasi perubahan yang melanggar Sedang Spring Boot 2.x → 3.x, React 17 → 18, peningkatan sudut, peningkatan Django
Migrasi Kerangka Bermigrasi ke kerangka kerja yang sama sekali berbeda yang melayani tujuan serupa Tinggi Angular → Bereaksi, Redux → Zustand, → Bereaksi Vue.js
Upgrade Perpustakaan dan Ketergantungan Memutakhirkan pustaka pihak ketiga ke versi yang lebih baru sambil mempertahankan bahasa dan kerangka kerja yang sama Low-Medium Pandas 1.x → 2.x, NumPy peningkatan, peningkatan perpustakaan, peningkatan Lodash Hadoop/HBase/Hive
Refactoring Kode dan Modernisasi Pola Memodernisasi pola kode dan mengadopsi praktik terbaik tanpa mengubah fungsionalitas eksternal Low-Medium Cetak → Kerangka kerja logging, penggabungan string → f-string, adopsi petunjuk tipe, instrumentasi observabilitas
Skrip dan File-by-File Terjemahan Menerjemahkan skrip independen atau file konfigurasi di mana file sebagian besar mandiri Low-Medium AWS CDK → Terraform, Terraform →, Excel→notebook Python, CloudFormation Bash→ PowerShell
Migrasi Arsitektur Migrasi antara arsitektur perangkat keras atau lingkungan runtime dengan perubahan kode minimal Medium-High x86 →AWS Graviton (ARM), On-premis→Lambda, server tradisional → kontainer
Language-to-Language Migrasi Menerjemahkan basis kode dari satu bahasa pemrograman ke bahasa pemrograman lainnya Sangat tinggi Java→Python, →, C → Karat, Python JavaScript → Go TypeScript
Kustom dan Organization-Specific Transformasi Persyaratan organisasi yang unik dan kebutuhan modernisasi khusus Bervariasi Migrasi pustaka internal khusus, standar pengkodean khusus organisasi, migrasi kerangka kerja berpemilik
catatan

Untuk COBOL/mainframe bahasa, gunakan AWS Transform for Mainframe. Untuk upgrade .NET Framework ke .NET Core, pertimbangkan AWS Transform untuk Windows. Untuk migrasi VMware, pertimbangkan AWS Transform for VMware. AWS

Bagaimana AWS Mengubah Karya kustom

AWS Transform custom biasanya digunakan dalam proyek skala besar di mana beberapa basis kode atau modul diubah. Tim biasanya mengikuti alur kerja empat fase:

Tentukan Transformasi - Berikan petunjuk bahasa alami, dokumentasi, dan sampel kode kepada agen, yang menghasilkan definisi transformasi awal. Definisi ini dapat disempurnakan secara iteratif melalui obrolan atau pengeditan langsung. Fase ini dapat dilewati saat menggunakan transformasi AWS-managed.

Pilot atau Proof-of-Concept - Uji transformasi pada basis kode sampel dan perbaiki berdasarkan hasil. Fase validasi ini membantu memperkirakan biaya dan upaya transformasi penuh. Pembelajaran berkelanjutan meningkatkan kualitas selama fase ini.

Eksekusi Berskala - Siapkan eksekusi massal otomatis menggunakan CLI, dengan pengembang meninjau dan memvalidasi hasil. Pantau kemajuan menggunakan aplikasi web dan melacak transformasi di beberapa repositori.

Monitor dan Tinjau - Pembelajaran berkelanjutan secara otomatis meningkatkan kualitas transformasi. Tinjau pelajaran yang telah diambil dari proses sebelumnya untuk memastikan mereka memenuhi standar kualitas, dan arsipkan apa pun yang tidak berguna.

Memahami Konsep Kunci

Bagian ini menjelaskan konsep-konsep kunci untuk bekerja dengan AWS Transform custom.

Definisi Transformasi

Definisi transformasi berisi instruksi dan pengetahuan yang diperlukan untuk melakukan transformasi kode tertentu. Ini direpresentasikan sebagai keterampilan dan terdiri dari:

  • SKILL.md(wajib) - Instruksi dalam Penurunan Harga dengan frontmatter YAMAL (namedan description bidang) yang berisi logika transformasi inti dan instruksi eksekusi

  • references/folder (opsional) - Dokumentasi dimuat sesuai kebutuhan selama eksekusi transformasi

  • scripts/folder (opsional) - Skrip yang diunduh dan dijalankan transformasi selama eksekusi

AWS Transform CLI secara otomatis mengunduh definisi transformasi ke direktori saat ini bila diperlukan untuk eksekusi, inspeksi, atau modifikasi.

penting

Saat menerbitkan transformasi, direktori harus berisi hanya SKILL.md dan opsional references/ folder, scripts/ folder, atau keduanya. Tidak ada file atau subdirektori lain yang diizinkan.

catatan

CLI versi 2.0 dan yang lebih baru menggunakan format keterampilan. Definisi transformasi yang ada secara otomatis ditangani oleh CLI.

Registri Transformasi

Registri transformasi adalah repositori terpusat AWS akun Anda untuk menyimpan dan mengelola definisi transformasi. Transformasi dalam registri dapat berupa:

  • Terdaftar menggunakan atx custom def list

  • Dieksekusi di beberapa basis kode

  • Dibagikan dengan pengguna lain di AWS akun Anda

  • Version-controlled

penting

Definisi transformasi bersifat spesifik akun. Jika Anda ingin menggunakan transformasi di AWS akun yang berbeda, Anda harus mempublikasikannya secara terpisah di akun itu.

Draf vs Transformasi yang Diterbitkan

AWS Transform custom mendukung dua status untuk transformasi dalam registri:

Transformasi draf adalah definisi transformasi yang sedang berlangsung atau belum teruji. Mereka disimpan sebagai versi tertentu dan dapat diambil, diperbarui, dan dieksekusi oleh pengguna yang mengacu pada versi tertentu. Draf berguna untuk pengembangan berulang, pengujian, dan penyempurnaan sebelum transformasi siap untuk dibagikan dengan tim Anda. Draf juga terkait dengan percakapan tertentu. Jika Anda me-restart CLI, Anda dapat menggunakan atx --conversation-id {id} untuk memulihkan yang sebelumnya.

Transformasi yang dipublikasikan tersedia di registri transformasi akun Anda untuk dieksekusi oleh pengguna lain dengan izin IAM yang diperlukan. Transformasi yang dipublikasikan dapat ditemukan menggunakanatx custom def list.

Alur kerja tipikal adalah:

  1. Buat transformasi secara lokal

  2. Simpan sebagai draf untuk pengujian (atx custom def save-draft)

  3. Perbaiki dan validasi

  4. Publikasikan untuk dibagikan dengan tim Anda (atx custom def publish)

Anda juga dapat mempublikasikan transformasi secara langsung tanpa menyimpannya sebagai draf.

Referensi vs. Pelajaran

AWS Transform custom menggunakan dua jenis pengetahuan untuk meningkatkan kualitas transformasi:

Referensi adalah dokumentasi yang disediakan pengguna yang disimpan dalam references/ folder definisi transformasi. Referensi hanya mendukung file teks (total maksimum 10MB untuk semua file) dan biasanya berisi dokumentasi, spesifikasi API, panduan migrasi, dan contoh kode. Referensi dimuat sesuai kebutuhan selama eksekusi transformasi. Anda menambahkan referensi saat membuat atau memperbarui definisi transformasi dalam mode interaktif.

Pelajaran secara otomatis diekstraksi dari transformasi sebelumnya. Sistem pembelajaran berkelanjutan menghasilkannya dari lintasan eksekusi, umpan balik pengembang, dan perbaikan kode yang ditemuinya selama transformasi. Ini mengelompokkan pelajaran terkait ke dalam kategori sehingga Anda dapat meninjaunya bersama. Tidak seperti referensi, yang Anda berikan di muka, pelajaran terakumulasi dari waktu ke waktu saat Anda menjalankan transformasi di berbagai basis kode, dan sistem menerapkannya secara otomatis untuk meningkatkan proses masa depan. Anda meninjau dan mengelola pelajaran secara interaktif denganatx custom def learnings.

Perintah Build dan Validasi

Perintah build atau validasi adalah parameter opsional yang menentukan cara memvalidasi kode Anda selama proses transformasi. Perintah ini dijalankan di berbagai titik selama transformasi untuk memastikan integritas kode.

Memberikan perintah yang memvalidasi hasil dan mengembalikan masalah jika validasi gagal sangat penting untuk meningkatkan kualitas transformasi melalui pembelajaran berkelanjutan. Jika tidak diperlukan build atau validasi, hilangkan input Anda.

Untuk contoh dan panduan terperinci, lihat Perintah Membangun dan Validasi di bagian Alur Kerja.

Pembelajaran Terus Berkelanjutan

Pembelajaran berkelanjutan adalah sistem yang secara otomatis menangkap umpan balik dari setiap eksekusi transformasi dan meningkatkan kualitas transformasi dari waktu ke waktu. Sistem mengumpulkan informasi melalui:

  • Umpan balik eksplisit - Komentar dan perbaikan kode disediakan dalam mode interaktif

  • Pengamatan implisit - Masalah yang dihadapi agen saat mengubah dan men-debug kode

Sistem pembelajaran berkelanjutan memproses informasi ini untuk menciptakan pelajaran yang ditambahkan ke definisi transformasi untuk meningkatkan transformasi masa depan. Sistem menjalankan proses pembelajaran secara otomatis setelah transformasi selesai, tidak memerlukan masukan tambahan dari Anda.

penting

Pelajaran bersifat spesifik transformasi dan tidak dibagikan di berbagai transformasi atau akun pelanggan yang berbeda.

Mengelola Pelajaran

Sistem menghasilkan pelajaran secara otomatis, tetapi Anda tetap mengendalikan pelajaran mana yang berlaku untuk masa depan. atx custom def learningsPerintah membuka sesi terminal interaktif untuk meninjau dan mengkurasi pelajaran yang telah diakumulasikan oleh transformasi.

Dalam sesi ini, Anda dapat:

  • Jelajahi pelajaran yang dikelompokkan ke dalam kategori, dan lihat berapa banyak pelajaran aktif yang terkandung di setiap kategori.

  • Buka pelajaran untuk membaca detail lengkapnya, termasuk badan pelajaran, dampaknya, dan berapa banyak proses sebelumnya yang dikonsultasikan.

  • Arsipkan pelajaran untuk mencegah sistem menerapkannya ke future run, dan mengembalikannya nanti jika diperlukan.

  • Hapus pelajaran yang diarsipkan secara permanen yang tidak lagi berguna.

Untuk instruksi langkah demi langkah, lihat Pembelajaran Terus Berkelanjutan.

Client-Side Keterampilan

Client-side keterampilan adalah kemampuan tambahan yang memperluas agen selama eksekusi transformasi. Tidak seperti definisi transformasi yang menentukan transformasi apa yang harus dilakukan, keterampilan sisi klien menyediakan alat tambahan, skrip, dan instruksi yang dapat digunakan agen bersama kemampuan bawaannya selama transformasi apa pun.

Client-side keterampilan ditemukan dari direktori tingkat proyek dan tingkat pengguna. Tempatkan keterampilan di tingkat proyek ketika mereka menegakkan standar khusus untuk repositori, dan pada tingkat pengguna ketika mereka berlaku di semua proyek Anda. Project-level keterampilan hanya tersedia ketika jalur repositori kode disediakan. Untuk konfigurasi dan penggunaan terperinci, lihatClient-Side Keterampilan.

Pengantar perintah transformasi khusus

Berikut adalah beberapa perintah yang dapat Anda gunakan dengan transformasi khusus. Daftar lengkap perintah ada di referensi perintah AWS Transform custom transformations.

  • atx custom

    • Menjalankan pengalaman interaktif transformasi kustom, memungkinkan pembuatan, penemuan, eksekusi, dan penyempurnaan transformasi.

    • Ini adalah perintah default untukatx.

    • --trust-all-tools(-t) bersifat opsional dan secara implisit memungkinkan semua permintaan alat yang diminta oleh agen. Gunakan dengan hati-hati terutama di lingkungan produksi. Anda dapat mengonfigurasi kepercayaan alat untuk alat dan perintah tertentu menggunakan file pengaturan kepercayaan.

  • atx custom --help | atx custom -h

    • Menampilkan menu bantuan.

    • Setiap perintah juga menyertakan menu bantuan, misalnya,atx custom def exec --help.

  • atx --version | atx -v

    • Menunjukkan versi.

    • Nomor versi berubah dengan setiap rilis.

  • atx custom def list

    • Mencetak daftar transformasi yang tersedia di registri transformasi.

  • atx custom def exec

    • Mengeksekusi transformasi

  • atx custom def learnings

    • Membuka sesi interaktif untuk melihat dan mengelola pelajaran yang telah dipelajari transformasi dari proses sebelumnya

  • atx mcp

    • Digunakan untuk mengelola konfigurasi server MCP