단계별 마이그레이션

기존 웹사이트를 모양을 바꾸지 않고 다운타임 없이, 페이지 유형 하나씩 Atlas로 옮깁니다.

이 페이지는 영어에서 번역되었습니다. 내용이 다를 경우 영어 버전이 우선합니다. 영어로 읽기

안전한 이전 방법은 점진적으로 하는 것입니다. 개발 환경에서 각 부분을 연결하고 확인하는 동안 공개 웹사이트는 변함없이 계속 운영됩니다.

안전을 지키는 규칙

디자인이 바뀌어서는 안 됩니다. Atlas에 콘텐츠가 있든 없든 모든 페이지가 똑같이 보여야 합니다.
폴백은 필수입니다. Atlas에 연결할 수 없거나 페이지에 게시된 것이 없으면 사이트는 내장 콘텐츠를 제공합니다.
HTML이 아닌 텍스트. CMS 값은 텍스트로 또는 여러분의 컴포넌트를 통해 렌더링됩니다.
개발 환경 먼저. 릴리스가 검사를 통과하고 사람이 승인하기 전에는 아무것도 프로덕션에 도달하지 않습니다.

1단계: 페이지 하나 연결(약 하루)

Studio에서 사이트를 만들고 페이지 유형 하나가 있는 최소한의 계약 초안을 작성합니다.
Next.js 웹사이트 연결을 따릅니다.
그 페이지 하나를 개발 환경에서 게시하고 라이브 페이지와 비교합니다.

완료 기준: 페이지가 Atlas에서 렌더링되고, 똑같이 보이며, Atlas를 꺼도 여전히 동작합니다.

2단계: 사이트 전체 모델링

사이트가 제공하는 모든 경로를 나열하고 각각을 페이지 유형에 매핑합니다.
계약 번들을 작성합니다. 형식 있는 필드가 있는 컴포넌트, 리전이 있는 페이지 유형, 컬렉션, 미디어 프로필, 헤더와 푸터 글로벌입니다. 저장소에 atlas/contract.bundle.json으로 보관합니다.
검증하고 제안합니다. 사이트 관리자가 Studio(Site setup)에서 활성화합니다.
Atlas 섹션이 순서와 콘텐츠를 결정하고 내장 데이터가 폴백이 되도록 각 페이지 컴포넌트를 리팩터링합니다.

완료 기준: Studio에 웹사이트가 In sync with the active contract로 표시됩니다.

3단계: 콘텐츠와 이미지 이전

올바른 미디어 프로필로 이미지를 업로드합니다. 늘리거나 확대하지 말고, 맞지 않는 이미지는 목록으로 정리합니다.
반복되는 모든 항목의 항목을 만들고, 에셋 ID로 이미지를 참조하며 대체 텍스트를 넣습니다.
헤더와 푸터 글로벌을 현재 콘텐츠로 채웁니다.
각 경로에 대해 페이지 유형으로 페이지를 만들고, 초안이 현재 페이지와 일치할 때까지 섹션을 조정합니다.
번역 초안을 작성하고 원어민이 검토하게 합니다.

MCP로 연결한 AI 코딩 에이전트가 이 대부분을 초안으로 처리할 수 있습니다. 사람이 Preview on website로 각 페이지를 확인하고 게시합니다.

4단계: 새로 고침, SEO, 리디렉션

웹훅 수신기를 추가하여 게시 후 몇 초 안에 사이트가 업데이트되게 합니다.
Delivery API에서 SEO 제목, 설명, noindex를 읽고 /routes로 사이트맵을 만듭니다.
/redirects를 불러와 적용하여 이전 URL이 순위를 유지하게 합니다.

5단계: 라이브 전환

편집자에게 Studio, 초안, 미리보기, 게시를 교육합니다.
릴리스를 빌드합니다. Atlas는 계약이 동기화되어 있는지, 게시 문제가 없는지, 웹사이트가 양호한지, 백업이 최근인지 확인합니다.
승인 권한이 있는 사람이 승인합니다. 사이트 관리자가 프로덕션을 켜고 프로덕션 전달 토큰을 만듭니다.
프로덕션 토큰으로 웹사이트를 배포합니다. 폴백은 그대로 유지하세요.

롤백

콘텐츠 실수: 이전 리비전이나 이전 프로덕션 릴리스로 롤백합니다.
코드 실수: 지금처럼 이전 웹사이트 빌드를 다시 배포합니다.
Atlas 사용 불가: Atlas가 복구될 때까지 폴백이 내장 콘텐츠를 제공합니다.