Cloudflare Pages: Pengertian, Cara Kerja, hingga Custom Domain

Pernah merasa proses deploy website statis justru lebih melelahkan daripada membuat websitenya sendiri? Mulai dari upload file, setup SSL, konfigurasi build, sampai deploy berulang sering kali membuat workflow terasa ribet dan memakan waktu. Di sinilah Cloudflare Pages adalah solusi yang mulai banyak dipilih karena menawarkan proses deployment yang jauh lebih praktis dan modern.

Cukup hubungkan repository Git, lalu setiap push dapat otomatis di-build dan di-deploy ke jaringan global Cloudflare. Platform ini juga mendukung preview URL, rollback, hingga fitur dinamis lewat Pages Functions. Kalau ingin memahami cara kerjanya tanpa penjelasan yang terlalu teknis, pastikan baca artikel ini sampai selesai.

Ringkasan Cepat

• Cloudflare Pages adalah platform untuk membuat aplikasi full-stack yang langsung dideploy ke jaringan global Cloudflare.
• Deploy bisa lewat Git integration, direct upload, atau CLI (C3).
• Build configuration ditentukan oleh build command + output directory, dan ada preset untuk framework populer.
• Custom domain bisa apex/subdomain dengan aturan DNS tertentu.
• Redirects bisa diatur lewat file _redirects, tetapi ada batasan khusus jika Anda memakai Pages Functions.

Apa itu Cloudflare Pages?

Cloudflare Pages adalah platform deployment berbasis workflow modern (Git, build, deploy) yang cocok untuk website statis dan aplikasi dengan kebutuhan dinamis ringan, tanpa Anda mengelola server.

Cloudflare Pages memungkinkan Anda membuat aplikasi full-stack yang “instantly deployed to the Cloudflare global network”.

Bedanya dengan hosting tradisional (shared hosting/VPS) biasanya terasa di:

• Anda tidak login server untuk deploy.
• Anda jarang mengurus patching, SSL, dan banyak konfigurasi server.
• Anda mengikuti pipeline build/deploy yang konsisten.

Namun, konsekuensinya: Anda menyesuaikan arsitektur aplikasi ke cara kerja Pages (terutama bila butuh backend yang kompleks).

Cara kerja Cloudflare Pages

Cloudflare Pages bekerja dengan mengambil kode dari repository Git atau file yang Anda upload, lalu menjalankan proses build (jika diperlukan) dan mendistribusikan hasil akhirnya ke jaringan global Cloudflare.

Secara umum, alur kerjanya cukup sederhana:

1. Siapkan repository project
2. Hubungkan repository ke Cloudflare Pages
3. Tentukan framework dan build configuration
4. Jalankan deploy
5. Push berikutnya akan auto-deploy

Beberapa hal yang membuat workflow ini terasa nyaman digunakan antara lain:

• Reproducible, sehingga siapa pun di dalam tim dapat melakukan push dengan hasil deploy yang tetap konsisten
• Preview URL memudahkan proses review perubahan sebelum masuk ke lingkungan produksi

Cara deploy di Cloudflare Pages: Git Integration, Direct Upload, atau CLI?

Cloudflare Pages menyediakan beberapa metode deployment yang bisa dipilih sesuai kebutuhan workflow. Secara umum, tersedia tiga opsi utama yaitu menghubungkan repository Git, melakukan direct upload aset hasil build, atau menggunakan CLI seperti C3.

Setiap pendekatan memiliki kegunaan yang berbeda. Oleh karena itu, pilihan terbaik biasanya bergantung pada bagaimana proses development dan deployment dijalankan di dalam tim.

Kapan pilih Git integration?

Git integration paling cocok untuk workflow tim dan proses CI/CD otomatis karena deployment dapat berjalan langsung setiap kali ada perubahan pada repository.

Pendekatan ini biasanya lebih ideal jika:

• Bekerja dalam tim dengan workflow branch dan pull request
• Ingin proses deploy otomatis setiap kali melakukan push
• Membutuhkan proses review perubahan yang lebih rapi melalui preview deployment

Dengan sistem seperti ini, alur deployment terasa lebih konsisten dan mudah dipantau.

Kapan pilih direct upload/CLI?

Sementara itu, direct upload atau deployment lewat CLI lebih cocok untuk kebutuhan yang lebih fleksibel atau pipeline yang sudah dibangun sendiri.

Pendekatan ini biasanya dipilih jika:

• Sudah memiliki pipeline build internal sendiri
• Hanya ingin mengunggah hasil akhir berupa folder build
• Membutuhkan proses deployment yang lebih manual dan terkontrol

Metode ini sering digunakan ketika proses build tidak dijalankan langsung di Cloudflare Pages, tetapi di lingkungan lain yang sudah disesuaikan dengan kebutuhan proyek.

Memahami build configuration di Cloudflare Pages

Agar proses deployment berjalan dengan benar, Cloudflare Pages perlu mengetahui beberapa hal penting seperti perintah build, folder output hasil build, dan root directory jika repository menggunakan struktur monorepo.

Secara umum, ada tiga komponen utama yang perlu dipahami.

1. Build Command

Build command adalah perintah yang digunakan untuk menjalankan proses build project.

Biasanya, perintah ini sudah mengikuti standar dari framework yang digunakan. Cloudflare Pages akan menentukan apakah proses build berhasil atau gagal berdasarkan exit code:

• Exit code 0 berarti proses berhasil
• Non-zero exit code berarti proses gagal

Karena itu, kesalahan kecil pada konfigurasi atau dependency sering kali langsung membuat deployment berhenti di tahap ini.

2. Build Output Directory

Bagian ini menentukan folder tempat hasil akhir build disimpan.

Beberapa framework memiliki folder default yang berbeda, misalnya:

• Astro menggunakan dist
• Hugo menggunakan public

Cloudflare juga menyediakan preset konfigurasi untuk banyak framework, sehingga proses setup biasanya menjadi lebih mudah.

3. Root Directory

Secara default, root directory menggunakan folder utama repository.

Namun, jika project menggunakan struktur monorepo, bagian ini perlu diatur secara manual agar Pages tahu folder mana yang harus dijalankan sebagai project utama.

Pengaturan ini sering terlihat sederhana, tetapi cukup sering menjadi penyebab deployment gagal ketika struktur repository mulai kompleks.

Pro tip dari tim: sebagian besar masalah deployment biasanya bukan karena kode aplikasinya, tetapi karena konfigurasi build command, folder output, atau root directory yang tidak sesuai.

Fitur penting Cloudflare Pages yang sering dipakai

Pages menawarkan fungsi dinamis ringan, rollback cepat, dan konfigurasi routing seperti redirects, yang membuatnya lebih dari sekadar hosting statis.

Beberapa fitur yang paling terasa dalam workflow modern:

• Pages Functions: memungkinkan Anda menjalankan server-side code tanpa perlu server dedicated
• Rollbacks: memudahkan revert ke deployment sebelumnya jika terjadi masalah
• Redirects: membantu mengatur perpindahan URL dan routing dengan lebih rapi
• Preview URL: memungkinkan perubahan dicek sebelum masuk production
• Branch environment dan staging: membantu workflow testing dan kolaborasi tim

Kombinasi fitur ini membuat proses deploy, testing, dan maintenance website terasa jauh lebih praktis dibanding workflow manual tradisional.

Custom domain di Cloudflare Pages

Menghubungkan domain ke Cloudflare Pages terdengar simpel tapi ada satu perbedaan penting yang perlu Anda pahami sejak awal, yaitu apex domain dan subdomain dikonfigurasi dengan cara yang berbeda.

• Untuk apex domain (contoh example.com), Anda perlu menambahkan site sebagai Cloudflare zone dan mengarahkan nameserver ke Cloudflare.
• Untuk subdomain, Anda bisa menggunakan CNAME record yang mengarah ke <YOUR_SITE>.pages.dev.

Catatan penting yang sering jadi jebakan:

Ini salah satu hal yang paling sering membuat proses custom domain membingungkan. Hindari langsung menambahkan CNAME record secara manual tanpa mengasosiasikan domain terlebih dahulu melalui dashboard Cloudflare Pages.

Jika DNS langsung diatur tanpa melewati proses tersebut, domain bisa gagal resolve dan menampilkan error 522 tanpa pesan yang benar benar menjelaskan penyebabnya.

Dengan demikian, langkah yang lebih aman adalah menambahkan domain terlebih dahulu dari dashboard Pages, baru setelah itu melanjutkan pengaturan DNS jika memang diperlukan.

Redirects di Pages

Redirects di Pages diatur melalui file _redirects di folder aset statis/output build, tetapi redirect ini tidak berlaku untuk request yang diserve oleh Pages Functions.

Cloudflare Pages docs menjelaskan:

• Buat file bernama _redirects (tanpa ekstensi) di static asset directory.
• File ini diparse Pages dan rules diterapkan.
• Format satu rule per baris: [source] [destination] [code?].
• Ada limit jumlah redirect (2,000 static + 100 dynamic, total 2,100) dan limit karakter per deklarasi.

Peringatan penting:

Redirects di _redirects tidak diterapkan pada request yang diserve oleh Pages Functions. Jika Anda memakai Functions, perilaku tersebut harus dipindah ke code di route /functions yang sesuai, atau mengecualikan route dari Functions.

Ini bagian yang sering bikin bingung pemula: “Saya sudah bikin redirect tapi tidak jalan”, ternyata request-nya ditangani Functions.

Kelebihan dan kekurangan Cloudflare Pages

Cloudflare Pages unggul untuk kecepatan deploy dan distribusi global, tetapi ada batasan runtime dan limit plan yang harus Anda perhitungkan.

Kelebihan yang paling terasa:

• Workflow Git yang rapi
• Deploy cepat
• Rollback tersedia
• Cocok untuk JAMstack

Kekurangannya, yaitu:

• Limit tertentu tergantung plan (Cloudflare punya dokumentasi limit)
• Beberapa hal dinamis lebih cocok di backend terpisah
• Jika kebutuhan server Anda kompleks, Pages bisa jadi “tidak cukup”

Beberapa keterbatasan seperti runtime/API tertentu, concurrency terbatas di free tier, dan dashboard yang terasa terfragmentasi untuk pengguna baru.

CloudFlare Pages cocok untuk siapa?

Cloudflare Pages paling cocok digunakan untuk website dan aplikasi yang mayoritas bersifat statis, tetapi tetap membutuhkan sedikit fitur dinamis yang ringan melalui Functions.

Karena workflow deployment dan infrastrukturnya cukup praktis, platform ini sering dipilih untuk kebutuhan yang fokus pada kecepatan, kemudahan deploy, dan distribusi global.

Beberapa use case yang paling cocok antara lain:

• Blog dan dokumentasi
• Landing page campaign
• Portfolio
• SPA/SSG dari framework populer
• Aplikasi yang butuh endpoint ringan via Functions

Namun, ada juga beberapa kebutuhan yang biasanya lebih masuk akal dijalankan di VPS atau server tradisional karena memerlukan kontrol sistem yang lebih besar.

Contohnya seperti:

• Backend API kompleks
• Workload lama (long-running)
• Kebutuhan custom runtime dan dependency sistem

Tabel: kebutuhan proyek → rekomendasi

Checklist sebelum memilih Cloudflare Pages

Sebelum benar benar menggunakan Cloudflare Pages, pastikan terlebih dahulu bahwa framework, output build, domain, dan strategi routing yang digunakan memang cocok dengan model deployment di Pages.

Berikut beberapa checklist yang sebaiknya diperiksa:

• Project memiliki output statis yang jelas beserta folder hasil build
• Build command berjalan bersih tanpa error dan menghasilkan exit code 0
• Jika menggunakan struktur monorepo, root directory sudah diarahkan dengan benar
• Strategi custom domain sudah ditentukan, apakah menggunakan apex domain atau subdomain
• Aturan redirect sudah dipikirkan, apakah menggunakan _redirects atau Functions

Pro tip dari tim: coba lakukan simulasi deployment pertama menggunakan repository dummy yang sederhana. Cara ini membantu memahami pola build dan output Pages sebelum memindahkan project yang benar benar penting.

Kapan proyek lebih cocok pakai VPS?

Cloudflare Pages adalah salah satu layanan yang sangat baik untuk website statis dan aplikasi dengan kebutuhan dinamis yang ringan. Namun, ketika proyek mulai membutuhkan API yang kompleks, custom runtime, atau pengelolaan database secara mandiri, kontrol penuh dari server sendiri biasanya menjadi kebutuhan yang tidak bisa dihindari.

Dalam situasi seperti ini, VPS sering menjadi pilihan yang lebih masuk akal karena memberikan fleksibilitas lebih besar untuk mengatur arsitektur aplikasi, dependency sistem, dan kebutuhan backend yang lebih kompleks.

Untuk kebutuhan infrastruktur yang lebih fleksibel dan stabil, VPS Indonesia dari Rumahweb bisa menjadi solusi yang relevan. Dengan kontrol server yang lebih leluasa, Anda dapat menjalankan aplikasi dan workload yang lebih berat secara lebih profesional sesuai kebutuhan proyek yang terus berkembang.

FAQ

Kesimpulan

Cloudflare Pages adalah platform deployment yang memudahkan workflow modern: connect repo, build, deploy, dan distribusikan ke jaringan global. Dengan build configuration yang jelas, dukungan custom domain, dan fitur seperti redirects dan rollbacks, Pages cocok untuk banyak proyek JAMstack.

Namun Pages bukan jawaban untuk semua hal. Jika kebutuhan backend Anda kompleks dan butuh kontrol penuh runtime, VPS atau arsitektur hybrid lebih masuk akal. Kunci memilihnya adalah jujur pada kebutuhan proyek: statis dominan atau server dominan.

Referensi

• Cloudflare Pages docs
• Build configuration
• Custom domains
• Redirects