Dokumentasi / Database terkelola

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:

PeranIsiTugas
Server data 1Database lengkapUtama atau replika.
Server data 2Database lengkapReplika atau utama.
SaksiTanpa dataIkut 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/17MariaDB 12.3/10.11
TeknologiPatroni + etcdGalera + garbd (saksi)
Cocok untukAplikasi baruWordPress, Laravel, aplikasi PHP (kompatibel MySQL)
PenulisSatu utama, satu replikaNode data pertama yang sehat menjadi penulis, node lain cadangan penulis
Mode replikasiAsinkron atau sinkron (pilihan)Selalu sinkron
Port54323306
Pengguna awalpostgresroot
TLSWajib (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)

MariaDB Galera selalu sinkron: setiap tulisan disetujui kedua lokasi data sebelum selesai.

Membuat klaster

  1. Tambahkan minimal tiga server ke Saka (lihat Mulai). Semuanya harus tersambung.
  2. Buka Database, tekan + Buat klaster database.
  3. Pilih mesin, dua server data, satu server saksi, mode replikasi, dan nama (huruf kecil, angka, tanda minus, 3-31 karakter, diawali huruf).
  4. 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:

.env
DATABASE_URL=postgresql://postgres:[email protected]:5432,198.51.100.20:5432/postgres?sslmode=require&target_session_attrs=read-write&connect_timeout=5

MariaDB: alamat langsung

.env
DATABASE_URL=mysql://root:[email protected]:3306/?ssl=true

Alamat 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:

PostgreSQL lewat proxy
DATABASE_URL=postgresql://postgres:[email protected]:5432/postgres?sslmode=require
MariaDB lewat proxy
DATABASE_URL=mysql://root:[email protected]:3306/?ssl=true

Contoh yang dipakai saat uji (sertifikat MariaDB dibuat otomatis, jadi verifikasi sertifikat dimatikan; koneksinya tetap terenkripsi):

PHP (mysqli)
$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);
Node.js (mysql2)
mysql.createConnection({ host: '127.0.0.1', user: 'root', password: sandi,
  database: 'nama_db', ssl: { rejectUnauthorized: false } })
Contoh Laravel .env
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nama_database_anda
DB_USERNAME=root
DB_PASSWORD=SANDI

TLS 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.

  1. 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.
  2. Buat pengguna: isi nama (huruf kecil, angka, garis bawah; 3 sampai 32 karakter), pilih database, lalu pilih hak:
    • Baca saja: hanya SELECT dan 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.
  3. 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:

  1. Hentikan aplikasi lama agar tidak ada transaksi baru selama penyalinan.
  2. 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).
  3. Tekan Salin ke klaster. Saka memasang proxy di server itu, lalu menjalankan pg_dump ke klaster dalam satu transaksi dan membandingkan jumlah baris setiap tabel di kedua sisi.

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:

  1. menghentikan layanan (aplikasi mati selama penyalinan; Anda diminta mengonfirmasi),
  2. menyalin database dalam satu transaksi dan membandingkan jumlah baris,
  3. menulis ulang variabel di berkas env ke alamat klaster (berkas lama disimpan di sebelahnya),
  4. 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:

  1. Buat bucket kosong di penyedia S3 milik Anda (Amazon S3, Cloudflare R2, DigitalOcean Spaces, Wasabi, atau yang kompatibel).
  2. Tekan Nyalakan cadangan ke S3, isi endpoint (nama host saja), bucket, access key, secret key, dan lama simpan (bawaan 14 hari).
  3. Simpan kode pemulihan yang tampil sekali. Cadangan di S3 dienkripsi dengan kode itu; bila semua server klaster hilang, kode itu satu-satunya cara membukanya.

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.

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:

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 lagiBaris hilang
MariaDB, node penulis dimatikan mendadak, klien PHP dan Node lewat proxy±11 detik0
PostgreSQL uji produk, node penulis dimatikan mendadak, klien lewat proxy33 detik0
PostgreSQL uji konsep, mode asinkron38,6 detik0
PostgreSQL uji konsep, mode sinkron32,0 detik0

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:

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.

Segera

Cabang database per pull request, dan tombol mengembalikan tabel dari salinan ke klaster.