在本教程中，我們將會使用 GitLab CI 將 Hexo 博客部署到 GitLab Pages 上。

1. 新建一個 repository。如果你希望你的站點(diǎn)能通過 <你的 GitLab 用戶名>.gitlab.io 域名訪問，你的 repository 應(yīng)該直接命名為 <你的 GitLab 用戶名>.gitlab.io。
2. 將你的 Hexo 站點(diǎn)文件夾推送到 repository 中。默認(rèn)情況下不應(yīng)該 public 目錄將不會被推送到 repository 中，你應(yīng)該檢查 .gitignore 文件中是否包含 public 一行，如果沒有請加上。
3. 在你的站點(diǎn)文件夾中新建 .gitlab-ci.yml 文件：

image: node:10-alpine # use nodejs v10 LTS
cache:
  paths:
    - node_modules/
?
before_script:
  - npm install hexo-cli -g
  - npm install
?
pages:
  script:
    - hexo generate
  artifacts:
    paths:
      - public
  only:
    - master

1. GitLab CI 應(yīng)該會自動開始運(yùn)行，構(gòu)建成功以后你應(yīng)該可以在 https://<你的 GitLab 用戶名>.gitlab.io 查看你的網(wǎng)站。
2. (可選) 如果你需要查看生成的文件，可以在 job artifact中找到。

在 GitLab.com 上，GitLab CI 是默認(rèn)啟用的。如果你使用的是自托管的 GitLab，你可能需要在 Settings -> CI / CD -> Shared Runners 啟用 GitLab CI。

Project page

如果你更希望你的站點(diǎn)部署在 <你的 GitLab 用戶名>.gitlab.io 的子目錄中，你的 repository 需要直接命名為子目錄的名字，這樣你的站點(diǎn)可以通過 https://<你的 GitLab 用戶名>.gitlab.io/<repository 的名字> 訪問。你需要檢查你的 Hexo 配置文件，將 url 的值修改為 https://<你的 GitLab 用戶名>.gitlab.io/<repository 的名字>、將 root 的值修改為 /<repository 的名字>/

Useful links

• GitLab Pages 相關(guān)文檔
• GitLab CI 相關(guān)文檔
• 在百度上搜索 “Hexo GitLab”