Logging, pencatatan versi, pemeriksaan kesehatan, dan rollback sering tersebar di skrip deployment atau kode aplikasi. Akibatnya, perubahan pada satu langkah dapat mengganggu langkah lain, sementara urutan eksekusi sulit dipahami. Hook deployment berorientasi aspek memusatkan efek samping lintas tahapan tersebut di luar logika aplikasi.

Pendekatan ini mengambil gagasan Aspect Oriented Programming (AOP): tindakan seperti pencatatan dan pemeriksaan dijalankan pada titik tertentu dalam alur utama. Anda tidak perlu framework AOP; gunakan hook eksplisit pada orkestrator atau skrip deployment yang sudah ada.

Memetakan gagasan AOP ke alur deployment

Dalam AOP, join point adalah titik eksekusi yang dapat diberi perilaku tambahan, sedangkan advice adalah perilaku yang dijalankan sebelum, sesudah, atau ketika terjadi kegagalan. Pada deployment, titik itu dapat berupa sebelum rilis diaktifkan, setelah aktivasi, atau ketika pemeriksaan gagal. Hook bertindak sebagai advice; alur utama tetap bertanggung jawab untuk membangun dan mengaktifkan rilis.

Pemisahan ini bukan alasan untuk menyembunyikan pekerjaan penting. Urutan hook harus terlihat, kegagalannya harus memengaruhi hasil deployment sesuai kebijakan, dan setiap hook perlu memiliki kontrak input serta output yang jelas.

Merancang hook deployment tanpa framework baru

Tentukan titik dan kontrak hook

Mulai dengan beberapa titik yang memang dibutuhkan: pre-deploy untuk merekam konteks dan memeriksa prasyarat, post-deploy untuk memeriksa layanan setelah rilis aktif, serta on-failure untuk menjalankan kebijakan rollback. Implementasikan sebagai fungsi pada skrip yang sudah ada atau sebagai perintah kecil yang dipanggil oleh pipeline saat ini.

Berikan konteks rilis secara eksplisit, misalnya ID rilis, versi yang akan dipasang, versi sebelumnya, dan lingkungan. Hindari membaca nilai penting dari keadaan global yang berubah tanpa jejak. Gunakan status keluar yang konsisten: status nol berarti hook berhasil; status bukan nol berarti gagal. Tetapkan di muka apakah kegagalan hook menghentikan deployment atau hanya menghasilkan peringatan.

Contoh urutan rilis

Contoh berikut menunjukkan orkestrasi shell. Fungsi aktivasi dan pemeriksaan kesehatan mewakili perintah yang sudah tersedia di sistem; sesuaikan dengan mekanisme deployment Anda.

#!/usr/bin/env bash
set -Eeuo pipefail

release_id="$1"
previous_release="$2"

log_event() {
  printf '%s release=%s event=%s\n' \
    "$(date -u +%FT%TZ)" "$release_id" "$1"
}

pre_deploy() {
  log_event "pre_deploy"
  printf '%s\n' "$release_id" > current-release-candidate
}

post_deploy() {
  log_event "post_deploy"
  ./check-health
  ./record-release "$release_id"
}

rollback() {
  log_event "rollback"
  ./activate-release "$previous_release"
  ./check-health
}

pre_deploy
./activate-release "$release_id"
if ! post_deploy; then
  rollback
  exit 1
fi
log_event "deploy_succeeded"

Contoh ini sengaja memperlihatkan urutan dan cabang kegagalan. Dalam implementasi nyata, pastikan fungsi rollback memiliki akses ke rilis sebelumnya yang valid dan memeriksa hasil aktivasi serta kesehatan layanan. Jangan menulis bahwa rilis berhasil sebelum seluruh pemeriksaan wajib selesai.

Alur sebelum dan sesudah rilis

Sebelum aktivasi

  1. Validasi parameter dan pastikan artefak rilis tersedia.
  2. Catat ID deployment, versi kandidat, versi aktif, lingkungan, dan waktu mulai.
  3. Jalankan pemeriksaan prasyarat yang aman, seperti konektivitas ke dependensi yang wajib tersedia.
  4. Jika prasyarat wajib gagal, hentikan alur sebelum mengubah rilis aktif.

Sesudah aktivasi

  1. Jalankan pemeriksaan kesehatan terhadap layanan yang sudah aktif, bukan hanya terhadap proses deployment.
  2. Amati metrik dan log selama jendela observasi yang ditetapkan tim.
  3. Jika pemeriksaan lolos, catat versi aktif dan hasil deployment sebagai berhasil.
  4. Jika kriteria rollback terpenuhi, aktifkan kembali rilis sebelumnya, verifikasi kesehatannya, lalu catat hasil rollback.

Untuk layanan dengan trafik bertahap, jalankan pemeriksaan pada setiap tahap sebelum melanjutkan ke tahap berikutnya. Jangan menganggap aktivasi artefak sebagai bukti bahwa seluruh pengguna sudah menerima rilis baru.

Metrik, log, dan kriteria rollback

Pilih sinyal yang berhubungan langsung dengan dampak rilis dan sudah tersedia di sistem observabilitas. Amati, sesuai jenis layanan:

  • Tingkat kegagalan permintaan, termasuk respons HTTP 5xx.
  • Latensi pada persentil yang digunakan tim untuk SLO.
  • Kegagalan pemeriksaan kesehatan dan ketersediaan dependensi wajib.
  • Restart proses atau kegagalan worker, bila relevan.
  • Log galat yang dapat dikaitkan dengan ID rilis dan waktu deployment.

Tetapkan kriteria rollback sebelum merilis. Contoh kebijakan: rollback jika pemeriksaan kesehatan wajib gagal setelah aktivasi, atau jika tingkat galat melampaui ambang operasional tim selama jendela observasi yang ditentukan. Isi nilai ambang dan durasi berdasarkan SLO serta pola trafik layanan; jangan memakai angka universal tanpa data. Bedakan kegagalan yang memerlukan penghentian langsung dari lonjakan singkat yang perlu diselidiki lebih lanjut.

Log terstruktur sebaiknya memuat ID deployment, versi lama dan baru, lingkungan, nama hook, hasil, durasi, serta alasan kegagalan. Hindari mencatat rahasia atau data pengguna. Pastikan kegagalan mengirim log tidak diam-diam mengubah status deployment menjadi berhasil jika pencatatan merupakan persyaratan audit.

Menguji urutan dan menghindari efek samping tersembunyi

Hook dapat membuat alur sulit dipahami jika didaftarkan secara implisit atau menjalankan perubahan yang tidak terlihat. Buat urutan pemanggilan eksplisit, dokumentasikan apakah tiap hook wajib atau opsional, dan tetapkan perilaku saat hook gagal. Hook yang mengubah keadaan harus idempoten jika memungkinkan, atau harus memiliki mekanisme pemulihan yang jelas.

Uji orkestrasi dengan perintah tiruan atau lingkungan nonproduksi. Verifikasi bahwa urutan normal adalah prasyarat, aktivasi, pemeriksaan pascarilis, lalu pencatatan keberhasilan. Uji juga bahwa pemeriksaan gagal memicu rollback, kegagalan rollback tercatat sebagai kegagalan tersendiri, dan hook yang wajib gagal menghentikan langkah berikutnya. Jangan hanya menguji fungsi hook secara terpisah; uji urutan dan cabang kegagalannya.

Hindari hook yang diam-diam mengubah konfigurasi aplikasi, melakukan migrasi yang tak dapat dibatalkan, atau mengirim notifikasi tanpa batas percobaan yang jelas. Migrasi skema dan perubahan data perlu dirancang dengan kebijakan kompatibilitas serta pemulihan tersendiri; rollback kode tidak otomatis membatalkan perubahan data.

Postmortem ringan setelah insiden

Setelah rollback atau gangguan, catat kronologi berdasarkan log: versi yang dirilis, hook yang berjalan, sinyal yang memicu keputusan, dan hasil pemulihan. Identifikasi penyebab teknis serta celah deteksi atau prosedur tanpa berfokus pada kesalahan individu.

Tutup dengan tindakan yang memiliki pemilik dan tenggat: misalnya menambah pemeriksaan kesehatan yang relevan, memperbaiki ambang alert, atau menguji cabang rollback. Pastikan tindakan tersebut diuji pada deployment berikutnya. Tujuannya bukan menambah hook sebanyak mungkin, melainkan menjaga efek samping tetap teramati, dapat diuji, dan terpisah dari logika aplikasi.