局域网内利用GitLab+Jenkins自动生成GitBook并发布(

安装了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汉化版 

在 Ubuntu 12.04 上安装 GitLab

GitLab 5.3 升级注意事项

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

在RHEL6/CentOS6/ScientificLinux6上安装GitLab 6.0.2

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/04b03288785e233914e68798208b563e.html