Basis data cadangan dan salinan laporan (untuk tim Kaam360)

Panduan ini untuk tim Kaam360 (panel platform). Pelanggan tidak memerlukannya.

Apa itu standby

Situs langsung menyimpan datanya dalam satu basis data PostgreSQL di server. Standby adalah PostgreSQL kedua di server yang sama yang menerima setiap perubahan saat itu juga, sehingga hanya tertinggal beberapa milidetik. Jika basis data langsung rusak, situs dapat dialihkan ke standby dalam sekitar dua menit alih-alih memulihkan cadangan semalam. Standby tidak menggantikan cadangan malam di luar server, yang melindungi dari hilangnya seluruh server: keduanya diperlukan.

Semuanya dilakukan dengan tombol di GitHub (Actions, PostgreSQL standby, Run workflow): pilih mode, ketik kata yang sama di kotak konfirmasi, tekan tombol hijau. Prosedur tertulisnya ada di file deploy/STANDBY.txt.

Melihat apakah standby sehat

1. Buka panel platform dan lihat Overview. Kartu Database standby bertuliskan Streaming (baik), Behind (tertinggal), atau Not connected (tidak terhubung), beserta seberapa jauh tertinggalnya.
2. Informasi yang sama ada di alamat /health situs, di bagian "standby".
3. Di GitHub, mode status mencetak halaman lengkap: layanan Windows, keadaan streaming, byte dan detik keterlambatan, ukuran salinan. Mode ini tidak mengubah apa pun.
4. Jika standby hilang atau tertinggal selama sepuluh menit, tim menerima satu email (ke alamat dukungan di Settings & team, jika tidak ada ke setiap administrator platform), diulang paling sering setiap enam jam. Log Activity platform mendapat satu baris saat terjadi masalah dan saat kembali baik.

Menyiapkan atau memperbaikinya

Jalankan mode setup. Situs langsung tidak dihentikan. Mode ini membuat pengguna basis data (kata sandi hanya disimpan di server), mengambil salinan lengkap, memulai salinan sebagai standby, mendaftarkan layanan Windows, memblokir port-nya dari luar, dan memberi tahu situs. Standby yang sehat dibiarkan, jadi menjalankannya lagi selalu aman. Jika sebuah langkah gagal, skrip menyebutkan langkah mana dan alasannya, dan tidak ada yang berubah di situs langsung.

Beralih ke standby

Jalankan mode failover saat basis data langsung rusak dan standby baik-baik saja. Situs menampilkan halaman "sedang diperbarui" selama sekitar dua menit. Standby menjadi basis data langsung, situs diarahkan ke sana, dan pengaturan sebelumnya disimpan sebagai appsettings.local.json.before-failover. Skrip lalu mencetak apa yang harus dilakukan berikutnya: pakai situs seperti biasa, simpan dulu folder basis data lama, dan jalankan setup saat server sedang tenang untuk membuat standby baru. Salinan yang sudah dipromosikan tidak pernah kembali menjadi standby; standby baru dibuat dari salinan baru.

Laporan berat membaca dari salinan

Saat standby sedang streaming dan tertinggal kurang dari beberapa menit, pembuat laporan, email laporan terjadwal, unduhan CSV dan Excel, portofolio, laporan proyek, dan unduhan data lengkap membaca dari standby alih-alih basis data langsung, sehingga laporan besar tidak pernah memperlambat orang yang sedang bekerja. Laporan seperti itu menampilkan Data as of (data per) diikuti waktu perubahan terbaru di salinan. Jika salinan tidak ada, tidak dapat dijangkau, atau tertinggal lebih dari beberapa menit, laporan memakai basis data langsung, tanpa ada yang perlu melakukan apa pun. Tidak ada yang pernah ditulis ke salinan, dan setiap laporan hanya melihat data organisasinya sendiri, persis seperti di basis data langsung. Alamat /health menyatakan apakah laporan dilayani dari salinan ("reports").

Menghapusnya

Jalankan mode remove. Mode ini menghentikan dan menghapus standby serta mengeluarkannya dari pengaturan situs. Basis data langsung tidak disentuh. Setup dapat dijalankan lagi kapan saja.