왜 별도 project가 필요한가
Cloudflare Pages에서 production branch가 아닌 branch는 preview deployment입니다. Preview는 안전한 검수용이며 기본적으로 검색 engine 색인을 막는 X-Robots-Tag: noindex header가 붙습니다. 따라서 현재 디자인을 유지하면서 별도 Pages project를 하나 만들고, 이 guide branch를 그 project의 production branch로 지정합니다.
기존 프로그램 site는 그대로 유지
같은 GitHub repository를 여러 Pages project에 연결할 수 있으므로 기존 프로그램 site를 바꾸지 않고 guide 전용 production project를 추가할 수 있습니다.
한방배포 운영자에게 필요한 실제 설정
| 항목 | 입력값 | 설명 |
|---|---|---|
| Repository | 현재 연결된 본인 repository | 기존 프로그램 site와 같은 repository를 다시 선택 |
| Project name | hanbang-deploy | 이미 사용 중이면 hanbang-ai-deploy-guide |
| Production branch | my-first-website | 이 guide source branch |
| Framework preset | 없음 | Python generator + static output |
| Build command | python build_cloudflare.py | generate → generic example 변환 → live URL 반영 → 검사 |
| Build output directory | public | 실제 공개 파일 folder |
| Root directory | 비워두기 | repository root 사용 |
URL은 자동 반영
build_cloudflare.py가 Cloudflare의 CF_PAGES_URL을 읽기 때문에 project 이름이 달라져도 canonical, robots.txt, sitemap.xml이 실제 production URL로 생성됩니다.
새 독자가 generic template을 배포할 때
| 항목 | 입력값 |
|---|---|
| Repository | [본인 GitHub ID]/[repository 이름] |
| Production branch | main |
| Framework preset | 없음 |
| Build command | 비워두기 또는 exit 0 |
| Build output directory | public |
| Root directory | 비워두기 |
Generic template ZIP 받기 본인 설정표 만들기
정식 공개 완료 확인
- 새 project의 주소가
https://project-name.pages.dev형태로 열림 - Cloudflare deployment의 commit SHA가 GitHub 최신 commit과 일치
- 홈·본인 account 시작·AI 지시문·연결 링크 page가 정상
/robots.txt의 sitemap URL이 새 production 주소/sitemap.xml의 모든 URL이 새 production 주소- response header에 preview용
X-Robots-Tag: noindex가 없음
그다음 Google Search·AdSense
- 가능하면 본인이 소유한 custom domain 연결
- Google Search Console에 domain 또는 URL-prefix property 추가
/sitemap.xml제출- original article과 About·Contact·Privacy 유지
- AdSense 승인 후 본인 publisher ID만 Secret/config에 등록
공식 참고: Cloudflare Preview deployments · 같은 repository의 여러 Pages project · Git integration