Pemecahan Masalah BYOC

Sebagian besar masalah BYOC berujung pada salah satu dari tiga hal: firewall (biasanya milik penyedia cloud, bukan milik OS), DNS yang belum mengarah ke server Anda, atau server yang tidak bisa menjangkau Raklane ke arah luar. Ikuti bagian yang sesuai dengan yang Anda alami.

Dua perintah di server Anda menjawab sebagian besar pertanyaan:

sudo systemctl status raklane-agent     # apakah agent berjalan?
sudo journalctl -u raklane-agent -f     # apa yang sedang dikerjakan / dikeluhkan?

Untuk detail lebih banyak, atur RAKLANE_LOG_LEVEL=debug dan RAKLANE_LOG_FORMAT=text di /etc/default/raklane-agent lalu restart agent. Lihat Konfigurasi Agent BYOC.

Agent tidak mau menyala setelah pengaturannya diubah

• Periksa salah ketik di file: sudo cat /etc/default/raklane-agent. Setiap baris harus berformat KEY=VALUE, tanpa spasi di sekitar =.
• Apakah Anda memindahkan RAKLANE_AGENT_STATE_DIR? Tanpa file-filenya, agent mencoba mendaftar ulang dan gagal, karena token sudah terpakai. Kembalikan file-filenya, atau arahkan pengaturannya kembali ke direktori lama.
• Pengaturan durasi tidak berpengaruh? Nilai seperti 15s atau 1h yang tidak bisa dibaca diam-diam kembali ke nilai bawaan.
• Apakah Anda menjalankan ulang perintah instalasi? Perintah itu menulis ulang file pengaturan dan menghapus baris kustom Anda. Tambahkan kembali.

Server tertahan di Pending

Server sudah terdaftar tetapi tidak pernah menyelesaikan pendaftaran.

1. Apakah perintah instalasi selesai? Jalankan ulang — aman dijalankan lagi — dan perhatikan error-nya.
2. Apakah token sudah terpakai, atau sudah diganti? Token hanya berlaku sekali, dan membuat token baru membatalkan yang lama. Gunakan Regenerate token dari menu server lalu jalankan perintah barunya.
3. Bisakah server menjangkau Raklane? Dari server, jalankan curl -I ke URL Raklane Anda (yang ada di perintah instalasi). Jika gagal, periksa aturan firewall keluar, resolusi DNS di server, atau proxy perusahaan.
4. Bisakah server menjangkau port koneksi agent? Pendaftaran bisa berhasil tetapi server tidak pernah menjadi Healthy jika port koneksi agent (8443 secara bawaan) diblokir ke arah luar. Log agent akan menampilkan error koneksi dalam kasus ini.

Server menjadi Offline

Agent kehilangan koneksinya ke Raklane.

• Apakah server menyala? Periksa konsol penyedia Anda, lalu coba ssh.
• Apakah agent berjalan? sudo systemctl status raklane-agent. Jika berhenti, sudo systemctl restart raklane-agent.
• Apakah ada yang berubah di jaringan? Aturan firewall baru, DNS resolver yang berganti, atau gangguan di sisi penyedia bisa memblokir koneksi keluar.

Agent terhubung kembali otomatis begitu memungkinkan. Aplikasi Anda biasanya tetap melayani pengunjung selama server tampil Offline — "unreachable" di dashboard berarti Raklane saat ini tidak bisa memastikan kondisinya, bukan berarti aplikasinya berhenti.

Server Healthy, tetapi URL aplikasi tidak terbuka

Hampir selalu karena port 80/443 diblokir di depan server.

1. Buka 80 dan 443 di firewall penyedia cloud Anda (AWS Security Group, aturan firewall GCP, cloud firewall DigitalOcean/Hetzner/Vultr), ke 0.0.0.0/0. Perintah instalasi hanya membukanya di firewall OS.
2. Periksa juga firewall OS, jika Anda memakai selain ufw (iptables, nftables, firewalld).
3. Pastikan tidak ada yang lain memakai 80/443. Web server lain (nginx, Apache, Caddy terpisah) di server yang sama menghalangi Caddy milik Raklane untuk melayani. sudo ss -ltnp | grep -E ':80 |:443 ' menunjukkan apa yang sedang mendengarkan.
4. Pastikan deploy benar-benar active di halaman ringkasan aplikasi, dan Anda memakai URL persis yang tertera di sana.
5. Beri waktu beberapa detik untuk routing setelah deploy menjadi active.

HTTPS tidak berfungsi / error sertifikat

• Apakah domain sudah terverifikasi? Untuk domain kustom, halaman Domains harus menampilkan verified lebih dulu. Tidak ada sertifikat yang diminta sebelum itu.
• Apakah DNS mengarah ke server? dig +short app.example.com harus mengembalikan IP publik server Anda. Jika mengembalikan IP CDN (misalnya Cloudflare dengan proxy aktif), ganti ke DNS-only.
• Apakah port 80 bisa dijangkau dari internet? Certificate authority melakukan verifikasi lewat port 80, meskipun aplikasi disajikan di 443.
• Kirim request HTTPS sungguhan. Sertifikat diterbitkan saat request pertama untuk sebuah hostname; buka URL-nya di browser dan tunggu beberapa detik.
• Apakah IP server privat? Server dengan IP privat/LAN hanya disajikan lewat HTTP biasa — ini memang begitu, karena tidak ada certificate authority yang bisa menjangkaunya.
• Terkena batas permintaan certificate authority? Berulang kali menghapus dan membuat ulang server, atau mengganti banyak hostname dalam waktu singkat, bisa sementara menyentuh batas certificate authority. Tunggu lalu coba lagi nanti.

Domain kustom tetap Pending

• Record A harus mengarah ke IP server Anda, bukan ke Raklane. Halaman Domains menunjukkan ke mana hostname mengarah saat ini.
• Perubahan DNS butuh waktu untuk menyebar. Raklane terus memeriksa otomatis dan tidak pernah menyerah — jika record-nya benar, domain akan terverifikasi.
• CDN yang mem-proxy di depan domain akan mengarahkan ke IP CDN, sehingga verifikasi gagal. Gunakan mode DNS-only.

Deploy gagal menarik image

• server gave HTTP response to HTTPS client — registry instalasi Raklane Anda berjalan lewat HTTP biasa (penyiapan development). Jalankan ulang perintah instalasi dengan tambahan --insecure-registry=HOST:PORT (tanyakan nilainya ke operator Raklane Anda), lalu deploy ulang.
• Error autentikasi atau "not found" — server mungkin tidak bisa melakukan autentikasi ke registry. Hubungi pengelola instalasi Raklane Anda.
• no space left on device — kosongkan disk di server (sudo docker system prune menghapus image yang tidak terpakai dan container yang berhenti), lalu deploy ulang.
• Timeout — pastikan server bisa menjangkau registry lewat HTTPS ke arah luar.

Deploy yang sudah gagal tidak mencoba ulang sendiri setelah Anda memperbaiki penyebabnya — klik Redeploy.

Deploy ditolak karena kapasitas

Request CPU/memori aplikasi tidak muat di sisa kapasitas server. Turunkan request aplikasi (halaman Resources), pindahkan atau hapus aplikasi lain di server itu, atau gunakan server yang lebih besar. Ingat bahwa request tetap dihitung meskipun aplikasi sedang menganggur — itulah yang mencadangkan ruangnya.

Deploy ke server saya dijeda

Biaya pengelolaan BYOC Anda belum dibayar melewati masa tenggang. Semua yang sudah berjalan aman. Isi saldo dompet dari Billing — setelah tunggakan tertagih, deploy kembali berfungsi. Lihat Tagihan BYOC.

Aplikasi tidak bisa terhubung ke database-nya

• Apakah keduanya di server yang sama? Database local hanya bisa dijangkau oleh aplikasi di server BYOC yang sama. Jika berbeda server, pindahkan aplikasinya, atau jadikan database external dan hubungkan lewat alamat eksternalnya.
• Database eksternal tidak terjangkau? Jika alamat eksternalnya adalah IP server Anda sendiri, port database harus terbuka di firewall server dan firewall penyedia cloud. Jika alamat yang ditampilkan adalah IP privat, atur External host server (Clusters → Edit).
• Kata sandi salah? Kata sandi hanya ditampilkan saat pembuatan. Jika hilang, database harus dibuat ulang.

Aplikasi tampil "unreachable"

Raklane saat ini tidak bisa memastikan kondisi aplikasi tersebut, biasanya karena server Offline atau Docker di server tidak merespons. Periksa sudo systemctl status docker dan status agent. Setelah server kembali, Raklane memastikan ulang dan aplikasi kembali active tanpa perlu deploy ulang.

Masih buntu?

Kumpulkan output sudo journalctl -u raklane-agent --since "1 hour ago" dan hasil Check connection, lalu hubungi pengelola instalasi Raklane Anda. Lihat juga halaman Pemecahan Masalah umum.