安装了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
左边面板选择Web Hooks
填入url
http://192.168.1.2:8082/gitlab/build_now
点击左下按钮 Add Web Hook
然后在本机新建 README.md 和 SUMMARY.md 两个文件,提交到这个项目中去
/********************配置jenkins****************************************************/
登陆jenkins :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文件夹供其他人访问。
更多GitLab相关教程见以下内容:
Ubuntu 14.04下安装GitLab指南
如何在Ubuntu Server 14.04下安装Gitlab中文版
CentOS源码安装GitLab汉化版