局域网内利用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