Database terkelola
PostgreSQL atau MariaDB yang tetap berjalan walau satu server atau satu lokasi mati. Berjalan di server milik Anda, di penyedia mana pun, dan Anda cukup mengurus database-nya.
Konsep: 2 server data + 1 saksi
Satu klaster database terdiri dari tiga server milik Anda yang sudah tersambung ke Saka:
| Peran | Isi | Tugas |
|---|---|---|
| Server data 1 | Database lengkap | Utama atau replika. |
| Server data 2 | Database lengkap | Replika atau utama. |
| Saksi | Tanpa data | Ikut memilih utama, sehingga saat server putus tidak pernah ada dua utama (data tidak terbelah). Boleh server kecil. |
Pilih tiga server berbeda, sebaiknya di tiga lokasi berbeda (misalnya Singapura, Jakarta, dan satu lagi). Satu server boleh menjadi saksi bagi banyak klaster (mis. satu VM saksi kecil untuk puluhan pelanggan; tiap klaster mendapat jaringan dan port sendiri), tetapi server data hanya untuk satu klaster. Antar server tersambung lewat jaringan privat WireGuard terenkripsi yang dibuat agent. Kunci privat WireGuard dibuat di tiap server dan tidak pernah meninggalkannya.
Latensi aplikasi ke database penting. Letakkan aplikasi dekat salah satu lokasi data. Pada uji, sambungan TLS dari Sydney ke Bangalore butuh ±3,8 detik, jadi alamat sambungan Saka memakai connect_timeout=5.
PostgreSQL 18/17 atau MariaDB 12.3/10.11
| PostgreSQL 18/17 | MariaDB 12.3/10.11 | |
|---|---|---|
| Teknologi | Patroni + etcd | Galera + garbd (saksi) |
| Cocok untuk | Aplikasi baru | WordPress, Laravel, aplikasi PHP (kompatibel MySQL) |
| Penulis | Satu utama, satu replika | Node data pertama yang sehat menjadi penulis, node lain cadangan penulis |
| Mode replikasi | Asinkron atau sinkron (pilihan) | Selalu sinkron |
| Port | 5432 | 3306 |
| Pengguna awal | postgres | root |
| TLS | Wajib (hostssl, SCRAM) | Wajib (require_secure_transport) |
PostgreSQL 18 menjadi bawaan untuk klaster baru; pilih 17 bila aplikasi Anda belum mendukung 18. Versi tidak bisa diganti setelah klaster dibuat, dan klaster lama tetap di versi 17. Pada uji dengan server utama dimatikan paksa, PostgreSQL 18 pindah ke server lain dalam 29 detik tanpa kehilangan data (mode sinkron).
MariaDB 12.3 menjadi bawaan; pilih 10.11 (LTS sampai 2028) untuk aplikasi lama dengan pustaka klien MySQL lama, mis. Ruby 2.5 atau PHP 7 di image Debian 10. Pustaka itu (libmariadb 3.1) membaca setiap teks sebagai angka 0 dari MariaDB 11.4 ke atas; pada uji, 10.11 benar.
Klaster PostgreSQL biasanya siap dalam ±30 detik sampai 5 menit; MariaDB dibangun berurutan (±1,5 menit pada uji). Anda dikabari lewat Telegram saat siap atau gagal.
Mode replikasi (PostgreSQL)
- Cepat (asinkron): tulis secepat satu server. Bila utama mati mendadak, beberapa detik transaksi terakhir bisa hilang.
- Tanpa kehilangan data (sinkron): setiap tulisan menunggu lokasi kedua. Lebih lambat sekitar satu kali jeda jaringan antar lokasi (±38 ms antara Singapura dan Bangalore pada uji). Cocok untuk transaksi uang.
MariaDB Galera selalu sinkron: setiap tulisan disetujui kedua lokasi data sebelum selesai.
Membuat klaster
- Tambahkan minimal tiga server ke Saka (lihat Mulai). Semuanya harus tersambung.
- Buka Database, tekan + Buat klaster database.
- Pilih mesin, dua server data, satu server saksi, mode replikasi, dan nama (huruf kecil, angka, tanda minus, 3-31 karakter, diawali huruf).
- Pantau langkah pembuatan di halaman detail.
Alamat sambungan & sandi
Halaman detail klaster menampilkan alamat sambungan. Sandi tidak ditampilkan otomatis: tekan Tampilkan sandi. Sandi dibaca langsung dari server data Anda saat itu juga; Saka tidak menyimpannya. Sandi dibuat saat klaster dibuat, diteruskan sekali ke server data, lalu dilupakan Saka.
PostgreSQL: alamat banyak-host
Alamat berisi kedua lokasi data. Driver yang mendukung banyak host (libpq, JDBC, Go pgx) otomatis menyambung ke utama:
DATABASE_URL=postgresql://postgres:[email protected]:5432,198.51.100.20:5432/postgres?sslmode=require&target_session_attrs=read-write&connect_timeout=5MariaDB: alamat langsung
DATABASE_URL=mysql://root:[email protected]:3306/?ssl=trueAlamat langsung ini hanya menuju satu node. Agar aplikasi ikut pindah saat server mati, pakai proxy Saka (di bawah).
Proxy di server aplikasi
Driver PHP (mysqlnd) dan Node.js (mysql2, node-postgres) tidak bisa pindah sendiri ke alamat lain. Pada uji, klien PHP terus mencoba alamat pertama sampai timeout, dan klien Node menggantung tanpa galat. Karena itu Saka menyediakan Sambungkan server aplikasi:
- Saka memasang HAProxy kecil di server tempat aplikasi Anda berjalan (server yang terdaftar di Saka). Boleh juga server anggota klaster, yaitu web dan database di VM yang sama: proxy di sana memeriksa kesehatan setiap node (PostgreSQL: Patroni; MariaDB: node Primary dan Synced) dan selalu menuju penulis yang sama, bukan node lokal yang tertinggal. Lihat Tahan satu VM mati.
- Proxy mendengarkan di
127.0.0.1dan meneruskan ke node data yang sehat. Node lain menjadi cadangan. - Saat primary berpindah, koneksi baru ditahan sampai node baru siap (sampai kira-kira 30 detik), bukan ditolak. Pada uji pindah primary sungguhan (server utama PostgreSQL dimatikan), satu koneksi baru tertahan 28 detik lalu berhasil di primary baru dan hanya 2 dari 233 percobaan gagal, yaitu dalam kira-kira 0,3 detik saat PostgreSQL lama berhenti dan belum terdeteksi; sebelumnya 53 dari 570 percobaan gagal. Koneksi yang sedang terbuka tetap terputus saat failover, jadi aplikasi tetap perlu mencoba ulang transaksi yang sedang berjalan.
- Aplikasi cukup menyambung ke
127.0.0.1. Port sama dengan port database (5432 atau 3306), atau ditambah 10000 (15432 atau 13306) bila port itu sudah dipakai database lokal.
DATABASE_URL=postgresql://postgres:[email protected]:5432/postgres?sslmode=requireDATABASE_URL=mysql://root:[email protected]:3306/?ssl=trueContoh yang dipakai saat uji (sertifikat MariaDB dibuat otomatis, jadi verifikasi sertifikat dimatikan; koneksinya tetap terenkripsi):
$m = mysqli_init();
$m->real_connect('127.0.0.1', 'root', $sandi, 'nama_db', 3306, null,
MYSQLI_CLIENT_SSL | MYSQLI_CLIENT_SSL_DONT_VERIFY_SERVER_CERT);mysql.createConnection({ host: '127.0.0.1', user: 'root', password: sandi,
database: 'nama_db', ssl: { rejectUnauthorized: false } })DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nama_database_anda
DB_USERNAME=root
DB_PASSWORD=SANDITLS wajib di kedua mesin: server menolak koneksi tanpa TLS. Proxy meneruskan koneksi apa adanya, jadi aktifkan TLS di driver Anda (misalnya sslmode=require untuk PostgreSQL). Sertifikat database dibuat di server Anda sendiri, bukan dari CA publik.
Proxy dapat dilepas dari satu server aplikasi kapan saja; aplikasi di server itu lalu perlu alamat sambungan lain.
Pengguna database (MariaDB)
Satu database sering dipakai dua pihak dengan kebutuhan berbeda: aplikasi yang harus menulis, dan tim analitik yang hanya perlu membaca. Daripada membagikan akun root, buat akun terpisah di kartu Pengguna database pada halaman detail klaster MariaDB.
- Buat database (klaster baru memang kosong): isi nama (huruf, angka, garis bawah, maksimal 64 karakter) lalu tekan Buat database. Database kosong ini langsung muncul di semua node, dan bisa juga diisi lewat impor atau situs.
- Buat pengguna: isi nama (huruf kecil, angka, garis bawah; 3 sampai 32 karakter), pilih database, lalu pilih hak:
- Baca saja: hanya
SELECTdan melihat view. Aman untuk analitik dan laporan; tidak bisa mengubah, menghapus, atau melihat daftar akun. - Tulis penuh: semua hak di database itu saja (baca, tulis, ubah struktur tabel). Untuk aplikasi. Database lain dan akun lain tetap tertutup.
- Baca saja: hanya
- Simpan sandinya: sandi dibuat Saka dan tampil sekali saja. Saka tidak menyimpannya. Bila hilang, tekan Sandi baru; sandi lama langsung tidak berlaku.
Pengguna bisa dijadikan baca saja atau tulis penuh kapan saja (berlaku untuk koneksi berikutnya), diberi sandi baru, atau dihapus. Menghapus pengguna tidak menyentuh database dan datanya. Karena klaster Galera, akun yang dibuat langsung sah di kedua node data. SSL wajib untuk semua akun; sambung dengan alamat dan port di kartu Sambungan, mis. mariadb -h ALAMAT -P PORT -u analis -p --ssl.
Kartu ini hanya mengelola akun yang dibuat lewat Saka. Akun root, akun situs, dan akun yang Anda buat sendiri lewat root tidak terlihat dan tidak disentuh. Untuk PostgreSQL, buat peran lewat psql memakai sandi superuser.
Pindahkan database lama ke klaster
Punya PostgreSQL, MySQL 8, atau MariaDB lama, mis. terpasang satu VM dengan aplikasinya? PostgreSQL dipindah ke klaster PostgreSQL, MySQL/MariaDB ke klaster MariaDB. Di halaman klaster, kartu Pindahkan database lama ke klaster:
- Hentikan aplikasi lama agar tidak ada transaksi baru selama penyalinan.
- Pilih server tempat database lama berada (harus tersambung ke Saka), tempel alamatnya seperti dilihat dari server itu, mis.
postgresql://pengguna:[email protected]:5432/nama_db, dan bila perlu nama database tujuan (bawaan: sama). - Tekan Salin ke klaster. Saka memasang proxy di server itu, lalu menjalankan
pg_dumpke klaster dalam satu transaksi dan membandingkan jumlah baris setiap tabel di kedua sisi.
- Gagal di tengah jalan = klaster tidak berubah. Database lama hanya dibaca, tidak pernah diubah.
- Database tujuan yang sudah berisi tabel tidak ditimpa, kecuali Anda mencentang Timpa (isi lamanya di klaster dihapus dulu).
- Galat menyebut penyebab yang bisa diperbaiki: sandi ditolak, database lama tidak menjawab,
pg_hba.confmenolak 127.0.0.1, versi lama lebih baru dari klaster, atau ekstensi yang tidak tersedia. - Sandi database lama hanya diteruskan ke server itu dan tidak disimpan. Batas waktu 2 jam; pada uji, 200.500 baris selesai dalam 3 detik.
- MySQL 8 ke MariaDB: alamat
mysql://pengguna:[email protected]:3306/nama_db. Collationutf8mb4_0900_*diubah ke padanan MariaDB, MyISAM menjadi InnoDB, DEFINER dibuang, dan tabel tanpa primary key dilaporkan. DDL MySQL tidak bisa dibatalkan, jadi bila gagal database tujuan yang sempat dibuat dihapus lagi. - API:
POST /api/v1/database/<id>/impor {"server_id", "sumber", "database", "timpa"}; MCP:database_pindahkan_lama.
Pemilik saat impor dan pulihkan node. Impor PostgreSQL menerima pemilik (nama akun aplikasi yang sudah dibuat di klaster): database beserta semua skema, tabel, urutan, view, fungsi, dan tipe di dalamnya dimiliki akun itu, bukan superuser. Objek milik ekstensi tidak diubah. Bila kontainer klaster berhenti di satu node (mis. docker stop manual), nyalakan dengan POST /api/v1/database/<id>/node/<server>/pulihkan atau alat MCP database_pulihkan_node: etcd, database, lalu proxy, tanpa mengubah data.
Pindah terpandu (aplikasi di server, dengan rollback)
Untuk aplikasi yang berjalan sebagai layanan systemd dan membaca alamat database dari berkas env, pilih sumber Dari berkas env, isi /path/berkas.env dan nama variabel, lalu buka Pindah terpandu dan isi nama layanan (dan alamat pemeriksaan sehat bila ada). Saka lalu:
- menghentikan layanan (aplikasi mati selama penyalinan; Anda diminta mengonfirmasi),
- menyalin database dalam satu transaksi dan membandingkan jumlah baris,
- menulis ulang variabel di berkas env ke alamat klaster (berkas lama disimpan di sebelahnya),
- menyalakan layanan dan memeriksa aplikasinya sehat.
Gagal di langkah mana pun sesudah layanan dihentikan = berkas env dikembalikan dan layanan dinyalakan lagi, jadi aplikasi kembali ke database lama yang selama ini hanya dibaca. Sandi tidak pernah lewat panel atau chat. MCP: database_pindahkan_lama dengan layanan.
Cadangan & pulih ke titik waktu
Klaster yang tahan server mati tetap butuh cadangan: data yang terhapus atau rusak karena kesalahan ikut tersalin ke semua lokasi. Di halaman klaster, kartu Cadangan & pulih ke titik waktu:
- Buat bucket kosong di penyedia S3 milik Anda (Amazon S3, Cloudflare R2, DigitalOcean Spaces, Wasabi, atau yang kompatibel).
- Tekan Nyalakan cadangan ke S3, isi endpoint (nama host saja), bucket, access key, secret key, dan lama simpan (bawaan 14 hari).
- Simpan kode pemulihan yang tampil sekali. Cadangan di S3 dienkripsi dengan kode itu; bila semua server klaster hilang, kode itu satu-satunya cara membukanya.
- Cara kerja: pgBackRest di server data mengirim setiap perubahan (WAL) ke S3 terus-menerus, ditambah cadangan penuh mingguan dan diferensial harian pukul 01.00-04.00 WIB dari node utama. Saka tidak menyimpan kunci S3 maupun kode pemulihan.
- Pulihkan: tekan Pulihkan ke titik waktu, pilih waktu sampai ke detik (atau keadaan terbaru). Hasilnya salinan terpisah di salah satu server data (127.0.0.1, sandi klaster). Klaster yang berjalan tidak disentuh, jadi Anda bisa memeriksa isinya dulu, mengambil tabel yang dibutuhkan, lalu menghapus salinan.
- Ambil data dari salinan: tekan Ambil data pada salinan. Panel menunjukkan setiap tabel dengan jumlah baris di salinan dan di database sekarang, dan menandai yang berbeda. Pilih tabelnya, lalu pilih caranya:
- Salin ke tempat terpisah (bawaan, aman): tabel disalin ke
pulih_<waktu>(PostgreSQL: skema di database yang sama; MariaDB: database baru), tanpa foreign key. Data sekarang tidak disentuh; pindahkan baris yang perlu dengan SQL, mis.INSERT INTO public.pesanan SELECT * FROM pulih_20261004_1030.pesanan WHERE id NOT IN (SELECT id FROM public.pesanan), atau minta agent AI Anda. - Timpa isi tabel sekarang: isi tabel diganti dengan keadaan salinan. Isi lama disimpan dulu ke
sebelum_<waktu>; perubahan sejak titik pulih di tabel itu hilang. PostgreSQL mengerjakannya dalam satu transaksi.
- Salin ke tempat terpisah (bawaan, aman): tabel disalin ke
- Pada uji (3 Okt 2026): 150 transaksi dihapus sengaja dari klaster, lalu salinan pada detik sebelum penghapusan berisi 150 baris itu utuh. Pemulihan berdasarkan waktu server, jadi pakai jam server (bukan jam perangkat yang belum tersinkron) saat mencocokkan.
- MariaDB: cadangan penuh harian (mariadb-backup) ditambah binlog yang dikirim ke S3 tiap menit, jadi titik pulih paling lama tertinggal sekitar 1-2 menit (PostgreSQL langsung). Satu node data menjadi pencadang; bila node itu mati, node lain mengambil alih dan langsung membuat cadangan penuhnya sendiri (pada uji: 30 detik setelah node pencadang dimatikan paksa). Saat cadangan dinyalakan, node dijalankan ulang satu per satu dengan binlog aktif, dan node lain tetap melayani.
- Pada uji MariaDB 10.11 (3 Okt 2026): cadangan dibuat di Singapura, dipulihkan di Bangalore; salinan sebelum penghapusan berisi 150 baris utuh, salinan pada titik sebelumnya 100 baris.
- Klaster PostgreSQL lama dijalankan ulang sekali saat cadangan pertama kali dinyalakan (replika dulu, utama bisa pindah beberapa detik).
- API:
POST /api/v1/database/<id>/cadangan,GET .../cadangan,POST .../cadangan/sekarang,POST .../pulihkan {"waktu", "nama"},GET .../salinan/<nama>/tabel,POST .../salinan/<nama>/ambil {"database", "tabel", "timpa"},DELETE .../salinan/<nama>. MCP:database_cadangan_status,database_pulihkan,database_salinan_tabel,database_salinan_ambil,database_salinan_hapus.
Uji pulih otomatis & alarm
Cadangan yang tidak pernah dipulihkan hanyalah harapan. Tiap pekan (dini hari WIB, di replika bila ada) Saka memulihkan cadangan terbaru dari S3 ke salinan sementara, menghitung tabel di semua database dan membandingkannya dengan database hidup, melapor ke Telegram, lalu menghapus salinan. Database hidup hanya dibaca. Tombol Uji pulih sekarang di tab Cadangan menjalankannya kapan saja.
- Alarm Telegram bila cadangan penuh pertama tidak muncul (lebih dari 2 jam), cadangan terakhir lebih dari 36 jam, atau pengarsipan WAL ke S3 sedang gagal. Dikabari sekali sehari sampai beres, dan sekali lagi saat pulih.
- Tombol Perbaiki memindahkan cadangan yang setengah jadi ke repositori baru; Tampilkan kode pemulihan menampilkan frasa sandi enkripsi saat diminta.
- Agent menolak memulai bila disk atau RAM server tidak cukup. MCP:
database_cadangan_status; API:POST /api/v1/database/<id>/cadangan/verifikasi.
Pagar
Agent di setiap server data memeriksa kesehatan database tiap 2 detik. Bila node tidak layak menerima tulisan, port database ditutup dari luar dengan TCP RST, sehingga klien atau proxy langsung pindah ke node lain:
- PostgreSQL: hanya pemimpin Patroni yang terbuka, replika tertutup.
- MariaDB: terbuka hanya bila node Primary dan Synced. Node yang sedang bergabung kembali tertutup sampai tersinkron.
Lalu lintas dari jaringan privat klaster dan dari server itu sendiri tidak ikut ditutup.
Failover & pulih sendiri
Bila server utama mati, replika di lokasi lain otomatis mengambil alih. Anda dikabari lewat Telegram saat utama pindah, saat tidak ada replika yang tersalin (klaster sementara tidak tahan satu server mati), dan saat replika tersalin lagi.
| Uji (28 Sep 2026) | Jeda sampai aplikasi menulis lagi | Baris hilang |
|---|---|---|
| MariaDB, node penulis dimatikan mendadak, klien PHP dan Node lewat proxy | ±11 detik | 0 |
| PostgreSQL uji produk, node penulis dimatikan mendadak, klien lewat proxy | 33 detik | 0 |
| PostgreSQL uji konsep, mode asinkron | 38,6 detik | 0 |
| PostgreSQL uji konsep, mode sinkron | 32,0 detik | 0 |
- PostgreSQL: server yang mati kembali sendiri sebagai replika saat dinyalakan (pg_rewind), tanpa campur tangan.
- MariaDB: server yang mati menyalin data dari node lain saat hidup lagi, lalu kembali menjadi penulis.
Pemilihan utama terjadi di antara server Anda sendiri (etcd atau garbd di ketiga server). Saka Panel tidak ikut di jalur itu, jadi failover tetap berjalan walau Saka Panel mati.
Tambah, lepas, dan jadikan utama
Klaster PostgreSQL yang sedang berjalan bisa diubah tanpa menghentikan aplikasi:
- Tambah server data: Saka memasang PostgreSQL di server itu, menyambungkannya ke jaringan WireGuard privat klaster, dan menyalin data dari utama. Bila cadangan S3 sudah menyala, konfigurasi cadangannya ikut disalin supaya cadangan tetap jalan bila node baru kelak menjadi utama. MCP:
database_tambah_node. - Lepas replika: replika yang ditambah lewat cara di atas bisa dilepas (data klaster di server itu dihapus, klaster tetap berjalan). Server yang sudah mati permanen dilepas dengan opsi paksa. Node utama dan anggota awal klaster (etcd) tidak bisa dilepas dari sini.
- Jadikan utama (Lanjutan): peralihan terencana ke replika lain lewat Patroni; proxy aplikasi diperbarui dulu. MCP:
database_jadikan_utama. - Diagnosa: bukti baca-saja keadaan tiap node (kontainer, jabat tangan WireGuard, firewall, port, log tanpa sandi, tampilan Patroni) beserta dugaan masalahnya. MCP:
database_diagnosa. - Mode replikasi & akses dari luar (Lanjutan): ganti sinkron/asinkron, dan izinkan alamat IP tertentu menjangkau port database lewat firewall node. Bawaannya tidak ada yang terbuka ke internet. MCP:
database_ubah_mode,database_akses. - Pra-periksa jaringan: sebelum membuat klaster, bagian Kesiapan di halaman Server menguji UDP/TCP antar server dan waktu tempuhnya, agar firewall penyedia yang menutup terowongan ketahuan lebih dulu. MCP:
jaringan_periksa.
Hapus klaster
Hapus dari halaman detail klaster dengan mengetik nama klaster sebagai konfirmasi. Semua data database ini di semua lokasi dihapus dan tidak bisa dibatalkan. Proxy di server aplikasi ikut dilepas. Server yang sedang tidak terjangkau menyimpan sisanya sampai server itu dilepas.
Klaster yang masih menjadi database sebuah situs tidak bisa dihapus. Hapus situs itu atau pindahkan ke server dengan database lokal dulu.
Cabang database per pull request, dan tombol mengembalikan tabel dari salinan ke klaster.