웹 미리보기, 게시와 배포

웹 게시의 첫 성공 기준은 deploy 버튼을 누르는 것이 아니라, 선택한 Binder가 로컬에서 정확히 materialize되고 배포된 주소에서 같은 핵심 내용과 자산을 확인하는 것이다. 이 장은 로컬 Hugo preview, site settings, 접근 제어, 직접 배포와 운영·복구를 단계별로 분리한다.

이 장의 상세 문서

• Preview 작업 공간에서 게시 전 검증하기: 출판 워크벤치의 Web handoff 뒤 구조·렌더링·사이트 설정을 검증하고 deploy와 구분한다.
• 사용자 소유 Cloudflare에 게시하고 운영하기: direct deploy 준비, progress·sanitized log·history, 재시도와 remote project 삭제 경계를 다룬다.

네 단계의 증거

단계	확인할 것	성공 증거
local materialization	Binder 문서, 보기와 asset	build log, manifest, 브라우저 결과
site configuration	logo, favicon, menu, footer, search, TOC	새 브라우저에서 설정 반영
deploy	provider project, host, progress	배포 완료와 공개 URL
operations	history, logs, analytics, delete·retry	실제 상태와 복구 가능한 action

첫 게시 경로

1. 첫 프로젝트 로컬 미리보기를 완료한다.
2. site title, logo·favicon, menu, search와 TOC 깊이를 설정한다.
3. robots와 sitemap이 의도한 공개 범위와 맞는지 확인한다.
4. 공개·password·expiry 중 접근 방식을 선택한다.
5. 자신의 provider 또는 Glif Managed 중 소유 모델을 선택한다.
6. deploy progress와 log를 확인하고 반환된 URL을 새 브라우저에서 연다.
7. 핵심 문서, 이미지, 영상, search와 제한 페이지를 직접 확인한다.

설정값 하나씩의 의미와 예제는 사이트 설정 전체 가이드에서 실습한다.

일부 지원과 production gate

Binder-local materialization manifest(PB-41)와 first-run부터 production verified publish까지의 전체 여정(PB-43)은 현재 일부 지원이다. 로컬·mock·sandbox에서 확인된 범위와 실제 production credential로 확인해야 하는 범위를 구분한다. 실제 provider evidence가 없는 상태에서 production 성공을 보장하지 않는다.

Android package는 post-v1 deferred이므로 현재 게시 절차에 포함하지 않는다. Managed workspace-state와 retired Worker serving layer도 현재 기능처럼 노출하지 않는다. Analytics는 provider 이름을 제품 정체성으로 고정하지 않고 사용자에게 필요한 상태와 설정만 설명한다.

빠른 설정 표면은 사이트 게시 설정에서 확인한다.

실제 게시 전후를 대조하는 화면

로컬 materialization, 설정, deploy와 운영은 서로 다른 증거를 요구한다.

첫 게시의 확인 순서

1. Binder와 source revision을 고정한다.
2. 로컬 Hugo 결과에서 제목·본문·asset·navigation을 확인한다.
3. site settings와 접근 제어를 저장하고 새 브라우저에서 다시 연다.
4. deploy 전 activation/preflight를 통과시키고 경고를 기록한다.
5. provider project와 host 소유권을 확인한다.
6. progress·sanitized log·deployment history를 읽는다.
7. 반환된 URL을 새 브라우저와 모바일 폭에서 열어 핵심 문서와 asset을 확인한다.
8. 실패나 취소 시 remote 상태, 재시도 가능 여부와 삭제 확인을 분리한다.

상태별 공개 문구

상태	공개할 수 있는 표현	피할 표현
local pass	“로컬 Hugo 결과를 확인했다”	“공개 배포가 완료됐다”
activation blocked	“배포 전 준비 조건이 남아 있다”	“버튼을 누르면 게시된다”
provider success	“해당 provider project에서 URL을 확인했다”	“모든 계정에서 동일하게 동작한다”
provider failure	“실패 원인·재시도·복구 경로를 기록했다”	실패를 빈 성공 화면으로 대체
partial	“검증된 local/mock 범위”	production success 보장
deferred	현재 게시 절차에서 제외	현재 지원 기능처럼 나열

Analytics는 특정 provider 이름보다 사용자가 조정하는 상태·설정으로 설명하고, token·password·raw provider response를 캡처하지 않는다.

이 장의 완료 기준

• 로컬 materialization과 외부 deploy를 분리했다.
• site settings와 접근 정책을 새 브라우저에서 확인했다.
• activation, progress, log, history를 각각 기록했다.
• production credential이 없는 경우 그 경계를 공개 문구에 반영했다.
• 실패·취소·재시도·remote project 삭제의 확인 단계를 분리했다.
• partial/deferred 기능을 현재 성공 기능처럼 쓰지 않았다.