Staged Rollout React Native: Halt Rilis Otomatis via Crash Alert

Regresi runtime crash pada aplikasi React Native kerap lolos dari tahap pengujian lokal dan staging. Masalah sering kali baru terdeteksi setelah rilis bertahap (staged rollout) mencapai 10% hingga 20% pengguna di Google Play Store. Jika pemantauan mengandalkan inspeksi manual pada dashboard, respon tim engineering akan terlambat, memperbesar blast radius dan menurunkan reputasi aplikasi.

Solusinya adalah memutus rantai distribusi secara otomatis (automated halt). Ketika metrik crash velocity atau crash-free session rate melanggar batas SLA, sistem alerting langsung mengeksekusi skrip untuk menghentikan peluncuran rilis di Google Play Console tanpa campur tangan manusia.

Arsitektur Otomasi: Webhook ke Google Play Developer API

Mekanisme ini menghubungkan platform observabilitas langsung dengan store API melalui webhook listener perantara:

1. Observabilitas (Sentry / Crashlytics): Memantau rilis baru. Jika crash-free rate turun di bawah 99.0% atau terjadi spike crash velocity pada versi rilis tertentu dalam kurun waktu 15 menit, alert dipicu.
2. Alert Webhook Handler: Layanan perantara (Cloud Function, AWS Lambda, atau webhook worker) memvalidasi payload alert dan membaca target versi aplikasi.
3. Google Play Developer API: Handler memanggil Google Edits API untuk mengubah status rilis dari inProgress menjadi halted pada track produksi.

Alternatif paling ringkas: Gunakan Google Cloud Pub/Sub langsung dari Firebase Crashlytics ke Cloud Functions tanpa layer webhook kustom.

Implementasi Handler: Node.js & Google Play Developer API

Gunakan pustaka resmi googleapis di Node.js. Skrip ini memerlukan Service Account GCP dengan hak akses Release apps to production pada Google Play Console.

const { google } = require('googleapis');

const PACKAGE_NAME = 'com.example.reactnativeapp';
const TRACK = 'production';

async function haltStagedRollout() {
  const auth = new google.auth.GoogleAuth({
    keyFile: process.env.GOOGLE_APPLICATION_CREDENTIALS,
    scopes: ['https://www.googleapis.com/auth/androidpublisher'],
  });

  const play = google.androidpublisher({ version: 'v3', auth });

  // 1. Buat Edit baru
  const appEdit = await play.edits.insert({
    packageName: PACKAGE_NAME,
  });
  const editId = appEdit.data.id;

  // 2. Ambil status track saat ini
  const trackData = await play.edits.tracks.get({
    editId,
    packageName: PACKAGE_NAME,
    track: TRACK,
  });

  const releases = trackData.data.releases || [];
  const activeRelease = releases.find((r) => r.status === 'inProgress');

  if (!activeRelease) {
    console.log('Tidak ada staged rollout berstatus inProgress.');
    return;
  }

  // 3. Ubah status menjadi halted
  // ponytail: pertahankan userFraction saat ini agar rilis berhenti di persentase berjalan
  activeRelease.status = 'halted';

  await play.edits.tracks.update({
    editId,
    packageName: PACKAGE_NAME,
    track: TRACK,
    requestBody: {
      track: TRACK,
      releases: [activeRelease],
    },
  });

  // 4. Commit perubahan agar berlaku di Play Store
  await play.edits.commit({
    editId,
    packageName: PACKAGE_NAME,
  });

  console.log(`Rollout halted untuk release versi: ${activeRelease.name}`);
}

// Webhook endpoint receiver (Express.js / Serverless)
module.exports.sentryAlertHandler = async (req, res) => {
  const event = req.body;
  
  // Filter alert Sentry berdasarkan rule crash threshold
  if (event.action === 'triggered' && event.data?.issue?.level === 'fatal') {
    try {
      await haltStagedRollout();
      return res.status(200).send({ status: 'Rollout halted successfully' });
    } catch (error) {
      console.error('Gagal halt rollout:', error);
      return res.status(500).send({ error: error.message });
    }
  }

  return res.status(200).send({ status: 'Ignored' });
};

Dilewati: Validasi signature Sentry HMAC dan error retry backoff. Tambahkan jika endpoint dipaparkan ke publik atau sering mengalami rate-limit API Play Store.

SLA dan Threshold yang Disarankan

Menentukan ambang batas pencegahan membutuhkan kehati-hatian agar tidak memicu false positive pada fase awal rollout saat jumlah pengguna sampel masih kecil:

• Ukuran Sampel Minimum: Abaikan alert otomatis sampai rilis menyentuh minimal 500–1.000 distinct sessions untuk mencegah bias statistik.
• Crash-Free Sessions SLA: Ambil tindakan halt jika crash-free session berada di bawah 99.2% dalam jendela observasi 30 menit.
• Crash Velocity Spike: Halt langsung jika muncul crash baru pada native layer (misal: bridging TurboModule atau Java/C++ segfault) dengan kecepatan > 25 kejadian per 100 sesi baru.

Format Postmortem Ringan Pasca-Insiden

Saat rollout terhenti secara otomatis, gunakan format dokumen evaluasi ringkas ini untuk menyusun respon teknis:

Langkah Pencegahan untuk Pipeline Berikutnya

Untuk mencegah insiden serupa lolos ke staged rollout masa depan:

1. Validasi ABI dan Native Binding: Tambahkan sanity test smoke-test otomatis di Firebase Test Lab pada berbagai arsitektur CPU (arm64-v8a, armeabi-v7a) sebelum memicu promote track internal ke staged rollout.
2. CodePush/OTA vs Binary Release: Bedakan alur rilis bug fix. Regresi murni lapisan JavaScript dapat ditambal langsung menggunakan rilis OTA over-the-air tanpa menaikkan binary version code di Play Store, sedangkan native crash wajib melalui binary rollout bertahap ulang.
3. Canary Internal Otomatis: Jalankan tahap canary wajib pada 1% internal tester selama 6 jam sebelum traffic dilepas ke publik 10%.