Cloudflare Pages로 Hugo 블로그 배포하기

이 블로그는 Cloudflare Pages 위에서 돌아갑니다. 셋업하며 부딪힌 점 몇 가지를 메모해 둡니다.

빌드 설정#

Pages 프로젝트 만들 때 입력한 값은 단순합니다.

npm run build로 호출하는 이유는 node_modules/.bin이 PATH에 들어가서 Tailwind CLI를 찾을 수 있기 때문. hugo 단독으로 부르면 빌드 중간에 사망합니다.

버전 핀은 .tool-versions로#

hugo 0.161.1
nodejs 22.22.0

Pages가 이 파일을 자동으로 읽어서 같은 버전을 설치해 줍니다. 대시보드의 HUGO_VERSION, NODE_VERSION 환경변수는 굳이 안 잡아도 됩니다. 두 곳에 적어두면 나중에 한쪽만 올렸을 때 어긋날 수 있어서 오히려 위험.

주의: dashboard의 “Retry deployment”#

같은 SHA를 다시 돌리는 동작입니다. 코드를 고친 뒤에 Retry를 누르면 옛 코드로 또 실패해요. 새 빌드를 트리거하려면 새 커밋을 push하거나 “Create deployment"를 쓰면 됩니다.

Tip

빌드가 또 실패하면 로그 맨 위의 HEAD is now at <sha>부터 보세요. 어떤 커밋이 빌드된 건지 한눈에 보여서 시간을 많이 아낍니다.