Пошаговая миграция

Переносите существующий сайт на Atlas по одному типу страниц, не меняя его внешний вид и без простоев.

Эта страница переведена с английского. При любых расхождениях действует английская версия. Читать на английском

Безопасный путь — постепенный. Ваш публичный сайт продолжает работать без изменений, пока вы подключаете и проверяете каждую часть в Development.

Правила, которые обеспечивают безопасность

Дизайн не должен меняться. Каждая страница должна выглядеть одинаково, есть ли у Atlas контент для неё или нет.
Резервный вариант обязателен. Если Atlas недоступен или для страницы ничего не опубликовано, сайт отдаёт встроенный контент.
Текст, а не HTML. Значения из CMS отображаются как текст или через ваши компоненты.
Сначала Development. Ничто не попадает в Production, пока релиз не прошёл проверки и его не одобрил человек.

Этап 1: подключите одну страницу (около одного дня)

Создайте сайт в Studio и подготовьте черновик минимального контракта с одним типом страниц.
Следуйте руководству Подключение сайта на Next.js.
Опубликуйте эту страницу в Development и сравните её с рабочей страницей.

Готово, когда страница отображается из Atlas, выглядит так же и по-прежнему работает при выключенном Atlas.

Этап 2: опишите весь сайт

Перечислите все маршруты, которые отдаёт сайт, и сопоставьте каждому тип страницы.
Напишите пакет контракта: компоненты с типизированными полями, типы страниц с их областями, коллекции, медиапрофили и глобальные блоки шапки и подвала. Храните его в репозитории как atlas/contract.bundle.json.
Проверьте и предложите его. Администратор сайта активирует контракт в Studio (Site setup).
Переработайте каждый компонент страницы так, чтобы порядок и содержимое определяли секции Atlas, а встроенные данные служили резервным вариантом.

Готово, когда Studio показывает сайт как In sync with the active contract.

Этап 3: перенесите контент и изображения

Загружайте изображения с правильным медиапрофилем. Никогда не растягивайте и не увеличивайте их; составьте список тех, что не подходят.
Создайте записи для каждого повторяющегося элемента, ссылаясь на изображения по идентификатору ресурса и с альтернативным текстом.
Заполните глобальные блоки шапки и подвала сегодняшним контентом.
Создайте страницу для каждого маршрута по его типу страницы и настраивайте секции, пока черновик не совпадёт с сегодняшней страницей.
Подготовьте черновики переводов и попросите носителя языка проверить их.

ИИ-агент для программирования, подключённый через MCP, может выполнить большую часть этого в виде черновиков. Человек проверяет каждую страницу через Preview on website и публикует её.

Этап 4: обновление, SEO и редиректы

Добавьте приёмник вебхуков, чтобы публикация обновляла сайт за секунды.
Читайте SEO-заголовки, описания и noindex из Delivery API и стройте карту сайта по /routes.
Загрузите /redirects и применяйте их, чтобы старые URL сохранили свои позиции.

Этап 5: запуск

Обучите редакторов работе со Studio, черновиками, предпросмотром и публикацией.
Соберите релиз. Atlas проверяет, что контракт синхронизирован, нет проблем публикации, сайт исправен и резервная копия свежая.
Человек с правом одобрения одобряет релиз. Администратор сайта включает Production, и вы создаёте токен доставки Production.
Разверните сайт с токеном Production. Сохраните резервный вариант.

Откат

Ошибка в контенте: откатитесь к более ранней ревизии или к более раннему релизу Production.
Ошибка в коде: повторно разверните предыдущую сборку сайта, как вы делаете это сегодня.
Atlas недоступен: резервный вариант отдаёт встроенный контент, пока Atlas не вернётся.