Kembali ke daftar artikel

· 1 menit baca

CMS git-based di Cloudflare Pages tanpa database

Cara menyusun alur penyuntingan yang ramah tim non-teknis di atas Astro, Decap CMS, dan GitHub — plus jebakan OAuth proxy yang sering membuat login gagal.

Situs statis punya satu kelemahan klasik: siapa yang mengubah teksnya? Kalau jawabannya “pengembang lewat pull request”, biaya koordinasi akan lebih besar daripada biaya hostingnya.

Pola yang dipakai

Konten tetap berupa berkas Markdown di repositori. Yang ditambahkan hanyalah dua hal:

  1. Panel editor (Decap CMS) yang dimuat dari CDN dan berbicara ke GitHub API.
  2. OAuth proxy kecil di Cloudflare Worker, karena GitHub tidak mengizinkan alur OAuth langsung dari browser tanpa rahasia klien.

Alurnya sederhana: editor menyimpan artikel → Decap membuat commit ke main → Cloudflare Pages membangun ulang → halaman baru tayang dalam satu menit.

Tiga jebakan yang nyata

Pertama, callback URL harus persis. Satu karakter berbeda pada callback di aplikasi OAuth GitHub akan menghasilkan pesan redirect_uri_mismatch yang tidak menjelaskan apa pun.

Kedua, base_url di config.yml bukan URL situs. Isinya URL Worker proxy, bukan domain website. Salah isi di sini adalah penyebab paling umum layar login yang berputar tanpa akhir.

Ketiga, CSP bisa memblokir CMS. Panel admin memuat skrip dari unpkg.com dan berbicara ke api.github.com. Kalau header keamanan terlalu ketat, panel tampil kosong tanpa pesan kesalahan yang jelas — cukup buka konsol untuk memastikan.

Kapan pola ini tidak cocok

Kalau konten perlu diproses (harga dinamis, stok, komentar), situs statis bukan pilihan pertama. Untuk konten editorial yang berubah beberapa kali seminggu, pola ini sulit dikalahkan: tidak ada basis data, tidak ada biaya server, dan riwayat perubahan gratis.