SANGE Studio beralih ke Next.js: arsitektur dan tiga malam menuju rilis
Saya memigrasikan situs SANGE Studio dari HTML statis ke Next.js pada 11–13 November 2026, sekitar tiga sampai empat jam setiap hari setelah bekerja. URL lama dan konten dalam 12 bahasa tetap tersedia. Draf, pratinjau, dan penerbitan kini dikelola melalui peramban. Artikel ini menjelaskan arsitektur, layanan Cloudflare, dan urutan pekerjaan hingga rilis.
Saya memigrasikan situs SANGE Studio dari HTML statis ke Next.js pada 11–13 November 2026, sekitar tiga sampai empat jam setiap hari setelah bekerja. URL lama dan konten dalam 12 bahasa tetap tersedia. Draf, pratinjau, dan penerbitan kini dikelola melalui peramban. Artikel ini menjelaskan arsitektur, layanan Cloudflare, dan urutan pekerjaan hingga rilis.
Mengapa bermigrasi?
Situs sebelumnya menggunakan HTML, CSS, JavaScript, dan skrip Python untuk membuat halaman terlebih dahulu. Halaman aplikasi, dokumen hukum, dan blog sudah tersedia, tetapi perubahan artikel juga menuntut konsistensi daftar, terjemahan, dan peta situs. Dengan 12 bahasa, ada banyak hal yang perlu diperiksa.
Saya memisahkan data artikel dari proses pembuatan halaman dan memindahkan blog ke basis data. Alurnya: menulis, menyimpan draf, memeriksa tampilan, lalu menerbitkan.
Peran Next.js
Next.js adalah kerangka kerja untuk membuat aplikasi web dengan React. Di situs ini, Next.js menangani halaman publik dan antarmuka administrasi. Server mengambil data artikel lalu mengirim HTML berisi teksnya, yang disebut perenderan sisi server atau SSR. Pembaca memakai URL yang sama; penyunting mengelola draf dan status penerbitan alih-alih berkas HTML satu per satu.
Peran layanan Cloudflare
Cloudflare menyediakan distribusi dan perlindungan situs, lingkungan eksekusi aplikasi, serta penyimpanan. Empat layanan digunakan dengan tugas berbeda.
Workers: menjalankan program
Cloudflare Workers menjalankan kode di jaringan Cloudflare. Infrastruktur eksekusinya dikelola layanan, sehingga saya tidak perlu menyiapkan mesin server dan merawat sistem operasinya. Workers membaca artikel, membuat halaman, dan memproses permintaan penyunting.
D1: menyimpan artikel dan terjemahan
Cloudflare D1 adalah layanan basis data yang menyusun informasi dan mengambilnya berdasarkan kondisi. Judul, isi, bahasa, draf, versi terbit, dan riwayat disimpan di sini. Contohnya, mengambil artikel berbahasa Inggris yang telah terbit atau versi Jepang dari sebuah artikel.
R2: menyimpan gambar unggahan
Cloudflare R2 menyimpan berkas. D1 menyimpan informasi artikel, sedangkan R2 menyimpan gambar yang diunggah melalui panel. Gambar lama dan CSS tetap disajikan sebagai berkas statis.
Access: membatasi administrasi
Cloudflare Access mengatur siapa yang dapat masuk ke aplikasi web. Pembaca tidak perlu masuk, tetapi penyunting harus masuk. Aplikasi juga memvalidasi autentikasi dan keabsahan permintaan penyimpanan.
Hubungan antarkomponen
Gambar memakai bahasa Jepang. Pembaca menuju situs publik; administrator melewati Access. Keduanya memakai Workers yang terhubung dengan D1, R2, dan berkas statis.
Saat artikel dibuka, Workers mengambil teks terbit dari D1 dan mengembalikan halaman. Gambar berasal dari R2 atau berkas statis. Setelah masuk melalui Access, perubahan penyunting melewati Workers menuju D1.
OpenNext menyiapkan aplikasi Next.js agar berjalan di Workers. Tidak semua halaman masuk ke basis data: halaman aplikasi dan dokumen hukum memakai data hasil ekstraksi HTML lama dan tetap diperbarui melalui Git, sistem pengelolaan versi. Fokus penyuntingan berbasis peramban adalah blog.
Memisahkan draf dan versi terbit
Panel mendukung pembuatan artikel, draf, pratinjau, penerbitan, terjemahan, dan gambar. Menyimpan draf tidak mengubah teks yang dibaca pengunjung. Versi publik baru diganti saat diterbitkan setelah diperiksa.
Riwayat dipertahankan dan versi terdahulu dapat menjadi draf baru. Setiap bahasa memiliki draf dan status penerbitannya sendiri. Isi mendukung HTML dan Markdown, tampilan terformat untuk judul, gambar, dan tabel, penyuntingan sumber, serta pratinjau konten tersimpan.
Waktu pengerjaan
Pekerjaan berlangsung tiga hari, 11–13 November 2026, sekitar tiga sampai empat jam sepulang kerja setiap hari: total kira-kira sembilan sampai dua belas jam. Ini perkiraan, bukan hasil pengukuran waktu. Artikel, terjemahan, gambar, dan desain sudah tersedia; situs tidak dibangun dari nol. Waktu tiap tahap tidak dicatat terpisah.
| Tanggal | Pekerjaan utama |
|---|---|
| 11 November | Meninjau situs dan data multibahasa; merancang arsitektur |
| 12 November | Membuat halaman dan editor; pemeriksaan lokal |
| 13 November | Menyiapkan produksi, merilis, memisahkan administrasi, dan memverifikasi |
Delapan tahap menuju rilis
Gambar Jepang merangkum tahapan berikut.
1. Mendata situs lama
Saya memeriksa 300 URL publik, halaman 404 dalam 12 bahasa, dan tujuh artikel dengan 84 versi bahasa. URL, teks, gambar, dan metadata mesin pencari menjadi daftar pemeriksaan migrasi.
2. Merancang arsitektur dan data
D1 untuk artikel dan terjemahan, R2 untuk gambar baru, dan Workers untuk pemrosesan. Draf, versi terbit, riwayat, dan status per bahasa ditentukan, dengan penyimpanan terpisah dari penerbitan.
3. Menyiapkan lingkungan lokal
Docker Compose menyediakan lingkungan terpisah dari produksi. Docker menjalankan program beserta lingkungan yang dibutuhkannya. Saya dapat menguji penyimpanan dan unggahan tanpa mengubah artikel publik. Pengembangan dilakukan di Windows dan build produksi di Linux.
4. Membuat halaman dan fungsi
Konten diimpor dan tampilan, penyuntingan, serta penerbitan dibuat. Judul, gambar, tabel, dan halaman tiap bahasa dipertahankan. Tautan dan markah lama tetap berfungsi; URL pilihan bahasa lama diberi pengalihan.
5. Menguji dan memeriksa lingkungan validasi
Pengujian otomatis dan lingkungan terpisah mencakup penyimpanan, penerbitan, terjemahan, gambar, URL, bahasa, dan peta situs. Operasi tanpa izin harus ditolak, dan draf tidak boleh mengubah artikel terbit.
6. Menyiapkan produksi
D1 dan R2 produksi dipisahkan dari pengujian, artikel diimpor, dan Access dikonfigurasi. Autentikasi diperiksa pada build produksi sebelum rilis.
7. Mencadangkan dan beralih bertahap
Data dicadangkan dan konsistensinya diperiksa. Panel dihubungkan dan diuji terlebih dahulu, lalu situs publik dialihkan ke Worker baru. Konfigurasi lama tetap disimpan untuk pemulihan. Setelah itu, administrasi dipindahkan ke domain khusus.
8. Memeriksa URL sesungguhnya
Setelah peralihan, saya memeriksa halaman, 404 tiap bahasa, URL kanonis, peta situs, gambar, koneksi basis data, dan perlindungan administrasi. Node.js dan dependensi build kemudian diperbarui, dibangun ulang, diuji, dan diterapkan. Pemeriksaan kembali mencakup 300 URL dan 61 berkas statis.
Hasil dan hal yang masih perlu diukur
Blog kini dapat diedit melalui peramban tanpa kehilangan URL dan konten multibahasa. Draf, terjemahan, gambar, dan versi publik dikelola bersama. Dampak pada peringkat pencarian dan kecepatan masih perlu diukur: situs lama sudah mengirim teks artikel dalam HTML. Perubahan konkretnya ada pada alur penyuntingan dan pengelolaan data.
Infrastruktur terkelola tidak menghapus tanggung jawab pembaruan aplikasi, izin, dan cadangan. Editor akan saya perbaiki sambil menggunakannya untuk artikel dan terjemahan baru.
Berdasarkan arsitektur dan catatan migrasi per 13 November 2026. Tautan layanan mengarah ke dokumentasi resmi Cloudflare.
Komentar 0
Bukan kewarganegaraan atau tempat tinggal. VPN dapat memengaruhi hasil.
Belum ada konten.