Viewer and Access
Butty LLM Wiki の viewer は Quartz を使い、Cloudflare Pages に deploy する。
閲覧制御は Cloudflare Access を使い、GitHub IdP の Team 条件で許可する。
Target Design
- content source:
wiki/pages/ - viewer: Quartz
- hosting: Cloudflare Pages
- access control: Cloudflare Access + GitHub IdP
- allow group: GitHub Organization の wiki reader Team（Team 名/slug の SSoT は運用手順）
- local build:
pnpm build:wiki-viewer - build output:
wiki-viewer/public
Access Policy
Cloudflare Access は deny by default とし、GitHub Team allowlist に一致するユーザーだけを許可する。
使わない設定:
- everyone allow
- all valid emails allow
- broad email domain allow
Deployment Notes
Cloudflare Pages project と Access policy は repo 外の Cloudflare dashboard/API で設定する。
repo 内では Quartz build と artifact 検証までを行う。GitHub Team 作成、Cloudflare Pages project 作成、Access policy 設定、所属/非所属ユーザーでの閲覧確認は外部依存の手動作業として扱う。
wiki/raw/ は公開 artifact に含めない。viewer の content source は wiki/pages/ のみとする。
詳細手順は docs/development/guides/operations/llm-wiki-cloudflare-pages.md を参照する。
Related
Sources
docs/development/guides/operations/llm-wiki-cloudflare-pages.md