Belajar Dart - Operational Readiness & Runbooks

#Pendahuluan

Aplikasi yang tidak bisa dioperasikan adalah aplikasi yang gagal. Episode 19 membahas operational readiness: menyiapkan runbook, memonitor kesehatan layanan, menangani insiden, mengelola rilis, dan memelihara aplikasi Dart dalam jangka panjang.

Kode yang hebat tetap membutuhkan proses: bagaimana melakukan deployment tanpa rasa takut, bagaimana mengetahui layanan sakit sebelum pengguna mengeluh, dan bagaimana memperbarui dependency tanpa merusak produksi. Ini semua adalah keterampilan yang membedakan hobby project dari sistem produksi.

#Runbook untuk Deployment, Monitoring, dan Incident Response

#Menulis Runbook Deployment

Runbook adalah dokumen langkah-demi-langkah yang memandu operasi. Bagian deployment harus menyebutkan:

• Langkah build: dart compile exe atau flutter build.
• Pembuatan image container dan push ke registry.
• Strategi rilis: rolling update, blue-green, atau canary.
• Rollback plan: cara kembali ke versi sebelumnya dengan cepat.

dart compile exe bin/server.dart -o bin/server
docker build -t myapp:1.4.0 .
docker push registry.example.com/myapp:1.4.0

docker build -t myapp:1.4.0 . menandai image dengan versi spesifik agar rilis dapat dilacak dan di-rollback secara tepat.

#Monitoring dan Incident Response

Monitor kesehatan layanan sebelum pengguna terkena dampak:

• Health check endpoint: /healthz yang memeriksa dependency penting.
• Metrik: latency, error rate, dan penggunaan memori.
• Alerting: notifikasi saat metrik melewati ambang.

Runbook insiden mendefinisikan siapa yang di-hubungi, langkah triase, dan eskalasi — sehingga saat alarm berbunyi, tim tidak perlu berpikir dari nol.

#Logging, Error Reporting, dan Performance Monitoring

#Structured Logging

Log yang baik terstruktur, bukan sekadar string:

import 'package:logging/logging.dart';
 
void main() {
  final log = Logger('aplikasi');
 
  log.info('Server dimulai', {'port': 8080});
  log.warning('Latensi tinggi', {'ms': 1200});
}

log.info('Server dimulai', {'port': 8080}) mencatat pesan dengan data terstruktur yang mudah dicari dan difilter di sistem log. Hindari mencatat data sensitif seperti token.

#Error Reporting

Jangan biarkan exception hilang di log. Kirim ke layanan error tracking seperti Sentry, yang mengelompokkan error, menangkap stack trace, dan memberi konteks release. Integrasi via package:sentry memakan waktu menit dan memberi visibilitas yang jauh lebih baik.

#Performance Monitoring

Gabungkan metrik runtime — memori, heap, dan throughput — dengan dashboard. Server Dart bisa mengekspos metrik Prometheus, sementara Flutter memakai Firebase Performance atau solusi serupa untuk melacak frame time dan startup.

#Release Management dan Versioning

#Versioning dengan Semantic Versioning

Patuhi Semantic Versioning agar pengguna tahu dampak pembaruan:

• Major: breaking change.
• Minor: fitur baru yang kompatibel.
• Patch: perbaikan bug.

Untuk aplikasi, integrasikan dengan tag git dan CI: setiap tag v1.4.0 memicu build image dengan label yang sama.

#Otomasi Rilis

Otomasi membuat rilis konsisten dan bebas kesalahan manual:

git tag v1.4.0
git push origin v1.4.0

git tag v1.4.0 menandai commit tertentu sebagai rilis. Pipeline yang mendengarkan tag bisa otomatis membangun image, menjalankan test, dan melakukan deploy — membuat rilis menjadi peristiwa yang membosankan dan andal.

#Memelihara Aplikasi Dart yang Berumur Panjang

#Menjaga Dependency Tetap Segar

Aplikasi yang berumur panjang butuh perawatan rutin:

dart pub outdated

dart pub outdated menampilkan package yang tertinggal versinya. Tetapkan jadwal pembaruan dependency, dan selalu jalankan test penuh setelah dart pub upgrade.

#Menghadapi Deprecation

Ekosistem Dart terus bergerak: API lama dipensiunkan, fitur baru hadir. Pantau daftar breaking change di rilis SDK, dan rencanakan migrasi bertahap. dart analyze akan menandai penggunaan API yang deprecated, membantu kalian bersiap lebih awal.

#Menulis untuk Masa Depan

Kode yang mudah dipelihara adalah kode yang dipahami orang lain (termasuk diri kalian enam bulan lagi): fungsi kecil, nama jelas, test yang menggambarkan perilaku, dan dokumentasi yang cukup. Investasi ini terbayar setiap kali aplikasi diubah.

#Penutup

Inti yang harus dibawa pulang:

• Runbook mendokumentasikan deployment, monitoring, dan response insiden.
• Health check dan alerting mendeteksi masalah sebelum pengguna terpengaruh.
• Logging terstruktur dan error tracking memberi visibilitas produksi.
• Semantic Versioning dan tag git membuat rilis dapat dilacak dan di-rollback.
• dart pub outdated rutin menjaga dependency tetap segar.
• Migrasi deprecation direncanakan, bukan ditunda menumpuk.

Di episode 20 selanjutnya kita akan membahas real-world use cases dan patterns — use case mobile, web, backend, dan CLI, pola arsitektur MVC, Clean Architecture, dan reactive, pola data flow dan state management, serta model deployment dan runtime.