局域网内利用gitlab,jenkins自动生成gitbook并发布(nginx)
局域网内利用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.gitCredentials 处点击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