基于gitlab 15.1 pages 搭建内部博客一定行版本

背景

基于 gitlab 15.1版 pages 搭建内部博客，参考官方文档，遇到一个又一个坑。之前看到别人吐槽说 gitlab 官方文档很差，我算是理解了。下面一个个说。

开始

按照官方文档的说法，基于模板创建一个新项目。

然后执行 CI/CD > Pipelines ，等任务执行完毕，到 Settings > Pages 就能访问到博客了。

---

先说第一个坑，gitlab 提供的 hexo 模板 https://gitlab.com/pages/hexo 是两年前的了，Pipelines 根本编译不通过。下面提供正确的做法。

这里感谢 hexo 官方文档，https://hexo.io/docs/gitlab-pages

在 gitlab 新建一个空白的项目。
先在服务器上执行如下操作，安装 node、hexo

wget https://mirrors.cloud.tencent.com/nodejs-release/v14.19.1/node-v14.19.1-linux-x64.tar.gz tar zxvf node-v14.19.1-linux-x64.tar.gz  mv node-v14.19.1-linux-x64 /usr/local/node  cat <<'EOF'> /etc/profile.d/node.sh export NODE_HOME=/usr/local/node export PATH=$NODE_HOME/bin:$PATH EOF source /etc/profile # 换国内源 npm config set registry http://mirrors.cloud.tencent.com/npm/ # cnpm cd /usr/local/node/bin && npm install -g cnpm --registry=https://registry.npmmirror.com # vue cnpm install -g @vue/cli # hexo npm install -g hexo-cli  ln -fs /usr/local/node/bin/* /usr/bin 

接下来，在 gitlab 新建一个空白项目，初始化 hexo

git clone https://gitlab.xxx.info/xx/xx.git mv xx/.git /tmp hexo init xx mv /tmp/.git xx 

新建一个用于 gitlab ci 的 yml 文件，注意这里的 node 版本要和你安装的 node 版本一致

cd xx cat <<EOF>  .gitlab-ci.yml image: node:v14.19.1 cache:   paths:     - node_modules/  before_script:   - npm install hexo-cli -g   - npm install  pages:   script:     - npm run build   artifacts:     paths:       - public   rules:     - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH EOF 

然后上传到 gitlab 上，运行 pipeline ，编译通过。

自定义域名

这里因特殊原因，需要自定义域名，按照官方文档的说法，只需要 Setting > Pages 就能看到 New domain 的选项了，但我看不到啊！！！最后又是各种找文档。

原来是需要加一些配置，gitlab 要启用 pages 的各种功能，需要在 gitlab.rb 启用如下配置：

external_url 'http://gitlab.xx.info/' pages_external_url "https://xx.yyy.info/" gitlab_pages['enable'] = true gitlab_pages['external_http'] = ['192.168.12.174:8090'] pages_nginx['enable'] = false 

重新配置 gitlab 即可。

新增域名时会要求做验证，可以在这里关闭验证。
Admin > Settings > Preferences > Pages
把√去掉

再去 pages 就能看到你可以访问的域名了。