2026-11-06 · 11 min
Change Freeze Deployment Tim Kecil Jelang 11.11 di GitHub
Hari ini Jumat, 6 November, dan kalau Anda tim kecil yang produknya ikut ramai di musim 11.11, akhir pekan ini adalah akhir pekan terakhir yang masih “aman” untuk eksperimen. Saya mengasumsikan trafik mulai naik Senin depan, dan tanggal 11 sendiri jatuh di hari Rabu, hari kerja tengah minggu. Godaannya selalu sama: ada satu fitur yang hampir selesai, timnya kecil, dan rasanya sayang kalau tidak dirilis sebelum momen besar datang. Masalahnya, yang dibutuhkan menjelang momen seperti ini bukan semangat buru-buru merilis, tapi change freeze deployment yang jendelanya jelas dan tidak bergantung pada ingatan orang.
Saya sengaja menulis “tidak bergantung pada ingatan orang” karena itulah yang biasanya gagal di tim kecil. Freeze diumumkan di grup chat, dipin sebentar, lalu tenggelam oleh pesan lain. Orang yang mengumumkannya cuti tiga hari sebelum tanggal penting. Kontributor baru yang belum ada saat pengumuman dibuat, tidak tahu ada freeze sama sekali. Tulisan ini adalah setup deploy freeze GitHub Actions yang saya pakai supaya aturan freeze hidup sebagai konfigurasi yang dibaca mesin, bukan sebagai kesepakatan lisan: satu file kalender, satu ruleset di branch main (GitHub rulesets branch protection), satu job GitHub Actions, dan satu environment dengan required reviewers. Semuanya siap disalin.
Kenapa Change Freeze Deployment Tidak Bisa Mengandalkan Ingatan Tim
Prinsipnya sederhana: kalau sesuatu rusak di hari biasa, dampaknya kecil dan gampang di-debug santai. Kalau rusak tepat saat trafik 11.11 sedang tinggi, tim harus memperbaiki sambil menahan beban yang jauh lebih besar dari biasanya, dan setiap menit downtime menyentuh lebih banyak orang. Change freeze bukan larangan merilis selamanya, hanya menggeser rilis non-darurat ke jendela waktu yang lebih aman.
Supaya aturan ini benar-benar ditegakkan, saya memisahkannya ke dua gerbang independen:
- Gerbang di level merge, lewat ruleset branch
maindan satu status check bernamafreeze-guardyang tahu persis kapan jendela freeze aktif. - Gerbang di level deploy, lewat GitHub Environment dengan required reviewers, sehingga sekalipun ada PR yang lolos merge, eksekusi deploy-nya tetap berhenti menunggu persetujuan manusia.
Dua gerbang ini sengaja dibuat terpisah. Kalau salah satu luput, misalnya status check-nya sedang gagal karena bug di workflow itu sendiri, yang satu lagi tetap menahan.
Cara Membuat Change Freeze Deployment dengan Kalender YAML
Sumber kebenarannya adalah satu file YAML yang hidup di repo, bisa di-diff, dan perubahannya tercatat di riwayat git:
# .github/freeze-calendar.yml
# Setiap perubahan di file ini WAJIB lewat pull request dan disetujui
# code owner yang tercantum di CODEOWNERS untuk path ini.
freezes:
- name: "11.11 Musim Promo"
start: "2026-11-07T00:00:00+07:00"
end: "2026-11-12T08:00:00+07:00"
reason: "Trafik puncak 11.11. Tutup dengan review lebih ketat sampai trafik stabil kembali."
opened_by: "@nama-pic-release"
Dua hal yang sengaja saya pilih di sini:
- Waktu ditulis dengan offset eksplisit (
+07:00), bukan hanya tanggal.new Date()di JavaScript mem-parsing string ISO 8601 dengan offset secara benar apa pun zona waktu mesin yang menjalankannya, jadi runner GitHub Actions yang defaultnya UTC tidak akan salah hitung. - Field
reasondanopened_bywajib diisi, bukan kosmetik. Siapa pun yang membuka PR darurat saat freeze aktif bisa langsung melihat siapa yang memutuskan freeze ini dan kenapa, tanpa harus bertanya di chat.
Lindungi file ini sendiri lewat CODEOWNERS, mengikuti pola yang sudah saya pakai di setup repo ramah kontributor:
# .github/CODEOWNERS
/.github/freeze-calendar.yml @org-kamu/release-managers
Dengan baris ini, membuka, memperpanjang, atau mencabut freeze lebih awal semuanya harus lewat PR yang disetujui tim release-managers. Tidak ada jalur mencabut freeze hanya dengan bilang “udah boleh deploy kok” di grup chat.
GitHub Environments: Required Reviewers dan Deployment Branch Policy
Environment di GitHub bukan sekadar label. Ia punya dua aturan proteksi yang langsung relevan untuk change freeze: required reviewers dan deployment branch policy. Keduanya diterapkan di level environment, jadi berlaku untuk setiap job di workflow mana pun yang mendeklarasikan environment: production, tanpa perlu diulang di tiap workflow.
Pasang lewat gh CLI. Cari dulu ID tim yang akan jadi reviewer:
gh api orgs/org-kamu/teams/release-managers --jq .id
# misal keluarannya: 4821093
Lalu buat atau perbarui environment-nya:
gh api \
--method PUT \
-H "Accept: application/vnd.github+json" \
/repos/org-kamu/nama-repo/environments/production \
-f 'reviewers[][type]=Team' \
-F 'reviewers[][id]=4821093' \
-F 'prevent_self_review=true' \
-F 'deployment_branch_policy[protected_branches]=false' \
-F 'deployment_branch_policy[custom_branch_policies]=true'
# daftarkan main sebagai satu-satunya branch yang boleh deploy
gh api \
--method POST \
/repos/org-kamu/nama-repo/environments/production/deployment-branch-policies \
-f name=main -f type=branch
Kalau lebih nyaman dengan file JSON daripada argumen inline:
// environment-production.json
{
"reviewers": [{ "type": "Team", "id": 4821093 }],
"prevent_self_review": true,
"deployment_branch_policy": {
"protected_branches": false,
"custom_branch_policies": true
}
}
gh api --method PUT /repos/org-kamu/nama-repo/environments/production --input environment-production.json
Policy untuk main tetap didaftarkan lewat endpoint deployment-branch-policies seperti di atas.
Artinya setelah ini:
- Required reviewers: setiap job yang memakai
environment: productionakan berhenti di tengah jalan dan menunggu approval dari salah satu anggota timrelease-managers, persis seperti approval gate manual di pipeline CI/CD lain. prevent_self_review: true: orang yang memicu deploy tidak bisa menyetujui deploy-nya sendiri. Tanpa ini, tim release satu orang bisa meng-approve dirinya sendiri dan gerbang itu hanya formalitas. Kalau tim Anda memang cuma berdua, pastikan reviewer-nya bukan hanya pemicu run.- Deployment branch policy dengan
custom_branch_policies: truedan satu policymain: deploy hanya bisa darimain. Saya sengaja tidak memakai opsi “Protected branches” karena GitHub mengaitkannya dengan branch protection klasik, jadi repo yang hanya memakai ruleset belum tentu terhitung. Pola eksplisit lebih bisa ditebak.
Workflow deploy-nya sendiri tetap sederhana, cukup menunjuk environment yang sudah diberi proteksi:
# .github/workflows/deploy-production.yml
name: Deploy Production
on:
push:
branches: [main]
permissions:
contents: read
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
steps:
- uses: actions/checkout@v4
- name: Deploy
run: ./scripts/deploy.sh
Perhatikan: workflow deploy ini tidak punya pengecekan freeze sendiri. Freeze ditegakkan di merge lewat freeze-guard, dan di deploy hanya oleh manusia: reviewer environment wajib membuka kalender sebelum menekan approve. Push ke main yang lolos merge sebelum freeze dimulai juga tetap memicu run, jadi reviewer boleh menolak run itu selama jendela freeze.
Ruleset Branch main: Kunci Kedua di Level Repo
Ruleset adalah pengganti branch protection klasik yang lebih fleksibel, dan untuk change freeze ia berperan sebagai gerbang pertama: tidak ada kode yang masuk ke main tanpa review dan tanpa status check freeze-guard berwarna hijau.
Buat lewat REST API, supaya konfigurasinya tersimpan sebagai file dan bisa di-review seperti kode lain:
// ruleset-main.json
{
"name": "main-protected",
"target": "branch",
"enforcement": "active",
"conditions": {
"ref_name": {
"include": ["~DEFAULT_BRANCH"],
"exclude": []
}
},
"rules": [
{ "type": "deletion" },
{ "type": "non_fast_forward" },
{
"type": "pull_request",
"parameters": {
"required_approving_review_count": 1,
"require_code_owner_review": true,
"dismiss_stale_reviews_on_push": true,
"required_review_thread_resolution": true
}
},
{
"type": "required_status_checks",
"parameters": {
"required_status_checks": [{ "context": "freeze-guard" }],
"strict_required_status_checks_policy": true
}
}
],
"bypass_actors": []
}
gh api \
--method POST \
-H "Accept: application/vnd.github+json" \
/repos/org-kamu/nama-repo/rulesets \
--input ruleset-main.json
Yang perlu Anda perhatikan sebelum menyalin konfigurasi ini:
"context": "freeze-guard"harus sama persis dengan id job di workflow pada bagian berikutnya. GitHub mencocokkan nama ini dengan hasil check yang dikirim job Actions, dan kalau tidak persis sama, ruleset tidak akan pernah menemukan check yang dimaksud, lalu PR menggantung menunggu status check yang tidak pernah muncul."bypass_actors": []sengaja dikosongkan. Jangan beri tim mana pun jalan untuk melewati ruleset ini secara rutin, karena begitu ada bypass yang dipakai untuk kenyamanan, ruleset berhenti berarti apa-apa saat freeze. Konsekuensinya, kalaufreeze-guardsendiri rusak, merge ikut macet. Jalur break-glass-nya: sementara ubahenforcementruleset menjadidisabledlewat PUT oleh admin repo (tercatat di audit log), atau isibypass_actorsdengan satu tim kecil bermodepull_request. Apa pun pilihannya, tulis di insiden siapa yang memakainya, kapan, dan kembalikan keactivebegitu selesai.- Opsi yang sama bisa diklik manual lewat Settings → Rules → Rulesets → New ruleset kalau tim Anda lebih nyaman memverifikasi lewat UI terlebih dulu sebelum menyimpannya sebagai file konfigurasi.
Job GitHub Actions: Freeze Guard yang Membaca Kalender dan Label Hotfix
Inilah status check freeze-guard yang namanya dirujuk ruleset di atas. Ia membaca freeze-calendar.yml, mencocokkan waktu sekarang dengan jendela freeze, lalu memutuskan: lolos, atau diblokir kecuali PR berlabel hotfix dan mencantumkan referensi insiden di deskripsinya.
# .github/workflows/freeze-guard.yml
name: Freeze Guard
on:
pull_request:
types: [opened, synchronize, reopened, labeled, unlabeled, edited]
branches: [main]
permissions:
contents: read
pull-requests: read
jobs:
freeze-guard:
name: freeze-guard
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22
- run: npm install --no-save yaml
- name: Cek jendela freeze
env:
GH_TOKEN: ${{ github.token }}
REPO: ${{ github.repository }}
PR_NUMBER: ${{ github.event.pull_request.number }}
PR_LABELS: ${{ toJSON(github.event.pull_request.labels) }}
PR_BODY: ${{ github.event.pull_request.body }}
run: node scripts/freeze-guard.mjs
Dan skrip intinya:
// scripts/freeze-guard.mjs
import { readFileSync } from 'node:fs';
import { parse } from 'yaml';
const CALENDAR_PATH = '.github/freeze-calendar.yml';
const HOTFIX_LABEL = 'hotfix';
const INCIDENT_PATTERN = /(insiden|incident)[:\s]*#?\d+/i;
const calendar = parse(readFileSync(CALENDAR_PATH, 'utf8'));
const freezes = calendar?.freezes ?? [];
const now = new Date();
const active = freezes.find((f) => {
const start = new Date(f.start);
const end = new Date(f.end);
return now >= start && now <= end;
});
// PR yang hanya menyentuh file kalender dikecualikan, supaya freeze
// bisa dicabut lebih awal lewat PR tanpa label hotfix palsu.
const filesRes = await fetch(
`https://api.github.com/repos/${process.env.REPO}/pulls/${process.env.PR_NUMBER}/files?per_page=100`,
{ headers: { Authorization: `Bearer ${process.env.GH_TOKEN}`, Accept: 'application/vnd.github+json' } },
);
if (!filesRes.ok) {
console.error(`Gagal membaca daftar file PR (HTTP ${filesRes.status}).`);
process.exit(1);
}
const changed = (await filesRes.json()).map((f) => f.filename);
const calendarOnly = changed.length > 0 && changed.every((f) => f === CALENDAR_PATH);
if (!active) {
console.log('Tidak ada freeze window aktif. Deploy diizinkan.');
process.exit(0);
}
console.log(`Freeze window aktif: "${active.name}" (${active.start} s/d ${active.end})`);
console.log(`Alasan: ${active.reason}. Dibuka oleh: ${active.opened_by}`);
let labelObjs = [];
try {
labelObjs = JSON.parse(process.env.PR_LABELS ?? '[]');
} catch {
labelObjs = [];
}
const labels = labelObjs.map((l) => l.name);
const isHotfix = labels.includes(HOTFIX_LABEL);
if (calendarOnly) {
console.log('PR hanya mengubah kalender freeze. Dikecualikan; approval code owner tetap wajib.');
process.exit(0);
}
if (!isHotfix) {
console.error(
`PR ini diblokir oleh change freeze "${active.name}". ` +
`Beri label "${HOTFIX_LABEL}" kalau perubahan ini benar-benar darurat, ` +
`dan cantumkan referensi insiden di deskripsi PR.`,
);
process.exit(1);
}
const body = process.env.PR_BODY ?? '';
if (!INCIDENT_PATTERN.test(body)) {
console.error(
`Label "${HOTFIX_LABEL}" sudah ada, tapi deskripsi PR belum mencantumkan referensi insiden ` +
`(contoh: "Insiden: #482"). Lengkapi dulu supaya jalur darurat ini tercatat.`,
);
process.exit(1);
}
console.log('Lolos sebagai hotfix dengan referensi insiden yang valid. Merge diizinkan.');
process.exit(0);
Beberapa keputusan yang sengaja saya pilih di skrip ini:
- Trigger mencakup
labeled,unlabeled, danedited. Tanpa ini, seseorang bisa menambah labelhotfixatau melengkapi deskripsi PR setelah check pertama gagal, tapi status check-nya tidak pernah dijalankan ulang, dan PR menggantung di status merah yang sudah kedaluwarsa. - Waktu sekarang dibandingkan di server GitHub Actions, bukan di mesin lokal kontributor. Jadi tidak ada celah “laptop saya zona waktunya beda” yang mengakali freeze.
- Nama job di workflow (
freeze-guard) sama persis dengan"context"di ruleset. Saya sengaja menulis dua kali di artikel ini supaya Anda tidak lupa menyamakannya saat menyalin. - PR yang hanya mengubah
freeze-calendar.ymldikecualikan. Tanpa ini PR pencabut freeze akan diblokir oleh freeze yang ingin dicabutnya. Pengecualiannya sempit (hanya satu file) dan file itu dijaga CODEOWNERS. - PR dari fork tetap aman dijalankan, karena job ini hanya butuh
contents: readdanpull-requests: read, tidak pernah menyentuh secrets atau token write.
Jalur Darurat: Hotfix Saat Code Freeze, Dicatat Bukan Dibisikkan
Hotfix saat code freeze tetap lewat PR biasa, bukan jalur pintas yang melompati review. Yang berubah hanya dua hal: label hotfix menonaktifkan blokir freeze-guard, dan deskripsi PR wajib menyebut referensi insiden supaya jalur darurat ini bisa dilacak kembali nanti, mirip prinsip yang saya pakai untuk runbook incident response tim kecil: setiap keputusan darurat harus meninggalkan jejak tertulis, bukan hanya diingat orang yang menanganinya.
Review dari CODEOWNERS, resolusi semua thread komentar, dan status check lain yang Anda daftarkan di ruleset tetap wajib berjalan. Satu-satunya yang dilonggarkan oleh label hotfix adalah blokir freeze itu sendiri, bukan standar kualitas kode.
Setelah PR ter-merge, gerbang terakhir ada di environment production: required reviewers dari tim release-managers tetap harus meng-approve run deployment-nya secara manual, lewat halaman Actions → run yang menunggu → Review deployments. Di titik inilah mereka benar-benar memutuskan, dengan konteks penuh dari deskripsi PR dan dashboard yang sedang mereka pantau, apakah hotfix ini layak dijalankan sekarang atau bisa menunggu beberapa jam lagi sampai trafik lebih tenang.
Siapa Boleh Membuka Freeze, dan Kapan Dicabut
Supaya tidak ada ambiguitas, saya samakan tiga peran ke satu tim yang sama, yaitu release-managers:
- Membuka atau memperpanjang freeze: lewat PR yang mengubah
freeze-calendar.yml, dan karena file ini ada di CODEOWNERS, PR tersebut butuh approval dari tim ini sendiri. - Mengizinkan hotfix saat freeze: secara teknis siapa pun dengan akses write bisa memberi label
hotfix, tapi review wajib dari CODEOWNERS di ruleset tetap melibatkan tim ini sebelum PR bisa merge. - Mengeksekusi deployment selama freeze: lewat required reviewers di environment
production, yang anggotanya sama dengan tim ini.
Freeze dicabut dengan dua cara, dan keduanya tercatat:
- Otomatis, saat waktu sekarang melewati
enddifreeze-calendar.yml. Tidak perlu ada yang mengubah apa pun;freeze-guardberhenti memblokir dengan sendirinya mulai detik itu. - Manual lebih awal, lewat PR yang hanya mengubah nilai
endatau menghapus entri freeze-nya, direview seperti perubahan kode lain dan lolosfreeze-guardberkat pengecualian file kalender. Ini memberi jejak git yang jelas: siapa yang memutuskan mencabut freeze lebih awal, kapan, dan apa alasannya di deskripsi PR.
Tidak ada jalur ketiga. Kalau seseorang bertanya “boleh deploy sekarang nggak”, jawabannya selalu merujuk ke isi freeze-calendar.yml dan status environment, bukan ke siapa yang kebetulan sedang online di grup chat.
Checklist Weekend Menjelang 11.11 Ini
- Commit
freeze-calendar.ymldengan jendela waktu 11.11 Anda sendiri, lengkap denganreasondanopened_by. - Tambahkan baris CODEOWNERS untuk file kalender itu, arahkan ke tim yang berwenang membuka dan menutup freeze.
- Pasang
freeze-guard.ymldanscripts/freeze-guard.mjs, lalu pastikan nama job-nyafreeze-guardpersis. - Terapkan ruleset
main-protectedlewatgh api, dengan"context": "freeze-guard"sebagai status check wajib. - Pasang required reviewers,
prevent_self_review, dan custom branch policymaindi environmentproduction. - Siapkan label
hotfixdi repo, dan sepakati pola referensi insiden yang wajib dicantumkan di deskripsi PR. - Uji sekali di akhir pekan ini juga: buka PR percobaan tanpa label, pastikan
freeze-guardmenolaknya, lalu beri labelhotfixdengan referensi insiden palsu dan pastikan ia lolos.
Freeze yang baik bukan freeze yang tidak pernah ditembus sama sekali, tapi freeze yang setiap kali ditembus meninggalkan jejak jelas: siapa, kapan, dan kenapa. Selamat menikmati akhir pekan terakhir sebelum 11.11. Fitur yang hampir selesai itu akan tetap ada Kamis pagi, 12 November, setelah freeze dicabut.
Ditulis oleh Ayu Pratiwi