Deployment lintas cluster yang aman membutuhkan lebih dari sekadar menjalankan versi baru di beberapa lokasi. Anda perlu memastikan konfigurasi dan jalur trafik siap, mengirim perubahan secara bertahap, lalu menghentikan rollout atau melakukan rollback ketika metrik layanan memburuk.

Pendekatan praktisnya adalah memperlakukan setiap cluster sebagai tahap rilis yang dapat dikendalikan secara terpisah. Mulai dari satu cluster dengan trafik terbatas, verifikasi readiness dan metrik, lalu lanjutkan ke cluster berikutnya. Federasi cluster Linkerd dapat menjadi konteks untuk menghubungkan layanan lintas cluster, tetapi kontrol rollout dan keputusan rollback tetap perlu dirancang pada lapisan deployment dan routing.

Rancang jalur rilis sebelum mengubah aplikasi

Prasyarat routing dan kesehatan cluster

Tentukan komponen yang membagi trafik sebelum rollout dimulai. Pilih satu lapisan sebagai sumber kebenaran, misalnya load balancer global, ingress controller, atau gateway yang sudah digunakan. Pastikan lapisan tersebut dapat mengarahkan trafik ke cluster tertentu dan mengurangi atau menghentikan trafik ke cluster yang bermasalah.

  • Setiap cluster memiliki endpoint yang dapat diperiksa dari luar dan kebijakan health check yang konsisten.
  • Routing dapat diubah tanpa menghapus seluruh kapasitas layanan secara tidak sengaja.
  • DNS, firewall, sertifikat, dan jalur jaringan antarkluster sudah diuji.
  • Cluster memiliki kapasitas cadangan untuk menerima trafik yang dialihkan dari cluster lain.

Jangan menganggap readiness Kubernetes sebagai pemeriksaan kesehatan global. Probe readiness menentukan apakah pod siap menerima trafik melalui Service di clusternya; probe itu tidak membuktikan bahwa routing eksternal, dependensi, atau komunikasi lintas cluster berfungsi.

Sinkronisasi konfigurasi dan kompatibilitas

Gunakan sumber konfigurasi yang dapat ditinjau dan diterapkan secara konsisten, seperti manifest dalam repositori Git. Terapkan perubahan konfigurasi yang diperlukan ke semua cluster sebelum mengirim versi aplikasi yang bergantung padanya. Periksa perbedaan nilai per lingkungan, secret, kuota, kebijakan jaringan, serta versi dependensi.

Perubahan skema database harus kompatibel selama versi lama dan baru berjalan bersamaan. Gunakan pola expand-and-contract: tambahkan struktur yang kompatibel, rilis aplikasi yang dapat memakai struktur lama maupun baru, migrasikan data bila perlu, lalu hapus struktur lama setelah rollback tidak lagi diperlukan. Jangan mengandalkan rollback deployment untuk membatalkan perubahan data yang tidak kompatibel.

Gunakan federasi Linkerd sebagai konteks konektivitas

Federasi cluster Linkerd dapat membantu layanan di cluster berbeda menemukan dan berkomunikasi satu sama lain melalui mekanisme multicluster Linkerd. Desain operasionalnya tetap perlu mencakup gateway yang dapat dijangkau, identitas dan kepercayaan antarkluster, serta layanan yang memang perlu diekspos lintas cluster. Uji jalur tersebut sebelum rilis; keberadaan mesh saja tidak menjamin aplikasi memiliki rute, kapasitas, atau kebijakan trafik yang benar.

Dokumentasi yang dirujuk membahas federasi cluster Linkerd sebagai konteks untuk ketersediaan lintas cluster. Gunakan dokumentasi resmi yang sesuai dengan versi Linkerd yang terpasang untuk memeriksa detail instalasi dan konfigurasi. Hindari menyalin konfigurasi dari versi lain tanpa validasi.

Pisahkan dua keputusan: Linkerd membantu konektivitas layanan, sedangkan mekanisme rollout menentukan cluster mana yang menerima trafik dan berapa porsinya. Bila kontrol trafik berbobot tidak tersedia pada lapisan yang digunakan, lakukan tahapan per cluster dengan mengalihkan trafik secara eksplisit melalui load balancer atau gateway.

Jalankan rollout bertahap dan ukur dampaknya

  1. Validasi prarilis. Terapkan konfigurasi yang kompatibel, jalankan pemeriksaan konektivitas, dan pastikan versi lama tetap dapat beroperasi.
  2. Rilis ke cluster pertama. Terapkan versi baru tanpa mengubah trafik secara luas. Pastikan semua pod yang diharapkan lolos readiness dan tidak mengalami restart berulang.
  3. Kirim trafik terbatas. Alihkan sebagian kecil trafik ke cluster tersebut, jika lapisan routing mendukung pembagian berbobot. Jika tidak, gunakan tahap per cluster dengan kontrol trafik yang jelas.
  4. Evaluasi sebelum melanjutkan. Bandingkan error rate, latensi, throughput, dan kesehatan dependensi dengan baseline serta ambang layanan yang sudah ditetapkan.
  5. Perluas secara bertahap. Naikkan porsi trafik atau lanjutkan ke cluster berikutnya hanya setelah jendela observasi memenuhi kriteria. Ulangi pemeriksaan pada setiap tahap.
  6. Selesaikan rollout. Setelah seluruh cluster stabil, pertahankan pemantauan dan jangan langsung menghapus versi lama atau jalur rollback.

Readiness adalah syarat masuk, bukan bukti keberhasilan rollout. Metrik aplikasi membantu mendeteksi masalah yang tidak terlihat dari status pod, seperti respons lambat, kegagalan dependensi, atau kenaikan error pada jenis permintaan tertentu. Gunakan ambang yang ditetapkan sebelum rilis, bukan keputusan berdasarkan satu lonjakan sesaat.

Contoh gerbang keputusan

lanjutkan jika:
  readiness_pod == sehat
  error_rate <= ambang_layanan
  p95_latency <= ambang_layanan
  durasi_observasi >= jendela_yang_ditetapkan

Nilai ambang dan durasi harus mengikuti SLO, pola trafik, serta waktu yang diperlukan untuk melihat dampak. Hindari angka universal: layanan dengan karakteristik berbeda memerlukan batas yang berbeda. Pantau juga kapasitas cluster tujuan sebelum mengalihkan trafik, agar pemulihan tidak memindahkan kegagalan ke cluster lain.

Prosedur rollback saat error rate atau latensi memburuk

Tetapkan pemilik keputusan, ambang pemicu, dan cara mengubah routing sebelum rilis. Saat ambang terlampaui, hentikan promosi versi terlebih dahulu. Jangan menunggu rollout selesai di semua cluster.

  1. Bekukan rollout. Hentikan perubahan konfigurasi dan deployment lanjutan agar kondisi insiden tidak terus berubah.
  2. Konfirmasi dampak. Periksa error rate, latensi, readiness, restart pod, kapasitas, dan status dependensi. Bandingkan dengan baseline dan pastikan gangguan bukan berasal dari sumber pemantauan.
  3. Kurangi atau hentikan trafik ke versi baru. Gunakan lapisan routing yang sudah ditetapkan untuk mengalihkan trafik ke cluster atau versi stabil. Pastikan tujuan masih memiliki kapasitas cukup.
  4. Pulihkan versi aplikasi. Rollback deployment pada cluster terdampak ke revisi stabil yang diketahui. Jika penyebabnya konfigurasi, pulihkan konfigurasi secara terkontrol dan verifikasi dampaknya.
  5. Validasi pemulihan. Periksa readiness dan metrik layanan setelah perubahan. Pastikan trafik benar-benar mencapai target sehat dan tidak ada antrean atau kegagalan tertunda yang memperpanjang dampak.
  6. Batasi perubahan berikutnya. Jangan lanjutkan rollout sampai penyebab diketahui, tindakan korektif diuji, dan kriteria rilis disetujui kembali.

Rollback kode tidak selalu memulihkan layanan jika migrasi data, perubahan konfigurasi, atau dependensi eksternal tidak dapat dibatalkan. Karena itu, utamakan perubahan yang kompatibel ke belakang dan siapkan prosedur pemulihan data secara terpisah. Hindari menghapus resource atau data secara otomatis sebagai bagian dari rollback.

Checklist verifikasi dan pencegahan berulang

Checklist sebelum rilis

  • Routing dapat membatasi dan memindahkan trafik per cluster.
  • Health check eksternal, readiness, dan pemeriksaan dependensi telah diuji.
  • Manifest serta konfigurasi antarcluster sudah dibandingkan; secret dan kebijakan jaringan tersedia.
  • Kapasitas cluster tujuan mencukupi untuk menerima trafik yang dialihkan.
  • Migrasi data kompatibel dengan versi lama dan baru, atau memiliki prosedur pemulihan yang jelas.
  • Dashboard, ambang metrik, jendela observasi, pemilik rilis, dan prosedur rollback telah ditetapkan.

Checklist saat rollout atau insiden

  • Versi baru hanya menerima trafik sesuai tahap yang disetujui.
  • Error rate dan latensi dibandingkan dengan baseline serta SLO.
  • Readiness, restart, kapasitas, dan kesehatan dependensi diperiksa bersama.
  • Promosi dihentikan ketika gerbang metrik gagal.
  • Setelah rollback, jalur trafik dan pemulihan layanan diverifikasi, bukan hanya status deployment.

Postmortem singkat

Catat waktu mulai dan selesai, cluster terdampak, perubahan yang dirilis, dampak pada pengguna, sinyal pertama yang terlewat, serta tindakan yang memulihkan layanan. Bedakan penyebab teknis dari celah proses, lalu buat tindakan pencegahan yang dapat diuji: misalnya pemeriksaan routing otomatis, validasi konfigurasi antarcluster, atau gerbang promosi berdasarkan metrik. Tetapkan pemilik dan tenggat setiap tindakan, kemudian uji prosedur rollback pada rilis berikutnya.

Deployment lintas cluster aman ketika trafik dapat dikendalikan, konfigurasi dan data tetap kompatibel, serta keputusan promosi maupun rollback berlandaskan pemeriksaan yang dapat diamati. Federasi Linkerd mendukung konteks konektivitas; ketersediaan saat rilis tetap bergantung pada routing, kapasitas, dan disiplin operasional.