Dokumentasi

DeployAja Extension

Extension VSCode untuk men-deploy project Anda langsung dari editor ke production — tanpa setup server manual atau konfigurasi yang rumit.

Stack yang Didukung

Pastikan project Anda menggunakan salah satu stack berikut sebelum memulai deployment. Stack di luar daftar ini belum dapat di-deploy menggunakan extension DeployAja.

HTML

PHP Laravel

Next.js

Express.js

SvelteKit

Stack selain yang tertera di atas belum didukung oleh extension DeployAja saat ini.

Instalasi Extension

Install extension DeployAja melalui VSCode Marketplace atau marketplace editor lain yang Anda gunakan. Cukup cari DeployAja dan klik Install.

Setelah terinstall, icon DeployAja akan muncul di sidebar kiri editor. Klik icon tersebut untuk membuka panel extension.

Pastikan tidak ada error di project Anda sebelum memulai proses deployment.

Login & Autentikasi

Di panel extension, klik tombol Login untuk menghubungkan editor Anda dengan akun DeployAja. Dropdown akan menampilkan dua pilihan:

Browser akan membuka halaman login deployaja.id secara otomatis. Lebih mudah karena tidak perlu menyalin token secara manual.

Masukkan token akun DeployAja secara manual ke dalam field yang tersedia di panel extension.

Proses autentikasi browser

Setelah memilih Login via Browser, Anda akan diarahkan ke halaman login deployaja.id. Jika belum punya akun, daftar terlebih dahulu kemudian lakukan sign in.

Saat muncul notifikasi untuk kembali ke VSCode, klik Batal dulu. Selesaikan proses sign in terlebih dahulu, baru klik Back to VSCode.

Setelah berhasil sign in dan klik Back to VSCode, panel extension akan otomatis refresh. Jika tidak, klik ulang icon DeployAja di sidebar kiri.

Cara Deploy

Setelah login berhasil, tombol di panel extension berubah dari Login menjadi Deploy This Project. Pastikan aplikasi berjalan dengan sempurna secara lokal, kemudian klik tombol tersebut.

Sebuah dropdown akan muncul untuk memilih stack yang digunakan project Anda saat ini. Pilih stack yang sesuai dari daftar yang tersedia.

Setelah memilih stack, deployment berjalan otomatis oleh sistem DeployAja. Anda bisa melanjutkan aktivitas lain sambil menunggu proses selesai.

Konfigurasi Database

Jika project membutuhkan database, pilih opsi nama_stack with db dari dropdown stack. Saat ini tersedia dua pilihan database:

MySQL

Relational database populer

PostgreSQL

Advanced open-source RDBMS

Resource database dikonfigurasi secara default oleh sistem. Untuk menyesuaikan kapasitas, edit file berikut di dalam project Anda:

.deployaja/deployaja.yaml

database:
  type: mysql        # mysql / postgresql
  size: small       # small / medium / large
  storage: 5Gi     # sesuaikan kebutuhan

Perubahan resource pada deployaja.yaml disarankan dilakukan sebelum deployment kedua, bukan saat pertama kali deploy.

Monitoring & Debug

Pantau status deployment melalui panel VSCode atau langsung di dashboard deployaja.id.

Status deployment

Running

Deployment berhasil. Buka link URL yang tertera di kolom URL pada dashboard untuk mengakses project Anda yang sudah live.

Failed

Deployment gagal. Klik tombol Debug di sebelah kanan nama project pada dashboard untuk melihat log error dan melakukan investigasi.

Jika URL project menampilkan error saat pertama dibuka, tunggu beberapa menit. Sistem DeployAja masih menyelesaikan proses deployment secara menyeluruh di background.