Pages 켜는 절차

사이트(랜딩 + app · console · widgetbook · golden · docs · app-widgetbook 6표면)는 .github/workflows/pages.yml 이 만든다. Pages 는 화면이 모두 끝난 뒤에 켠다(오너 지시). 그 전에는 main push 마다 사이트를 빌드 · 검사만 하고 배포와 공개 스모크는 건너뛴다 — 워크플로는 초록이고, 「Pages 설정 확인」 잡의 notice 가 이유를 남긴다. 켜면 워크플로를 더 고치지 않아도 빌드 → 배포 → 공개 스모크로 간다. 이 문서는 절차만 정한다(켜도 되는 시점의 판단은 오너 몫).

REPO="$(gh repo view --json nameWithOwner --jq .nameWithOwner)"   # 이 저장소 (예: <조직>/<저장소>)

1. 지금 상태

gh api "repos/$REPO/pages" --jq .build_type     # 404 = 꺼짐 · workflow = 켜짐 · legacy = 잘못 켜짐(아래 6)

2. 켜기 (저장소 관리자)

gh api -X POST "repos/$REPO/pages" -f build_type=workflow

build_type=workflow(Source = GitHub Actions)만 쓴다. cname 은 넣지 않는다(아래 6).

3. 첫 배포

gh workflow run pages.yml --ref main -f evidence=true
gh run list --workflow pages.yml --limit 1       # run id 확인 → gh run watch <id>

켠 뒤 첫 main push 도 같다(위 명령은 push 를 기다리지 않고 지금 돌린다).

4. 확인

SITE="$(gh api "repos/$REPO/pages" --jq .html_url)"     # 끝에 / 가 붙은 주소 (S-17: 조직 Pages 사이트 아래)
for s in "" app/ console/ widgetbook/ golden/ docs/ app-widgetbook/; do
  curl -s -o /dev/null -w "%{http_code}  ${SITE}${s}\n" "${SITE}${s}"
done

반영이 늦으면(처음 몇 분) 404 가 나올 수 있다 — 공개 스모크가 최대 10분 기다린다.

5. 되돌리기

gh api -X DELETE "repos/$REPO/pages"

사이트가 내려가고(공개 주소 404), 다음 main push 부터 「Pages 설정 확인」이 배포를 건너뛴다 — 워크플로는 계속 초록이다. 다시 켜면(2) 돌아온다.

6. 주의