部署與環境

部署與環境

docs-hub(本站)

部署到 Cloudflare Pages。push main 自動部署(見 .github/workflows/deploy.yml), 或本機 npm run deploy(讀 .env 的 token)。

所需環境變數:

• CLOUDFLARE_API_TOKEN(權限:Account → Cloudflare Pages → Edit)
• CLOUDFLARE_ACCOUNT_ID
• PAGES_PROJECT_NAME(可選,預設 docs-hub)

各服務 dev/prod 隔離原則

服務	prod 部署	dev/preview 實測	隔離重點
hotel-cms	npm run deploy / wrangler pages deploy	./scripts/ship.sh dev	dev/prod 完全隔離(獨立帳號 + D1/KV + Logto dev app)
topreview-hotel	wrangler deploy	./scripts/ship.sh preview(--env preview,共用 prod D1)	preview 登入需 Logto 白名單
omni-bot	wrangler deploy <worker> / deploy-all	./scripts/ship.sh dev <worker>	無 preview env(5 prod workers),migration 先行
hotel-intel	(Python pipeline,非 CF)	—	Postgres,備份見 備份與還原

共通好習慣(非強制)

• 部署前本機跑過 build/test。
• 重大變更先用 dev/preview 看一眼。
• ship.sh 在各 repo 仍是可選的驗證工具(tsc/lint/test gate + preview checkpoint)。