在 GitLab Pages 上托管

假设条件

熟悉使用 Git 进行版本控制
完成 Hugo 的快速入门教程
拥有一个 GitLab 账号
有一份已准备好发布的 Hugo 网站在您的本地机器上

BaseURL

如果您使用的是默认的 GitLab Pages URL（例如， https://<YourUsername>.gitlab.io/<your-hugo-site>/ ），而不是自定义域名，则您在站点配置中的 baseURL 必须反映您的 GitLab Pages 仓库的完整 URL。

配置 GitLab CICD

通过在项目根目录下创建一个 .gitlab-ci.yml 文件来定义您的 CI/CD 作业。

.gitlab-ci.yml

variables:
  DART_SASS_VERSION: 1.80.6
  HUGO_VERSION: 0.137.1
  NODE_VERSION: 20.x
  GIT_DEPTH: 0
  GIT_STRATEGY: clone
  GIT_SUBMODULE_STRATEGY: recursive
  TZ: America/Los_Angeles

image:
  name: golang:1.22.1-bookworm

pages:
  script:
    # 安装 brotli
    - apt-get update
    - apt-get install -y brotli
    # 安装 Dart Sass
    - curl -LJO https://github.com/sass/dart-sass/releases/download/${DART_SASS_VERSION}/dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz
    - tar -xf dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz
    - cp -r dart-sass/ /usr/local/bin
    - rm -rf dart-sass*
    - export PATH=/usr/local/bin/dart-sass:$PATH
    # 安装 Hugo
    - curl -LJO https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb
    - apt-get install -y ./hugo_extended_${HUGO_VERSION}_linux-amd64.deb
    - rm hugo_extended_${HUGO_VERSION}_linux-amd64.deb
    # 安装 Node.js
    - curl -fsSL https://deb.nodesource.com/setup_${NODE_VERSION} | bash -
    - apt-get install -y nodejs
    # 安装 Node.js 依赖项
    - "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
    # 构建
    - hugo --gc --minify
    # 压缩
    - find public -type f -regex '.*\.\(css\|html\|js\|txt\|xml\)$' -exec gzip -f -k {} \;
    - find public -type f -regex '.*\.\(css\|html\|js\|txt\|xml\)$' -exec brotli -f -k {} \;
  artifacts:
    paths:
      - public
  rules:
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH

将您的 Hugo 网站推送到 GitLab

接下来，在 GitLab 上创建一个新的仓库。无需将仓库设为公开。此外，您可能需要将 /public 添加到您的 .gitignore 文件中，因为无需将编译后的资源推送到 GitLab 或将您的输出网站保存在版本控制中。

# 初始化新的 Git 仓库 {#initialize-new-git-repository}
git init

# 将 public 目录添加到我们的 .gitignore 文件 {#add-public-directory-to-our-gitignore-file}
echo "/public" >> .gitignore

# 提交并将代码推送到 master 分支 {#commit-and-push-code-to-master-branch}
git add .
git commit -m "Initial commit"
git remote add origin https://gitlab.com/YourUsername/your-hugo-site.git
git push -u origin master

等待您的页面构建

就是这样！您现在可以在 https://gitlab.com/<YourUsername>/<your-hugo-site>/pipelines 中跟踪 CI 代理构建您的页面。

构建完成后，您的新网站将可在 https://<YourUsername>.gitlab.io/<your-hugo-site>/ 访问。

下一步

GitLab 支持使用自定义 CNAME 和 TLS 证书。有关 GitLab Pages 的更多详细信息，请参阅 GitLab Pages 设置文档。