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

巴特西

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

背景

开始

自定义域名

最新文章

热门文章