Migrasi dari Vercel
Panduan ini memandu Anda memigrasikan aplikasi dari Vercel ke Zeabur. Jika Anda mencari satu platform yang menangani layanan frontend sekaligus backend β database, cache, background worker β bersama aplikasi web Anda, Zeabur adalah pilihan yang tepat.
Sebelum Memulai
- Akun Zeabur.
- Kode sumber aplikasi Anda di repositori Git (GitHub).
- Akses ke dashboard Vercel Anda.
Langkah 1: Hubungkan Repositori Git Anda
Proyek Vercel Anda sudah terhubung ke repositori Git. Hubungkan repositori yang sama ke Zeabur:
- Masuk ke dashboard Zeabur.
- Buat proyek baru dan pilih server (atau beli server baru).
- Klik Tambah Layanan β Git dan hubungkan akun GitHub Anda.
- Pilih repositori yang sama dengan yang digunakan proyek Vercel Anda.
Zeabur mendukung secara native semua framework utama, termasuk Next.js, Nuxt, Astro, Remix, SvelteKit, Vite, dan situs statis.
File next.config.js (atau next.config.mjs) Anda dapat digunakan apa adanya di Zeabur. Tidak perlu perubahan apa pun β sistem build Zeabur sepenuhnya kompatibel dengan konfigurasi Next.js, termasuk output: 'standalone'.
Langkah 2: Pindahkan Environment Variables
- Di proyek Vercel Anda, buka Settings β Environment Variables. Salin key dan value setiap variabel.
- Di dashboard Zeabur, klik layanan Anda dan buka tab Variabel.
- Tambahkan variabel Anda. Gunakan Bulk Edit untuk menempelkan banyak pasangan key-value sekaligus.
Vercel membatasi cakupan variabel berdasarkan environment (Production, Preview, Development). Di Zeabur, variabel berlaku untuk semua deployment secara default. Jika Anda membutuhkan nilai yang berbeda untuk preview deployment, Anda dapat membuat beberapa environment untuk mengelolanya.
Langkah 3: Tangani Pengaturan Khusus Framework
Next.js
- Tidak perlu perubahan. Zeabur mendeteksi Next.js secara otomatis dan mem-build-nya dengan benar.
- Fitur
next.config.jsseperti rewrites, redirects, headers, dan optimasi gambar langsung berfungsi. - API routes dan Server Actions berjalan secara native β Zeabur menjalankan aplikasi Next.js Anda sebagai server penuh, bukan sebagai serverless function.
- Jika Anda menggunakan
output: 'standalone'di konfigurasi Next.js, Zeabur menanganinya secara otomatis.
Nuxt / Astro / Remix / SvelteKit
- Framework ini dideteksi secara otomatis dan di-build dengan build command standarnya.
- Tidak diperlukan perubahan konfigurasi khusus framework.
Situs Statis (Vite, Create React App, dll.)
- Zeabur secara otomatis mendeteksi build statis dan menyajikannya dengan web server bawaan.
- Jika proyek Anda memiliki
vercel.jsondengan routing kustom, Anda mungkin perlu mengonfigurasi redirect yang setara di konfigurasi framework Anda.
Langkah 4: Pemetaan Fitur Khusus Vercel
Beberapa fitur Vercel memiliki padanan yang berbeda di Zeabur:
| Fitur Vercel | Padanan di Zeabur |
|---|---|
| Serverless Functions | Berjalan sebagai server persisten (performa cold start lebih baik) |
| Edge Functions | Berjalan sebagai kode sisi server |
| Vercel Postgres / KV / Blob | Layanan database β PostgreSQL, Redis, atau object storage |
Cron Jobs (vercel.json) | Gunakan cron bawaan framework Anda atau layanan worker terpisah |
Rewrites/redirects vercel.json | Gunakan konfigurasi tingkat framework (misalnya rewrites di next.config.js) |
| Preview Deployments | Buat environment terpisah untuk melihat pratinjau perubahan |
| Analytics | Gunakan analitik pihak ketiga (misalnya Plausible, PostHog) |
Di Vercel, setiap API route berjalan sebagai serverless function terisolasi dengan cold start. Di Zeabur, aplikasi Anda berjalan sebagai server persisten β artinya waktu respons lebih cepat dan tanpa latensi cold start.
Langkah 5: Tambahkan Layanan Backend (Jika Diperlukan)
Salah satu alasan utama bermigrasi dari Vercel adalah untuk menyatukan seluruh stack Anda dalam satu platform. Di Zeabur, Anda dapat menambahkan database dan layanan backend bersama frontend Anda:
- PostgreSQL, MySQL, MongoDB: Klik Tambah Layanan β Database dan pilih database Anda.
- Redis: Tersedia sebagai layanan prebuilt untuk caching dan penyimpanan sesi.
- API Backend: Deploy layanan backend terpisah (Node.js, Python, Go, dll.) dalam proyek yang sama. Layanan dalam satu proyek dapat berkomunikasi melalui jaringan privat.
Langkah 6: Atur Domain Kustom
- Di dashboard Zeabur, klik layanan Anda dan buka tab Jaringan.
- Klik Generate Domain untuk mendapatkan subdomain
.zeabur.appgratis, atau klik Domain Kustom untuk menambahkan domain Anda sendiri. - Perbarui record DNS Anda:
- Hapus record CNAME Vercel yang lama (biasanya mengarah ke
cname.vercel-dns.com). - Tambahkan record CNAME yang mengarah ke target yang disediakan Zeabur.
- Hapus record CNAME Vercel yang lama (biasanya mengarah ke
Jika Anda menggunakan nameserver Vercel untuk domain Anda, Anda perlu memindahkan pengelolaan DNS kembali ke registrar Anda atau penyedia DNS lain sebelum memperbarui record.
Langkah 7: Verifikasi dan Go Live
- Push sebuah commit untuk memicu deployment, atau klik Deploy Ulang di dashboard.
- Periksa tab Log untuk memastikan aplikasi Anda berhasil di-build dan berjalan dengan benar.
- Uji semua route, endpoint API, dan server-side rendering.
- Setelah terverifikasi, alihkan DNS production Anda ke Zeabur.
Perbedaan Utama: Vercel vs Zeabur
| Fitur | Vercel | Zeabur |
|---|---|---|
| Fokus | Frontend / Jamstack / Serverless | Full-stack (frontend + backend + database) |
| Model eksekusi | Serverless function (cold start) | Server persisten (tanpa cold start) |
| Database | Vercel Postgres, KV, Blob (terbatas) | Layanan database (PostgreSQL, MySQL, MongoDB, Redis, dll.) |
| Layanan backend | Tidak didukung secara native | Deploy backend apa pun bersama frontend Anda |
| Sistem build | Vercel Build | Deteksi otomatis (Nixpacks / Dockerfile) |
| Harga | Per pemanggilan function + bandwidth | Paket langganan + biaya server |
| Fitur tim | Harga per seat | Paket tim yang fleksibel |
| Infrastruktur | Hanya serverless | Server; shared cluster hanya untuk pengguna lama |
Selesai. Aplikasi Vercel Anda kini berjalan di Zeabur sebagai platform full-stack dengan database, layanan backend, dan frontend Anda β semuanya di satu tempat. Jika Anda mengalami masalah, hubungi Zeabur Support.