Meja kerja pembangun dengan aliran deploy Git ke Cloudflare

Ilustrasi editorial; gambar mewakili aliran kerja pembangunan daripada repositori Git ke pelayan tepi Cloudflare.

Lama juga saya mengurus blog peribadi di atas CMS tradisional—kemas kini pemalam hampir setiap minggu, pelayan VPS yang sesekali penuh ruang cakera sebab fail log, dan bot spam yang tidak pernah penat menghentam borang hubungi. Untuk laman peribadi dan nota teknikal, beban penyelenggaraan itu sebenarnya tidak berbaloi.

Sekarang, susunan yang saya gunakan jauh lebih ringkas: artikel ditulis dalam fail Markdown biasa, dibina menjadi HTML statik ke dalam folder _site/, dan dihoskan terus melalui Cloudflare Workers Assets. Borang hubungi pula tidak memerlukan pelayan PHP atau pangkalan data berasingan—ia diproses oleh fungsi Worker yang menyimpan mesej ke dalam pangkalan data SQL Cloudflare D1 selepas disahkan oleh Cloudflare Turnstile. Kos operasinya hampir sifar, tiada pangkalan data berat untuk laman membaca artikel, dan setiap perubahan ada sejarah Git.

Persediaan akaun dan persekitaran kerja tempatan

Langkah pertama ialah menyediakan akaun Cloudflare dan GitHub. Sahkan alamat e-mel kedua-duanya dan aktifkan pengesahan pelbagai faktor (MFA) lebih awal—anda boleh ikut 10 semakan sebelum mengaktifkan MFA supaya kod pemulihan disimpan dengan betul sebelum anda mengunci akaun sendiri.

Di komputer, pastikan Git dan Node.js versi LTS sudah dipasang:

git --version
node --version
npm --version

Satu tip praktikal untuk pengguna Windows dan macOS: letakkan folder projek di luar direktori yang disegerakkan secara agresif oleh OneDrive, Google Drive atau iCloud. Folder node_modules/ dan _site/ mengandungi ribuan fail kecil yang mudah mencetuskan konflik fail terkunci semasa skrip binaan berjalan.

Selepas membuat repositori kosong di GitHub, tetapkan identiti Git tempatan anda dan pastikan .gitignore menyenaraikan node_modules/, _site/, .wrangler/ serta .dev.vars*. Jangan sesekali menyimpan token API atau kunci rahsia di dalam repositori; rujuk juga panduan mengelakkan pendedahan kunci API di pelayar web untuk memahami sempadan antara kunci awam dan rahsia.

Struktur projek dan sempadan fail sumber

Sebelum menyentuh sebarang fail, fahamkan apa yang anda sunting dan apa yang dijana oleh komputer:

  • index.html dan assets/: Halaman utama laman, gaya CSS, skrip pelayar, serta imej artikel di bawah assets/blog/.
  • blog-src/post/ dan blog-src/posts/: Fail sumber artikel dalam format Markdown beserta metadata frontmatter.
  • scripts/build-blog.mjs: Skrip Node.js yang menyemak frontmatter, mengesahkan laluan imej tempatan dan teks alt, lalu menjana HTML statik ke _site/, suapan RSS (/blog/feed.xml) dan sitemap.xml.
  • worker.js dan wrangler.jsonc: Pengendali Cloudflare Worker yang menghalakan permintaan /api/contact ke fungsi borang dan permintaan lain ke env.ASSETS.fetch(request).

Peraturan paling penting di sini: sunting fail sumber sahaja. Jangan ubah HTML di dalam blog/ atau _site/ secara terus kerana setiap kali npm run build dijalankan, folder output itu akan dibersihkan dan ditulis semula dari awal.

Setiap artikel baharu disimpan mengikut format YYYY-MM-DD-slug-artikel.md di dalam blog-src/post/YYYY/MM/. Lengkapkan frontmatter YAML dengan title, date, lang (ms atau en), description dan tags, serta pastikan setiap artikel mempunyai sekurang-kurangnya satu imej tempatan di bawah /assets/blog/ dengan teks alt yang jelas. Sebelum menerbitkan artikel, anda boleh semak semula dengan senarai 10 semakan editorial dan teknikal sebelum menerbitkan artikel laman web.

Untuk menguji hasil binaan di komputer, pasang kebergantungan dan jalankan skrip binaan:

npm install
npm run build

Jika terdapat imej yang hilang, teks alt kosong atau sintaks frontmatter yang rosak, npm run build akan terus gagal dan memaparkan ralatnya di terminal—jauh lebih baik daripada menyedari halaman rosak selepas laman sudah live.

Mengkonfigurasi Worker, pangkalan data D1 dan Turnstile

Dalam wrangler.jsonc, pastikan main menunjuk ke ./worker.js dan assets.directory menunjuk ke ./_site. Log masuk ke Cloudflare melalui CLI Wrangler untuk menguji pelayan tempatan:

npx wrangler login
npx wrangler dev

Untuk menyimpan mesej daripada borang hubungi tanpa bergantung pada e-mel semata-mata, cipta pangkalan data D1 dan ikat namanya sebagai DB di dalam wrangler.jsonc:

npx wrangler d1 create mzulkamal-contact

Salin database_id yang keluar ke dalam blok d1_databases pada wrangler.jsonc, kemudian jalankan fail skema SQL (schema.sql) untuk kedua-dua persekitaran tempatan dan produksi:

npx wrangler d1 execute mzulkamal-contact --local --file=./schema.sql
npx wrangler d1 execute mzulkamal-contact --remote --file=./schema.sql

Seterusnya, hasilkan widget Cloudflare Turnstile di papan pemuka Cloudflare. Letakkan site key awam pada elemen borang di index.html, manakala secret key pula disimpan sebagai rahsia Worker menggunakan CLI—bukan ditulis di dalam wrangler.jsonc:

npx wrangler secret put TURNSTILE_SECRET_KEY

Di dalam worker.js, pastikan setiap permintaan POST /api/contact menghantar token borang ke titik akhir https://challenges.cloudflare.com/turnstile/v0/siteverify bersama env.TURNSTILE_SECRET_KEY sebelum memasukkan baris baharu ke dalam D1. Tanpa semakan di sebelah pelayan (server-side), bot masih boleh menghantar permintaan terus ke API anda tanpa mempedulikan widget di pelayar. Untuk lapisan pertahanan tambahan seperti had kadar (rate limiting), rujuk panduan berlapis menghentikan spam borang hubungi.

Auto-deploy melalui GitHub dan sambungan domain tersuai

Apabila binaan dan ujian npx wrangler dev berjalan lancar, semak git status dan git diff untuk memastikan tiada fail sensitif seperti .dev.vars termasuk, kemudian tolak kod ke GitHub:

git add .
git commit -m "Sediakan konfigurasi blog, Worker dan borang D1"
git push -u origin main

Di papan pemuka Cloudflare (Workers & Pages → Settings → Builds), sambungkan repositori GitHub anda dengan tetapan berikut:

  • Production branch: main
  • Build command: npm run build
  • Deploy command: npx wrangler deploy

Selepas berjaya diterbitkan pada subdomain workers.dev, tambah Custom Domain di papan pemuka Worker dan kemas kini site.url di dalam scripts/build-blog.mjs supaya URL kanonikal, suapan RSS dan sitemap.xml menggunakan domain sebenar anda. Jika domain tersuai masih gagal dimuatkan selepas rekod DNS ditukar, semak punca biasa dalam panduan penyelesaian masalah DNS laman web.

Perangkap biasa yang selalu makan masa

Sepanjang mengurus susunan ini, ada empat kesilapan yang paling kerap menyebabkan kerja tertangguh:

  • Menyunting fail HTML di dalam _site/ atau blog/: Segala suntingan akan hilang sebaik sahaja npm run build berjalan di komputer atau di Cloudflare Builds.
  • Memasang widget Turnstile di HTML tanpa semakan siteverify di worker.js: Ini hanya menyekat pengguna jujur jika berlaku ralat UI, tetapi tidak menghalang skrip curl automatik.
  • Meletakkan TURNSTILE_SECRET_KEY di dalam wrangler.jsonc: Sebaik sahaja anda git push ke repositori awam, kunci itu dianggap terdedah. Sentiasa guna npx wrangler secret put untuk produksi dan .dev.vars untuk ujian tempatan.
  • Malas menjalankan npm run build sebelum git push: Menunggu 1–2 minit di Cloudflare Builds semata-mata untuk melihat ralat laluan imej yang salah membazir masa sedangkan ujian tempatan mengambil masa beberapa saat sahaja.

Apabila aliran ini sudah siap, kerja penerbitan harian menjadi sangat tenang: tulis Markdown, semak imej, jalankan npm run build, dan git push. Selebihnya diuruskan secara automatik di rangkaian tepi Cloudflare.

Sumber