[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
.exevia 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.devhanya boleh dipakai untuk pemeriksaan awal, bukan distribusi UAT.
Konfigurasi Cloudflare
- Buat bucket khusus, contoh
scola-assessment-downloads. - Hubungkan custom domain download di R2 > bucket > Settings > Custom Domains. Rekomendasi:
download.gcgscola.id. - Pastikan status custom domain
Active, TLS valid, dan minimum TLS 1.2. - Nonaktifkan public development URL
r2.devsetelah custom domain aktif. - Buat Cache Rule untuk path
/launcher/*agar file.exe,.json, dan.txtmengikuti metadata cache object. - 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, misalnyahttps://download.gcgscola.id.
Jangan menaruh token atau access key dalam source, artifact, manifest, log, maupun launcher binary.
Publikasi kandidat
- Jalankan workflow dari exact clean commit.
- Gunakan versi prerelease baru dan
publish_r2=true. - Isi
r2_public_base_urldengan custom domain aktif. - 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. - Workflow mengunggah object berversi, lalu mengunduh ulang EXE dari custom domain dan membandingkan SHA-256.
- Salin
installer_sha256dan URL immutable dari manifest ke environment staging: LAUNCHER_CURRENT_VERSIONLAUNCHER_DOWNLOAD_URLLAUNCHER_SHA256LAUNCHER_SIGNATURE_ISSUER- 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.