Panduan Migrasi n8n v2

Penantian akhirnya berakhir. n8n v2.0 telah resmi mendarat, menghadirkan Autosave yang sangat dinantikan, peningkatan kinerja yang masif, dan alur kerja "Draft vs. Publish" yang mengubah cara kita membangun otomatisasi selamanya.

Jika Anda men-hosting n8n di Zeabur, berikut adalah panduan lengkapnya. Memperbarui instance Anda umumnya mudah, tetapi karena v2 membawa beberapa perubahan arsitektur (terutama bagi pengguna Python), ada tiga jalur berbeda yang bisa diambil tergantung pada bagaimana Anda menggunakan node Code.

Berikut cara memigrasikan proyek Zeabur Anda dengan aman.

---

🚀 Ingin memulai dari awal saja?

Jika Anda lebih suka memulai dengan lembaran baru daripada memigrasikan instance yang ada, kami telah merilis Template Statis n8n v2 yang sudah dikonfigurasi sebelumnya. Template ini sudah dioptimalkan untuk Zeabur secara out of the box.

Deploy Template n8n v2 di Zeabur →

---

Jalur 1: Pengguna "Dasar" (Upgrade Standar)

Untuk siapa ini?

• Anda menggunakan node n8n standar (Webhooks, HTTP Requests, Google Sheets, dll).
• Anda menggunakan JavaScript di node Code Anda.
• Anda tidak menggunakan Python di node Code Anda.

Jika ini terdengar seperti Anda, proses upgrade di Zeabur sangatlah sederhana.

Cara Upgrade:

1. Masuk ke Dashboard Zeabur Anda.
2. Klik pada layanan n8n Anda.
3. Buka tab Settings (Pengaturan).
4. Temukan kolom Image Tag.
5. Ubah tag dari versi Anda saat ini (atau latest) menjadi 2.1.4 (atau versi terbaru yang tersedia).
6. Zeabur akan secara otomatis men-deploy ulang layanan Anda.

Itu saja. Setelah layanan dimulai ulang, Anda akan melihat antarmuka v2 yang baru.

⚠️ Penting: Bahkan untuk pengguna dasar, v2 memiliki breaking changes (perubahan yang memutus kompatibilitas) mengenai bagaimana data mengalir antar sub-workflow. Kami sangat menyarankan membaca Panduan Breaking Changes Resmi sebelum Anda beralih.

---

Jalur 2: Pengguna "Pyodide" (Dukungan Python Legacy)

Untuk siapa ini?

• Anda saat ini menggunakan Python dalam workflow Anda.
• Anda menggunakan implementasi Pyodide (Python ringan sisi browser/server yang tidak memerlukan task runner eksternal penuh).
• Anda ingin mempertahankan arsitektur sederhana Anda saat ini tanpa men-deploy Task Runner yang kompleks.

Masalahnya: n8n v2 mengubah cara Python ditangani. Jika Anda hanya memperbarui image tag, node berbasis Pyodide Anda mungkin gagal karena persyaratan lingkungan telah berubah. Anda perlu menerapkan konfigurasi khusus pada instance Zeabur Anda untuk mempertahankan fungsi ini.

Cara Upgrade:

Kami telah menyiapkan panduan konfigurasi khusus untuk skenario ini. Harap verifikasi pengaturan dan variabel lingkungan (environment variables) Anda dengan panduan di bawah ini untuk memastikan Pyodide tetap berfungsi di Zeabur:

👉 Panduan: Upgrade n8n v2 dengan Pyodide di Zeabur

Ikuti langkah-langkah di tautan di atas untuk menambal (patch) instance Anda saat ini sebelum berharap workflow Python Anda berjalan dengan sukses.

---

Ringkasan Breaking Changes

Baik Anda pengguna dasar maupun tingkat lanjut, perubahan v2 ini memengaruhi semua orang:

1. Data Sub-Workflow: Jika Anda menggunakan node "Execute Workflow", n8n sekarang mengembalikan hasil aktual dari sub-workflow alih-alih meneruskan data input. Periksa output data Anda!
2. Keamanan Node Code: Secara default, node Code tidak dapat lagi mengakses variabel lingkungan (process.env). Anda harus mengaktifkan izin secara eksplisit jika kode Anda bergantung padanya.
3. Save vs. Publish: Anda sekarang memiliki status "Draft". Mengklik "Save" tidak membuat perubahan menjadi aktif (live). Anda harus mengklik "Publish" untuk memperbarui workflow aktif Anda.

Untuk pendalaman setiap perubahan teknis, silakan merujuk ke dokumentasi resmi: 📄 Dokumentasi Breaking Changes n8n v2.0

---

⚡️ Panduan Keputusan Cepat

Tidak yakin jalur mana yang harus diambil? Gunakan tabel ini untuk memutuskan:

Fitur / Penggunaan	Jalur 1: Dasar	Jalur 2: Pyodide	Deployment Baru
Bahasa Kode Utama	Hanya JavaScript	JavaScript + Python Sederhana	Semua
Paket Pip Eksternal	Tidak	Tidak (Hanya Lib Standar)	-
Kebutuhan Kinerja	Standar	Standar	Standar
Tindakan Migrasi	Perbarui Image Tag	Perbarui Tag + Terapkan Config	Gunakan Template
Terbaik Untuk	Kebanyakan Pengguna	Pengguna Python Ringan	Mulai Baru / Bersih

Pemikiran Terakhir

Upgrade ke v2 di Zeabur adalah langkah maju yang besar untuk stabilitas dan pengalaman pengembang. Pilih jalur yang sesuai dengan kompleksitas workflow Anda, dan selamat mengotomatisasi! 🚀