Atlas의 동작 방식

조직, 사이트, 환경, 사이트 계약, 게시, 전달을 한 페이지로 정리합니다.

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

구성 요소

개념	설명
조직	여러분의 회사입니다. 사이트, 사용자, 요금제를 소유합니다.
사이트	웹사이트 하나입니다. 콘텐츠, 미디어, 사용자 접근 권한, 설정은 사이트 간에 절대 섞이지 않습니다.
환경	각 사이트에는 개발과 프로덕션이 있습니다. 작업은 개발 환경에서 하며, 프로덕션은 승인된 릴리스만 제공합니다.
사이트 계약	웹사이트를 기술하는 JSON입니다. 컴포넌트와 형식 있는 필드, 페이지 유형, 컬렉션, 헤더/푸터 글로벌, 미디어 프로필, 디자인 토큰을 담습니다.
페이지	웹사이트의 경로(예: `/about`)이며 섹션으로 구성됩니다. 각 섹션은 계약의 컴포넌트 하나와 그 필드 값입니다.
항목	컬렉션 안의 하나의 아이템입니다. 예를 들어 제품이나 뉴스 기사입니다.
글로벌	사이트 헤더와 푸터처럼 여러 페이지에서 공유하는 콘텐츠입니다.
전달 토큰	웹사이트가 한 환경의 게시된 콘텐츠를 읽을 때 사용하는, 서버 전용 토큰입니다.

콘텐츠가 웹사이트에 도달하는 과정

 Editor in Studio ──draft──▶ Atlas (Development) ──publish──▶ published revision
                                                                     │
                       your website server ◀── Delivery API (HTTPS, delivery token)
                               │
                       your components render it ──▶ visitors

개발자가 웹사이트를 사이트 계약으로 기술합니다. 사이트 관리자가 Studio에서 이를 활성화합니다.
편집자가 페이지와 항목을 초안으로 만들고 수정합니다. 초안은 공개 웹사이트에 절대 나타나지 않습니다.
편집자가 실제 웹사이트 디자인 안에서 초안을 미리보기한 뒤 게시합니다. 게시할 때마다 변경 불가능한 리비전이 만들어지므로 롤백할 수 있습니다.
웹사이트는 서버 코드에서만 전달 토큰으로 Delivery API에서 게시된 콘텐츠를 읽습니다.
게시하면 Atlas가 서명된 웹훅을 보내므로, 웹사이트는 영향받은 페이지만 새로 고칩니다.

개발과 프로덕션

새 사이트는 모두 개발 환경에서 시작합니다. 콘텐츠는 여기서 편집하고 게시합니다.
프로덕션은 릴리스가 모든 검사를 통과하고 승인 권한이 있는 사람이 승인한 뒤 사이트 관리자가 켤 때까지 꺼져 있습니다.
프로덕션은 라이브 상태의 서명된 릴리스, 즉 승인된 콘텐츠의 고정된 스냅샷만 제공합니다. 개발 환경을 편집해도 다음 승인된 릴리스 전까지 프로덕션은 바뀌지 않습니다.
Studio에서 환경을 전환하는 것은 보고 있는 대상만 바꿉니다. 콘텐츠는 절대 바뀌지 않습니다.

자세한 내용: 개발과 프로덕션.

웹사이트가 해야 할 일

Atlas는 웹사이트에서 실행되지 않습니다. 개발자가 소량의 코드를 추가합니다.

Delivery API용 서버 전용 클라이언트
기존 컴포넌트를 통한 섹션 렌더링
폴백: Atlas에 연결할 수 없거나 해당 페이지에 게시된 것이 없으면 사이트가 내장 콘텐츠를 제공
초안 미리보기 경로, 웹훅 수신기, 빌드 보고

연결 가이드에서 각 단계를 안내합니다.