Vercel에서 Hugo를 호스팅하는 방법

저는 Hugo와 함께 개인 웹사이트를 구축하기로 결정했습니다. 제가 선택한 유일한 기준은 빌드 시간이었습니다. 콘텐츠 관리 혜택에 있어서 Hugo가 Astro와 같은 리그에 있다고 생각했지만 아직은 그렇지 않습니다. 또는 내가 만난 대부분의 다른 정적 사이트 생성기보다 오래되었기 때문에 고유한 경로가 있다고 말할 수 있습니다. 게다가 기술 선택을 평가할 때 고려해야 할 또 다른 중요한 요소인 Go 애플리케이션입니다.

추가할 수 있는 것!

예, Hugo의 기능을 확장하는 것이 가능합니다. 빌드 프로세스를 수정하는 모듈을 통해 누락된 기능을 추가할 수 있습니다. 예를 들어 Hugo에서는 MDX 지원이 누락되었습니다. 빌드 시 MDX를 렌더링하는 모듈을 통해 이 문제를 해결할 수 있습니다. 직접 해보지는 않았지만 가능할 것 같습니다.
또한 병렬 구축 파이프라인을 추가할 수도 있습니다. 그렇게 부를 수 있다면 말이죠. 여기에는 Vite, Turbo 또는 Webpack과 같은 도구를 사용하는 것이 포함될 수 있습니다. 그러나 이 접근 방식은 빌드 프로세스를 복잡하게 만들고 잠재적으로 Hugo의 주요 빌드 메커니즘을 느리게 만들 수 있습니다. 이러한 통합은 Tailwind 및 기타 프런트엔드 라이브러리를 통합하는 데 사용되었습니다. 흥미롭게도 Hugo의 향후 기능을 살펴보면 Tailwind와 기타 기술을 통합하려는 계획을 볼 수 있습니다.

Vercel 기반 구축

저는 일부 타사 Hugo 도구, 특히 HugoMod를 사용했습니다. 전체 글꼴을 가져오지 않고 웹 사이트에 아이콘을 추가하고 싶었기 때문에 아이콘 모듈이 내 관심을 끌었습니다. 검색하는 동안 아이콘 모듈이 가장 먼저 나타났습니다. Bootstrap, Font Awesome, Feather 아이콘 등 다양한 아이콘 공급업체를 제공합니다.
로컬에서는 모든 것이 완벽하게 작동했습니다. 그러나 변경 사항을 적용한 후에는 아무것도 바뀌지 않는 것 같습니다. Vercel의 빌드 페이지를 확인해보니...

[12:10:48.021] Running build in Washington, D.C., USA (East) – iad1
[12:10:48.210] Cloning github.com/mohessaid/mohessaid (Branch: main, Commit: eaeecd1)
[12:10:48.449] Cloning completed: 238.727ms
[12:10:49.038] Restored build cache from previous deployment (5i5sCdjnY3KZXgGBqbqfgJUjrwYB)
[12:10:49.132] Running "vercel build"
[12:10:49.714] Vercel CLI 39.0.2
[12:10:50.440] Total in 3 ms
[12:10:50.441] Error: failed to load modules: failed to download modules: binary with name "go" not found in PATH
[12:10:50.446] Error: Command "hugo --gc" exited with 1
[12:10:50.625]

Hugo가 빌드에 필요한 모듈을 설치하려고 시도했을 때 Go 바이너리를 찾을 수 없었습니다. 빠른 해결을 바라며 Claude와 GPT에 도움을 요청했지만 직접적인 도움을 받을 수 없었습니다. 각 단계를 안내해야 했고 결국에는 그들이 나를 도와줄 수 있다는 희망을 잃었습니다.
Vercel 입력 필드의 제한만 제외하면 거의 성공적인 솔루션을 위해 Claude를 사용하기도 했습니다.

무엇이 효과가 있었나요?

Vercel 대시보드에서 내 웹사이트의 설정 페이지로 이동했습니다. "환경 변수" 탭에서 "HUGO_VERSION"이라는 변수를 추가하고 그 값을 Hugo의 최신 버전으로 설정했습니다.

'일반' 탭에서 프레임워크 사전 설정으로 Hugo를 선택합니다. 그런 다음 빌드 명령을 다음으로 재정의하세요.

curl -L https://go.dev/dl/go1.22.2.linux-amd64.tar.gz -o go1.22.2.linux-amd64.tar.gz && tar -C /usr/local -xzf go1.22.2.linux-amd64.tar.gz && export PATH=$PATH:/usr/local/go/bin && go env GOTPATH  &&  hugo --gc --minify 

참고: 저는 글을 쓰는 시점에서 최신 버전인 Go 버전 1.22.2를 사용하고 있습니다. 특정 요구 사항에 맞게 버전을 수정할 수 있습니다.

왜 빌드 커맨드인가?

당신의 회의적인 시각을 이해합니다. 당신처럼 나도 영리한 해결책이 있다고 생각했어요. 처음에는 Install Command 항목에서 Go를 설치하려고 했으나 처참하게 실패했습니다. 철저한 문제 해결에도 불구하고 Vercel의 빌드 프로세스에서 바이너리를 찾을 수 없습니다.
성공하지 못한 수많은 잠재적 솔루션을 탐색한 후 누군가가 전체 설치 프로세스를 빌드 필드에 직접 배치한 GitHub 문제를 우연히 발견했습니다. 그들의 접근 방식을 재현하여 마침내 성공했습니다. 이 시점에서 솔루션은 그 자체로 입증됩니다.
설치 명령 필드에 이러한 단계를 입력하려고 하면 오류가 발생할 수 있습니다.

아니면 이거

Amazon Linux Extras를 설치해도 Go 설치 문제가 해결되지는 않습니다. 이 방법을 통해 사용할 수 있는 Go 버전은 상당히 구식입니다. 이 접근 방식을 철저히 테스트한 결과 지속적인 실패가 발생했습니다. 설치 명령에 yum 및 dnf 패키지 관리자를 모두 사용하려고 시도했지만 두 방법 모두 Go 바이너리 문제를 성공적으로 해결하지 못했습니다.

---

마지막으로 저는 이 게시물을 여러 플랫폼에 공유하여 어느 플랫폼이 검색 결과에 먼저 표시되는지 테스트했습니다. 나는 몇 달 전부터 기꺼이 그렇게 하려고 했습니다. 그러나 나는 그에 맞는 게시물을 올릴 수 없었습니다. 여기에서 실험을 따라갈 수 있습니다.

위 내용은 Vercel에서 Hugo를 호스팅하는 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!