Pemecahan Masalah

Daftar periksa praktis dan berurutan untuk jenis kegagalan yang paling mungkin Anda temui. Mulailah dari Log & Status jika belum — sebagian besar masalah berawal dari sana.

Deploy saya gagal

1. Periksa alasan kegagalan di halaman Status App — di sana terlihat apakah yang gagal adalah build atau container yang berjalan gagal health check. Keduanya butuh perbaikan berbeda.
2. Build gagal — periksa Logs App, dan pastikan repositori Anda punya sesuatu yang bisa dideteksi Cloud Native Buildpacks di root-nya (package.json, requirements.txt, go.mod, dan sebagainya). Repo tanpa file project yang dikenali di root akan gagal di-build.
3. Health check gagal — container menyala tetapi tidak pernah sehat tepat waktu. Penyebab umum: aplikasi tidak benar-benar mendengarkan di port yang dideteksi atau diberikan ke Raklane (periksa ulang container_port), aplikasi crash saat startup (cari stack trace di Logs), atau aplikasi butuh waktu lebih lama untuk siap daripada batas waktu health check.
4. Apa pun yang berjalan sebelum deploy gagal tetap utuh sepenuhnya — deploy yang gagal tidak pernah membuat aplikasi Anda offline.

Aplikasi sudah ter-deploy tetapi tidak bisa diakses

• Tunggu beberapa detik — pembaruan routing berjalan dalam interval singkat, jadi deploy atau domain yang benar-benar baru bisa butuh waktu sebentar untuk bisa diakses setelah tampil active.
• Pastikan Anda memakai URL dari halaman Status App, bukan tebakan — format subdomain bawaan tergantung konfigurasi instalasi Raklane Anda.
• Jika memakai domain kustom, pastikan domain sudah tampil verified di halaman Domains — lihat Domain Kustom.

Repo privat saya tidak bisa di-build

Penyebab paling umum adalah access token yang tidak ada atau kedaluwarsa. Pastikan source App merujuk secret yang valid dengan akses baca ke repositori — lihat Secret → Repositori privat. Token yang sudah dicabut atau kedaluwarsa gagal dengan cara yang sama seperti token yang tidak ada.

Push ke GitHub tidak memicu deploy

• Pastikan secret webhook yang dikonfigurasi di source App sama persis dengan yang Anda masukkan di pengaturan webhook GitHub — ketidakcocokan ditolak tanpa pesan, dan inilah penyebab paling umum.
• Pastikan Anda melakukan push ke branch yang memang dikonfigurasi untuk di-build oleh source App — push ke branch lain diabaikan.
• Periksa tab Recent Deliveries webhook di pengaturan repositori GitHub untuk melihat apakah GitHub sempat mencoba mengirim, dan respons apa yang diterimanya.
• Pastikan mode deploy App adalah Auto Deploy — dalam mode manual, push tidak pernah men-deploy dengan sendirinya.
• Lihat Auto-Deploy & Mode Deploy untuk penyiapan lengkapnya.

Perubahan environment variable tidak berlaku

Environment variable diambil ke dalam container saat container menyala — tidak dimuat ulang secara live. Picu deploy ulang setelah mengubahnya; lihat Environment Variable.

Domain kustom tidak terverifikasi

• Pastikan record DNS benar-benar mengarah ke alamat yang diharapkan instalasi Raklane Anda — halaman Domains menampilkan ke mana domain mengarah saat ini ketika verifikasi gagal, cara tercepat untuk membedakan kesalahan DNS dari keterlambatan propagasi.
• Perubahan DNS butuh waktu untuk menyebar secara global; jika record baru saja dibuat, tunggu dan periksa lagi sebelum menganggapnya salah.
• Untuk aplikasi Bring Your Own Compute, domain harus mengarah ke IP server tersebut, bukan ke infrastruktur bersama Raklane.

HTTPS tidak berfungsi di domain kustom

Penerbitan sertifikat baru dimulai setelah domain selesai verifikasi DNS, dan hanya saat request sungguhan pertama untuknya tiba. Jika sudah terverifikasi tetapi HTTPS masih tidak berfungsi, kirim request sungguhan ke hostname lewat HTTPS untuk memicu penerbitan, dan pastikan port 443 (serta 80, yang dipakai saat penerbitan) bisa dijangkau.

Saya tidak bisa menjeda atau menghapus sesuatu

• Menghapus aplikasi mengharuskannya dijeda terlebih dahulu — jeda, lalu hapus.
• Menghapus project mengharuskan setiap aplikasi di dalamnya dihapus terlebih dahulu.

Ini adalah pengaman, bukan bug — lihat Mengelola Aplikasi.

Saya tidak bisa mengundang rekan tim

Paling sering, seat Organization Anda sudah habis — undangan yang tertunda dihitung sama seperti anggota aktif. Periksa halaman Members milik Organization, dan lihat Tim & Organisasi → Seat. Mengundang juga membutuhkan setidaknya peran Admin.

Deploy tertahan di "waiting for server"

Raklane sedang menyalakan server yang punya ruang untuk aplikasi Anda; biasanya butuh beberapa menit dan berlanjut sendiri. Jika akhirnya gagal dengan pesan tentang jumlah maksimum server atau replica yang terlalu besar, turunkan request CPU/memori aplikasi (halaman Resources) lalu deploy ulang, atau hubungi pengelola instalasi Raklane Anda.

Masalah dengan server sendiri (BYOC)

Lihat Pemecahan Masalah BYOC — membahas server yang tertahan di Pending atau Offline, aplikasi yang tidak terbuka, masalah HTTPS dan domain, gagal menarik image, dan deploy yang dijeda. Penyebab paling umum sejauh ini adalah port 80/443 diblokir oleh firewall penyedia cloud, meskipun firewall OS terlihat baik-baik saja.

Database tertahan di "provisioning" atau gagal

Gangguan sementara sekali-sekali (misalnya engine butuh waktu sejenak setelah menyala sebelum menerima koneksi) adalah hal normal dan dicoba ulang otomatis — bukan jalan buntu. Jika tetap tertahan atau menampilkan failed disertai alasan selama lebih dari satu atau dua menit, periksa alasan itu di halaman Databases terlebih dahulu; untuk database dedicated hosting, pastikan juga dompet Anda punya saldo cukup, karena langganan yang berakhir akan menangguhkan database (datanya tetap tersimpan, dan menyalakannya lagi setelah perpanjangan akan memulihkannya).

Masih buntu?

Lihat FAQ, atau hubungi pengelola instalasi Raklane Anda.