局域网内利用gitlab,jenkins自动生成gitbook并发布(nginx)

安装了GitBook，内网使用，没法用上gitbook的网页。

用gitbook serve只能展示一本书，而且也不利于长期维护。

于是使用gitlab,jenkins,和nginx配合gitbook使用。

基本的流程是这样的，每本书作为项目托管到gitlab上，每次提交，gitlab会触发jenkins，jenkins会把仓库的内容拉下来，gitbook build 并复制到Web server(Nginx)的目录下,并加上可读权限，然后局域网内的人就都可以直接访问了。

下面记录过程

首先机器上已经安装好了gitlab,jenkins,gitbook和nginx。

然后要给jinkins执行shell程序的sudo权限。

编辑　/etc/sudoers　文件

加上

jenkins ALL=(ALL) NOPASSWD:ALL

这样jenkins就有sudo权限了而且免输密码

然后jenkins要安装一些插件，Git client plugin　Git plugin　　Gitlab Hook Plugin （也许只要最后一个？我是一次性三个都安装了）

假设我的机子的IP是192.168.1.2,gitlab在端口8081,jenkins在端口8082，nginx在80端口并且开放了文件夹/www/

接下来举个例子

/**********************在gitlab上新建项目并配置web hook**********************************/

在gitlab上新建一个项目

比如叫做 Books_测试,对应的url为 

http://192.168.1.2:8081/zhuangqiubin/Books_ceshi

在项目页面左下角进入Settings

左边面板选择Ｗeb Hooks

填入url 

http://192.168.1.2:8082/gitlab/build_now

点击左下按钮　Add Web Hook

然后在本机新建　README.md 　和　SUMMARY.md 两个文件，提交到这个项目中去

/********************配置jenkins****************************************************/

登陆jenkins 　http://192.168.1.2:8082

左上角新建 　 填入名称　比如叫做　 GitBook_测试

选择　构建一个自由风格的软件项目　

点击OK 进入详细设置

源码管理　选择git

Repository URL 填入　项目url 比如　

http://192.168.1.2:8081/zhuangqiubin/Books_ceshi.git

Credentials　处点击ADD 　填入你的gitlab用户名和密码　

确定添加后　把none换成你刚刚添加的用户名密码

最后　Add Repository 确定

往下　构建　增加构建步骤　Execute shells

加入以下代码 (把其中的　测试　替换成你想要的书名)

gitbook build
sudo rm -rf  /www/books/测试
sudo cp -a    _book  /www/books/测试
sudo chmod  777  /www/books/测试

确定后　在本机clone 　编辑一下　再push回去　看是否能触发构建　　

然后就可以在本机编辑，提交，然后到对应页面　比如　

http://192.168.1.2/books/测试/

查看效果了

这样以后就可以用gitlab来管理gitbook了，只要提交就自动build并搬运到www文件夹供其他人访问

本文链接：http://www.cnblogs.com/zqb-all/p/5371255.html