GitHub Pages 변경사항 반영 문제 해결

현재 상황

확인해야 할 사항

1. GitHub Actions 빌드 상태 확인

  1. GitHub 레포지토리 페이지에서 “Actions” 탭 클릭
  2. 최근 워크플로우 실행 상태 확인
    • 🟢 초록색 체크: 빌드 성공 (몇 분 기다려보세요)
    • 🟡 노란색 원: 빌드 진행 중
    • 🔴 빨간색 X: 빌드 실패 (에러 로그 확인 필요)

2. GitHub Pages 설정 확인

  1. 레포지토리 → SettingsPages 메뉴
  2. Source가 올바르게 설정되어 있는지 확인
    • gh-pages 브랜치 또는
    • master/main 브랜치의 /docs 폴더 또는
    • GitHub Actions

3. 사이트 URL 확인

4. 브라우저 캐시 문제 해결

5. 빌드 강제 재실행

  1. Actions 탭에서 실패한 워크플로우 클릭
  2. “Re-run jobs” 버튼 클릭

일반적인 대기 시간

빠른 확인 방법

터미널에서 다음 명령어로 원격 저장소 상태 확인:

git fetch origin
git log origin/master --oneline -3