한동안 블로그를 방치하다가 간만에 근황을 작성하려고 Hugo와 Blowfish 테마로 운영 중인 블로그를 업데이트했습니다. 그런데 Blowfish 테마의 최신 변경사항을 git pull로 받아서 배포했더니 Cloudflare에서 빌드 오류가 발생했습니다.
문제 상황#
로컬 환경에서는 Hugo v0.141.0을 사용하고 있었지만, Cloudflare Pages에서는 v0.128.0 버전으로 빌드되고 있었습니다. 버전 불일치로 인해 배포가 실패하는 상황이었죠.
원인 분석#
문제의 원인은 Cloudflare Pages의 v2 build runtime에 있었습니다. v2 runtime에서는 Hugo 버전이 제한적으로 지원되고 있었고, 최신 버전인 0.141.0을 사용할 수 없었습니다.
자세한 지원 버전 정보는 Cloudflare Pages 공식 문서에서 확인할 수 있습니다.
해결 방법#
두 가지 해결 방안이 있었습니다:
1. Build Runtime을 v3로 변경#
Cloudflare Pages 설정에서 build runtime을 v2에서 v3로 업그레이드하는 방법입니다.
2. 환경변수로 Hugo 버전 지정#
환경변수에 HUGO_VERSION=0.141.0을 추가하여 특정 Hugo 버전으로 빌드하도록 설정하는 방법입니다.
빌드 명령어 최적화#
기존에는 단순히 hugo 명령어만 사용했는데, 이번 기회에 빌드 명령어도 개선했습니다:
hugo --gc --minify
--gc: 빌드 후 불필요한 캐시 파일을 정리
--minify: HTML, CSS, JS 파일을 압축하여 최적화
정리#
이렇게 설정하니 로컬과 Cloudflare 환경 모두에서 정상적으로 배포되었고, 빌드 결과물도 더 최적화되었습니다. 마무리 블로그를 오랜만에 업데이트하다 보니 이런 작은 이슈가 생겼지만, 덕분에 빌드 환경도 개선할 수 있었습니다. Hugo나 Blowfish 테마를 사용하시는 분들께 도움이 되길 바랍니다!