Lewati ke isi

[DEPRECATED] Cloudflare R2 Launcher Distribution Runbook

[!WARNING] DEPRECATED: Scola Launcher telah dipensiunkan dalam mendukung peluncuran ujian direct web-driven Safe Exam Browser (SEB) multi-platform (Windows, macOS, iPadOS). Distribusi biner launcher .exe via Cloudflare R2 dihentikan; dokumen ini dipertahankan sebagai catatan historis.

Scope dokumen ini hanya untuk artefak publik immutable historis: installer Scola Launcher, manifest, checksum, dan opsional mirror installer resmi SEB. Token peserta dan konfigurasi .seb one-time tidak boleh disimpan di bucket publik.

Topologi yang dipilih

  • Bucket R2 bersifat private secara default.
  • Hanya custom domain download yang dihubungkan sebagai public access.
  • Gunakan key berversi, misalnya launcher/v1.2.0-alpha.1/ScolaLauncher-Setup-1.2.0-alpha.1.exe.
  • Jangan overwrite key yang sudah dipublikasikan. Versi baru menggunakan key baru.
  • Object versi memakai Cache-Control: public, max-age=31536000, immutable.
  • Portal memakai endpoint stabil /api/v1/secure/launcher/download, yang mengarahkan peserta ke URL immutable aktif.
  • r2.dev hanya boleh dipakai untuk pemeriksaan awal, bukan distribusi UAT.

Konfigurasi Cloudflare

  1. Buat bucket khusus, contoh scola-assessment-downloads.
  2. Hubungkan custom domain download di R2 > bucket > Settings > Custom Domains. Rekomendasi: download.gcgscola.id.
  3. Pastikan status custom domain Active, TLS valid, dan minimum TLS 1.2.
  4. Nonaktifkan public development URL r2.dev setelah custom domain aktif.
  5. Buat Cache Rule untuk path /launcher/* agar file .exe, .json, dan .txt mengikuti metadata cache object.
  6. Aktifkan Smart Tiered Cache bila tersedia.

GitHub repository configuration

Workflow .github/workflows/build-launcher.yml membutuhkan:

  • secret CLOUDFLARE_API_TOKEN: token terbatas untuk menulis object ke bucket target;
  • secret CLOUDFLARE_ACCOUNT_ID;
  • repository variable R2_BUCKET_NAME;
  • input workflow r2_public_base_url, misalnya https://download.gcgscola.id.

Jangan menaruh token atau access key dalam source, artifact, manifest, log, maupun launcher binary.

Publikasi kandidat

  1. Jalankan workflow dari exact clean commit.
  2. Gunakan versi prerelease baru dan publish_r2=true.
  3. Isi r2_public_base_url dengan custom domain aktif.
  4. Untuk sementara gunakan URL release resmi SEB sebagai seb_download_url. Setelah mirror SEB tervalidasi tersedia, build kandidat baru dengan URL R2 immutable dan SHA resmi yang sama.
  5. Workflow mengunggah object berversi, lalu mengunduh ulang EXE dari custom domain dan membandingkan SHA-256.
  6. Salin installer_sha256 dan URL immutable dari manifest ke environment staging:
  7. LAUNCHER_CURRENT_VERSION
  8. LAUNCHER_DOWNLOAD_URL
  9. LAUNCHER_SHA256
  10. LAUNCHER_SIGNATURE_ISSUER
  11. Restart staging melalui runbook release, lalu verifikasi manifest, redirect download, ukuran, magic bytes MZ, dan checksum penuh.

Rollback

Rollback tidak menghapus object. Kembalikan environment manifest ke URL dan SHA kandidat sebelumnya, restart staging, lalu ulangi smoke test. Object immutable lama dipertahankan untuk audit dan rollback.