Netlify에서 GitHub Pages로 호스팅 환경 이전 및 Hugo 트러블슈팅
1. 개요 및 이전 배경 과도한 트래픽 및 빌드 시간 제한에 따른 유지보수 측면의 오버헤드를 줄이고자, 기존 사용 중이던 호스팅 및 CMS 환경(Netlify + Decap CMS)을 제거하고 GitHub Actions와 GitHub Pages 기반의 인프라로 사이트 이전을 진행했습니다. 본 문서에서는 마이그레이션 절차와 서버 빌드 파이프라인 전환 중 발생한 에러 현상 및 해결 방법을 요약합니다. 1.1. 호스팅 환경 비교 (Netlify + Decap CMS vs. GitHub Pages + Actions) 구분 Netlify + Decap CMS GitHub Pages + Actions 비용 구조 무료 티어 초과 시 과금 발생 (Bandwidth, Build limits) 완전 무료 (개인 리포지토리 기준 사실상 무제한) 콘텐츠 관리 브라우저 기반 CMS UI 제공 로컬 에디터 및 CLI 명령어로 직접 관리 권한 및 인증 Netlify Identity / Git Gateway 기반 인증 별도 CMS 인증 불필요 (GitHub 계정 자체 권한) 빌드 파이프라인 Netlify 내부 CI/CD 자동화 빌드 GitHub Actions YAML 파일을 통한 수동 제어 및 커스터마이징 유지보수 관점 서드파티 서비스 의존성 존재 및 버그 추적 어려움 모든 빌드 로그 및 파이프라인이 GitHub 내로 통합됨 2. 호스팅 마이그레이션 절차 마이그레이션 작업은 Netlify 종속성을 제거하고 GitHub Actions가 주도하는 배포 환경을 구성하는 데 초점을 두었습니다. ...