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 就能看到你可以访问的域名了。
