Catatan engineering

Merilis Sistem yang Mudah Dirawat ke Production

Checklist praktis untuk serah terima: environment, kepemilikan, dokumentasi, dan kesiapan operasi hari pertama.

Sistem belum selesai hanya karena demo berjalan di localhost. Sistem selesai ketika orang lain dapat mengoperasikan, memulihkan, dan mengembangkannya tanpa pengetahuan yang hanya tersimpan di kepala satu orang.

Untuk software institusi dan bisnis lokal, serah terima production adalah bagian dari produk. Jika deployment bergantung pada langkah manual yang tidak terdokumentasi, maintainability runtuh di minggu kedua.

Definisikan unit yang dapat dioperasikan

Sebelum rilis, tuliskan unit operasional minimum: kode aplikasi, environment variable, migrasi database, storage, process manager, reverse proxy, backup, dan log.

Pisahkan rahasia dari lore tim

Kredensial, key, dan perbedaan environment harus berada di tempat yang diketahui dengan pemilik yang jelas. Dokumen serah terima yang bertuliskan “tanya saya nanti” bukan serah terima.

Buat kegagalan terlihat

Pastikan operator tahu di mana log berada, cara me-restart layanan, dan cara memverifikasi kesehatan setelah deploy. Rollback tidak perlu mewah—cukup sudah dilatih.

Checklist hari pertama

  • Bisakah operator baru deploy hanya dengan langkah tertulis?
  • Apakah migrasi dan backup termasuk dalam jalur rilis?
  • Adakah smoke test untuk alur kritis?
  • Apakah kepemilikan dan kontak eskalasi eksplisit?
  • Bisakah sistem dipulihkan dari backup tanpa menebak-nebak?