Migrasi langkah demi langkah

Pindahkan situs web yang sudah ada ke Atlas satu tipe halaman demi satu, tanpa mengubah tampilannya dan tanpa downtime.

Halaman ini diterjemahkan dari bahasa Inggris. Jika ada perbedaan, versi bahasa Inggris yang berlaku. Baca dalam bahasa Inggris

Cara yang aman untuk berpindah adalah bertahap. Situs web publik Anda tetap berjalan tanpa perubahan selagi Anda menghubungkan dan memeriksa setiap bagian di Development.

Aturan yang menjaga keamanan

Desain tidak boleh berubah. Setiap halaman harus tampak identik baik Atlas memiliki konten untuknya maupun tidak.
Fallback wajib ada. Jika Atlas tidak dapat dijangkau atau tidak ada yang terbit untuk suatu halaman, situs menyajikan konten bawaannya.
Teks, bukan HTML. Nilai CMS dirender sebagai teks atau melalui komponen Anda.
Development lebih dulu. Tidak ada yang mencapai Production sampai rilis lolos pemeriksaannya dan seseorang menyetujuinya.

Tahap 1: hubungkan satu halaman (sekitar satu hari)

Buat situs di Studio dan susun draf kontrak minimal dengan satu tipe halaman.
Ikuti Hubungkan situs web Next.js.
Terbitkan satu halaman itu di Development dan bandingkan dengan halaman live.

Selesai ketika halaman dirender dari Atlas, tampilannya sama, dan tetap berfungsi dengan Atlas dimatikan.

Tahap 2: modelkan seluruh situs

Daftar setiap rute yang disajikan situs dan petakan masing-masing ke tipe halaman.
Tulis bundel kontrak: komponen dengan bidang bertipe, tipe halaman beserta region-nya, koleksi, profil media, dan global header dan footer. Simpan di repositori Anda sebagai atlas/contract.bundle.json.
Validasi dan ajukan. Admin situs mengaktifkannya di Studio (Site setup).
Refaktor setiap komponen halaman agar seksi Atlas menentukan urutan dan konten, dengan data bawaan sebagai fallback.

Selesai ketika Studio menampilkan situs web In sync with the active contract.

Tahap 3: pindahkan konten dan gambar

Unggah gambar dengan profil media yang tepat. Jangan pernah meregangkan atau memperbesar; daftar gambar yang tidak sesuai.
Buat entri untuk setiap item berulang, dengan merujuk gambar melalui id aset, lengkap dengan teks alt.
Isi global header dan footer dengan konten saat ini.
Buat halaman untuk setiap rute dari tipe halamannya dan sesuaikan seksinya sampai draf cocok dengan halaman saat ini.
Susun draf terjemahan, dan minta penutur asli meninjaunya.

Agen pengodean AI yang terhubung melalui MCP dapat mengerjakan sebagian besar ini sebagai draf. Seseorang memeriksa setiap halaman dengan Preview on website dan menerbitkannya.

Tahap 4: penyegaran, SEO, dan pengalihan

Tambahkan penerima webhook agar penerbitan memperbarui situs dalam hitungan detik.
Baca judul SEO, deskripsi, dan noindex dari Delivery API, dan bangun sitemap dari /routes.
Muat /redirects dan terapkan, agar URL lama mempertahankan peringkatnya.

Tahap 5: go live

Latih editor tentang Studio, draf, pratinjau, dan penerbitan.
Buat rilis. Atlas memeriksa bahwa kontrak sinkron, tidak ada masalah penerbitan, situs web sehat, dan cadangan masih baru.
Orang yang berhak menyetujui menyetujuinya. Admin situs mengaktifkan Production dan Anda membuat token pengiriman Production.
Deploy situs web Anda dengan token Production. Pertahankan fallback.

Mengembalikan ke versi sebelumnya

Kesalahan konten: kembalikan ke revisi sebelumnya, atau rilis Production sebelumnya.
Kesalahan kode: deploy ulang build situs web Anda sebelumnya, seperti yang Anda lakukan sekarang.
Atlas tidak tersedia: fallback menyajikan konten bawaan sampai Atlas pulih.