Junggi Kim

Junggi Kim

Cloudflare Pages 전환 체크리스트

1) 사전 확인

  • GitHub 로그인 확인 (JunggiKim 계정)
  • Cloudflare 로그인 확인 (Dashboard 접근 가능)
  • 로컬 최신 코드 반영 확인 (main 최신 상태)
  • 롤백 포인트 확인
    • 태그: migration-pre-cf-20260223
    • 백업 브랜치: backup/pre-cf-20260223

2) Git 저장소 상태

  • 소스 저장소 확인: JunggiKim/solodev_root (Private)
  • 블로그 루트 디렉토리 확인: blog
  • main 푸시 완료

3) 자동 부트스트랩 실행 (권장)

CF_ACCOUNT_ID=... \
CF_API_TOKEN=... \
CF_PROJECT_NAME=solodev-root-blog \
scripts/blog/bootstrap-cloudflare-pages-from-values.sh --overwrite --create-project --trigger-deploy
  • SSM 등록 완료 (/solodev/ci/blog/cloudflare/*)
  • GitHub Secrets/Variable 동기화 완료
  • Cloudflare Pages 프로젝트 생성 완료
  • GitHub Actions 배포 트리거 완료

4) 수동 대체 경로 (자동화 실패 시)

  1. Cloudflare Dashboard 접속
  2. Workers & Pages → Create → Pages → Connect to Git
  3. GitHub 연동 후 JunggiKim/solodev_root 선택
  4. 빌드 설정 입력
    • Framework preset: Jekyll
    • Build command: bundle exec jekyll build
    • Build output directory: _site
    • Root directory: blog
  5. 프로젝트 이름을 solodev-root-blog로 지정
  6. 배포 시작

5) 1차 검증 (첫 배포 직후)

  • 홈 페이지 접근 가능: https://solodev-root-blog.pages.dev
  • 게시글 상세 페이지 접근 가능
  • 카테고리/태그/아카이브/검색 페이지 접근 가능
  • 정적 리소스(CSS/JS/이미지) 404 없음
  • 모바일 화면 깨짐 없음

6) 2차 검증 (기능)

  • TOC/코드블록/이미지 렌더링 정상
  • 퍼머링크 경로 정상
  • SEO 메타 태그(title/description/canonical) 정상
  • Giscus 댓글 로딩 여부 확인

7) 컷오버

  1. GitHub에서 기존 공개 저장소 JunggiKim/JunggiKim.github.io 비공개 전환
  2. 프로필/소개 문서/외부 링크를 solodev-root-blog.pages.dev 주소로 교체
  • 기존 공개 저장소 비공개 전환 완료
  • 외부 링크 교체 완료

8) 장애 대응

  • 배포 실패 시 Cloudflare 빌드 로그 확인
  • 필요 시 이전 커밋으로 롤백 배포
  • 심각 장애 시 태그 migration-pre-cf-20260223로 즉시 복원