linux安装gitbook以及jenkins一键部署

时间:2024-03-29 09:14:31

一直都在用这套东西,却没有自己动手搭建过,今天自己用了2小时时间摸索搭建了一套文档在线观看,意见发布文档的东西,仅供大家参考:

首先在linux上搭建一个gitbook的环境:

1.安装git

在CentOS6及以上的yum源中已经有git版本,可以直接用yum源安装,安装命令:sudo yum install git

2.安装Node.js和NPM

到node官网下载node.js(https://nodejs.org/en/download/)

linux安装gitbook以及jenkins一键部署

因为我用的系统是64位,所以下载了linux环境64位的安装包

copy到linux要安装的目录下

使用命令解压: tar zxvf node-v8.2-linux-x64.tar.gz

cd node-v8.2.1-linux-x64

#设置为全局,由于node自带npm,所以无需安装

sudo ln -s /home/node-v8.2-linux-x64/bin/node /usr/local/bin/node
sudo ln -s /home/node-v8.2-linux-x64/bin/npm /usr/local/bin/npm

#通过以下命令查看版本

查看node版本: node -v

查看npm版本:npm -v

2.安装gitbook工具

npm install gitbook-cli -g

sudo ln -s /home/node-v8.2-linux-x64/bin/gitbook /usr/local/bin/gitbook

查看版本:gitbook -V     注意:V大写


安装完成后,使用gitbook创建一个web站点示例:
cd /home/gitbook

mkdir demo

cd demo

初始化:gitbook init   (会生成README.md和SUMMARY.md两个文件)

生成web静态站点:gitbook build ./     (会生成_book目录,也就是静态站点,也就是编译好的html文件)

启动站点:gitbook serve ./       (默认地址:http://localhost:4000)


3.配置gitbook和jenkins部署

在jenkins客户端创建一个*风格的软件项目

linux安装gitbook以及jenkins一键部署

因为我们源码都放在云端git上面,这里源码管理选择git,填写具体项目地址:

linux安装gitbook以及jenkins一键部署

然后构建环境执行shell脚本:

linux安装gitbook以及jenkins一键部署

我这里写的脚本意思是,创建并编译_book下的文件,使之生成静态html文件,copy到我的home下的xx目录下

点击保存,点击立即构建按钮,即可把git上的文件编译后copy到我们指定home目录下

linux安装gitbook以及jenkins一键部署

这里我们用到了nginx,做路径跳转

linux安装gitbook以及jenkins一键部署

最下面的是我们cp过去的文件路径

这里我们访问对应的服务器ip或者域名加上我们对应的指向路径即可访问gitbook文档连接

比如我们服务器ip是139.196.111.222,我们nginx配置路径是 /aa/bb,端口默认是80,那么我们访问139.196.111.222/aa/bb

如下所示即可:

linux安装gitbook以及jenkins一键部署