局域网内利用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文件夹供其他人访问。

更多GitLab相关教程见以下内容：

Ubuntu 14.04下安装GitLab指南 

如何在Ubuntu Server 14.04下安装Gitlab中文版 

CentOS源码安装GitLab汉化版 

在 Ubuntu 12.04 上安装 GitLab

GitLab 5.3 升级注意事项

在 CentOS 上部署 GitLab (自托管的Git项目仓库)

在RHEL6/CentOS6/ScientificLinux6上安装GitLab 6.0.2

CentOS 6.5安装GitLab教程及相关问题解决

GitLab 的详细介绍：请点这里
GitLab 的下载地址：请点这里

本文永久更新链接地址：

相关内容