Vercel에 Hugo를 배포하기 위한 단계별 가이드

이 가이드는 Hugo 웹사이트를 Vercel에 배포하는 과정을 안내합니다.
흔한 실수를 하나라도 방지하도록 하겠습니다.

1. 로컬에서 Hugo 사이트 만들기

Hugo가 이미 설치되어 있다고 가정:

hugo 신규 사이트

---

2. Hugo 사이트를 GitHub에 푸시하세요

그런 다음 사이트에 대한 Git 저장소를 설정하세요.

git 초기화

커밋 추가 및 프로젝트 파일 푸시:

git add .
git 커밋
git push -u 오리진 마스터

---

3.Hugo 사이트에 테마를 추가하세요.

예를 들어,hugo-blog-awesome과 같은 Bootstrap 초고속 테마가 아닌 Nno jQuery를 사용할 수 있습니다.

github 모듈:
git 하위 모듈 추가 https://github.com/hugo-sid/hugo-blog-awesome.git

또는 Hugo 모듈
Hugo 모드에서 github.com/hugo-sid/hugo-blog-awesome을 받으세요

---

4. vercel 구성 추가(vercel.json)

루트 디렉토리에 Hugo 버전 Go 버전과 buildCommand를 정의할 vercel.json을 추가합니다. vercel에서 Hugo를 Framework Preset으로 정의한 후 해당 구성이 자동으로 감지됩니다.


vercel.json

{
  "build": {
    "env": {
      "HUGO_VERSION": "0.135.0",
      "GO_VERSION": "1.19.5"
    }
  },
 "buildCommand": "hugo --gc --minify"
}

- hugo env 사용하여 사용 중인 Go 및 Hugo 버전 표시

그런 다음 Github에 업데이트를 푸시하세요.
자식 추가 .
git commit -m "vercel 배포"
git push -u 오리진 마스터

---

5 . Vercel에 사이트 배포

가져오기 프로세스 중에 프로젝트가 Hugo 저장소에 올바르게 연결되었는지 확인하세요.

Vercel이 환경을 감지하고 빌드 명령을 내립니다.

또는 여기 Vercel 환경 변수에서 수동으로 설정할 수도 있습니다

배포 로그:

성공적인 빌드 후 Vercel은 라이브 Hugo 웹사이트를 볼 수 있는 미리보기 링크를 제공합니다. 프로젝트에 대한 Vercel의 설정을 통해 사용자 정의 도메인을 구성할 수도 있습니다.

---

6. 도메인 추가

도메인 이름이 있는 경우 프로젝트 설정의 도메인 섹션에 도메인 이름을 추가할 수 있습니다. 그런 다음 Vercel 도메인을 가리키도록 도메인 공급자에 CNAME을 추가하세요.

---

?️ 일반적인 배포 문제 해결

주요 문제는 vercel이 이미 노드 이미지를 Hugo로 업데이트하고 기본 설정을 사용하더라도 Hugo 지원이 그다지 좋지 않다는 것입니다. Hugo 레이아웃을 찾을 수 없다는 오류가 발생하고 배포가 XML로 이어집니다. 페이지.
이는 env 매개변수 Hugo 및 Go 버전을 json 파일 vercel.json

에서 정의해야 하기 때문입니다.

몇 가지 사소한 문제에도 불구하고 Hugo 및 Vercel을 사용하여 개인 사이트를 설정하는 것은 정말 쉽습니다. 이 포스팅이 귀하의 사이트 구축에 도움이 되기를 바랍니다. 사이트 변경 사항에 대한 자세한 내용은 내 사이트의 커밋 기록을 참조하세요.

---

일부 출처:
https://vercel.com/guides/deploying-hugo-with-vercel
https://vercel.com/docs/projects/project-configuration
https://blog.gusibi.site/article/Best-Practices-for-Deploying-Hugo-on-Vercel

위 내용은 Vercel에 Hugo를 배포하기 위한 단계별 가이드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!