docsify+gitlab+jenkins 文档服务搭建

首先，jenkins的搭建的过程在这里就不在多讲，之前没有搭建过的可以查看我的jenkins专题，gitlab的安装，在这里也不多说。那就简单了，只剩下docsify了，使用它需要在服务器上做一些基础工作；

安装node

1、首先查看下机器的位数

[root@localhost ](https://www.jianshu.com/p/a3d1ad3b159f)# getconf LONG_BIT
64

上面结果说明机器是64位的，然后登陆node官网下砸适合自己版本的安装包
https://nodejs.org/zh-cn/

image.png

2、新建下载目录，并下载,解压安装包

[root@localhost ]#  mkdir -p /usr/local/lib/nodejs
[root@localhost ]# cd /usr/local/lib/nodejs
[root@localhost nodejs]# wget https://nodejs.org/dist/v12.18.1/node-v12.18.1-linux-x64.tar.xz
[root@localhost nodejs]# tar -xJvf node-v12.18.1-linux-x64.tar.xz -C /usr/local/lib/nodejs

3、修改环境变量~/.profile,把下面内容添加到配置文件末尾

# Nodejs
VERSION=v10.15.0
DISTRO=linux-x64
export PATH=/usr/local/lib/nodejs/node-v12.18.1-linux-x64/bin:$PATH

4、刷新配置文件

. ~/.profile

5、完成上面步骤后，可以使用下面命令检测安装是否成功

$ node -v
v12.18.1
$ npm version
6.14.5
$ npx -v
6.14.5

得到上面的结果，说明node安装成功。

创建gitlab项目

1、并将项目代码拷贝到本地

image.png

2、设置gitlab上新创建的项目Webhooks

image.png

jenkins配置

1、添加Jenkins配置插件

打开jenkins页面
添加插件：系统管理 - 插件管理
需要添加的插件：Post Build Task、Gitlab Hook、Gitlab
我的Jenkins Gitlab Hook、Gitlab这两个插件之前就已经安装过了，所以本次只需要安装Post Build Tas、Gitlab即可。

image.png

2、新建一个自由风格的软件项目

image.png

3、源码管理，配置上面在gitlab上创建的仓库

image.png

4、设置构建触发器

点击高级，在展开的页面中设置分支塞选器，并生成令牌，然后点击保存

image.png

5、设置构建操作

将git上下载下来的所有的文件，通过ssh的方式传输到部署服务器指定文件夹下，然后配置好执行脚本

image.png

PIDS=`ps -ef |grep docsify |grep -v grep | awk '{print $2}'`
if [ "$PIDS" != "" ]; then
echo "docsify is runing!"
else
#运行进程
echo "starting docsify!"
docsify serve /data/publish/ae-docs --port 3000 &
fi

6、保存配置

服务器配置

部署服务器安装

npm i docsify-cli -g
docsify init /data/publish/ae-docs
docsify serve /data/publish/ae-docs