Deploy, preview, dan rollback.
Cara push ditayangkan, preview branch, kembali ke versi sebelumnya, perintah rilis untuk migrasi, pengaturan build, deploy hook, mode pemeliharaan, dan password preview.
Setelah aplikasi online, Anda jarang memerlukan panel untuk merilis perubahan: push ke branch, dan versi baru tayang dengan sendirinya. Artikel ini membahas semua hal di sekitarnya — tab Deploy, Preview, tab Proses, dan beberapa sakelar di Pengaturan.
Deploy otomatis di setiap push
Setiap push ke branch aplikasi akan mem-build commit terbaru dan men-deploy-nya. Versi baru dijalankan berdampingan dengan versi yang sedang berjalan dan baru menerima pengunjung setelah merespons; jika gagal berjalan, versi sebelumnya tetap berjalan dan kami memberi tahu Anda melalui email (dan Telegram, jika sudah dihubungkan).
Push yang dilakukan saat build lain masih menunggu di antrean akan digabungkan dengan build tersebut, sehingga rentetan push tidak menimbulkan antrean panjang.
Anda bisa menonaktifkannya di Pengaturan → Deploy setiap push. Jika nonaktif, Anda men-deploy dari panel, API, atau deploy hook.
Deploy dari panel
Tab Deploy mencantumkan setiap deploy: pemicunya (push, panel, rollback, deploy hook), commit, durasi, dan statusnya. Klik deploy untuk melihat log build lengkapnya.
Deploy ulang menawarkan dua pilihan:
- Build commit terbaru — mengambil kode terbaru dari branch dan mem-build-nya.
- Deploy ulang versi yang berjalan — menerapkan variabel yang diubah, tanpa build baru. Gunakan setelah mengedit Variabel.
Menu di samping Buka berisi dua tindakan yang sama ditambah Restart.
Rollback
Anda bisa kembali ke salah satu dari 5 versi sukses terakhir. Di tab Deploy, klik Rollback pada versi yang diinginkan dan konfirmasi. Versi sebelumnya dijalankan berdampingan dengan versi saat ini dan mengambil alih setelah merespons — tanpa build baru.
Rollback tidak membatalkan perubahan database. Jika sebuah rilis mengubah struktur database, pulihkan juga database-nya — lihat Database.
Preview untuk branch
Push ke branch lain mana pun mendapat preview sendiri — alamat terpisah tempat Anda bisa memeriksa perubahan sebelum tayang. Buka di tab Preview.
- Maksimal 3 preview sekaligus, sudah termasuk dalam harga Anda.
- Preview yang tidak menerima push baru selama 7 hari akan dihapus. Preview dibuat lagi pada push berikutnya ke branch tersebut.
- Preview hanya mendapat variabel yang ditujukan untuknya — lihat Variabel environment.
- Preview dibuat untuk layanan utama proyek, bukan untuk layanan lainnya.
Password untuk preview
Di tab Preview, Password untuk preview → Minta password. Masukkan nama user dan password (minimal 8 karakter). Sejak saat itu, hanya orang yang memiliki password yang bisa membuka preview; aplikasinya sendiri tetap terbuka untuk semua orang.
Perintah rilis (migrasi)
Tab Proses → Perintah rilis. Perintah ini dijalankan sekali di setiap deploy, sebelum versi baru menerima pengunjung — biasanya migrasi database. Jika gagal, deploy berhenti dan versi saat ini tetap berjalan, sehingga migrasi yang rusak tidak pernah sampai ke pengunjung Anda.
Kami menyarankan perintah untuk framework yang memilikinya:
| Framework | Perintah rilis yang disarankan |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Gunakan perintah yang disarankan mempertahankannya; Anda juga bisa memasukkan perintah sendiri atau memilih Tidak ada. Perubahan berlaku mulai deploy berikutnya.
Pengaturan build
Pengaturan → Pengaturan build memungkinkan Anda mengubah hasil deteksi kami:
- Perintah instal — misalnya
npm ci - Perintah build — misalnya
npm run build - Perintah start — perintah yang menjalankan aplikasi Anda. Aplikasi harus mendengarkan port di
$PORT. - Folder output — untuk website statis, folder berisi file hasil build.
- Folder proyek — untuk repository dengan beberapa proyek.
Kosongkan kolom untuk memakai hasil deteksi kami. Deploy berikutnya di-build dengan pengaturan baru; Build sekarang langsung memulainya.
Pengaturan juga berisi Branch yang di-deploy.
Deploy hook
Pengaturan → Deploy hook → Buat hook. Deploy hook adalah alamat privat: saat layanan lain mengirim request POST ke alamat ini, commit terbaru dari branch Anda di-build dan di-deploy. Contoh penggunaan umumnya adalah CMS yang mem-build ulang website setelah Anda memublikasikan konten.
curl -X POST "<alamat hook dari panel>"- Alamat hanya ditampilkan sekali — salin saat Anda membuat hook. Siapa pun yang memilikinya bisa memulai deploy, jadi rahasiakan.
- Maksimal 10 deploy per jam per hook. Panggilan yang masuk saat build masih menunggu akan digabungkan dengan build tersebut.
- Cabut langsung menonaktifkan alamat; layanan yang memanggilnya kemudian memerlukan alamat baru.
Mode pemeliharaan
Pengaturan → Mode pemeliharaan → Tampilkan halaman pemeliharaan. Pengunjung melihat halaman singkat berisi pesan Anda sebagai pengganti aplikasi; kosongkan pesan untuk menampilkan «Kami sedang melakukan beberapa perbaikan. Silakan kembali sebentar lagi.»
Aplikasinya sendiri tetap berjalan, sehingga Anda bisa memeriksa semuanya sebelum membukanya kembali. Tautan privat untuk Anda menampilkan aplikasi seperti biasa di perangkat yang membukanya, selama 12 jam. Tautan baru membuat tautan baru; tautan lama berhenti berfungsi.
Matikan sakelar untuk membuka aplikasi kembali bagi pengunjung.
Notifikasi tentang deploy
Kami mengirim email kepada Anda (dan pesan Telegram, jika sudah dihubungkan) saat deploy tidak selesai. Untuk mengirim event ke tim Anda juga — versi baru tayang, deploy tidak selesai, layanan berhenti atau kembali berjalan, pemakaian memori atau prosesor tinggi, backup atau disk database — tambahkan Slack, Discord, atau webhook Anda sendiri di Pengaturan → Notifikasi untuk tim Anda. Pesan webhook berupa JSON yang ditandatangani dengan secret yang ditampilkan sekali, di header X-Rivervo-Signature.