手机版
你好,游客 登录 注册 搜索
背景:
阅读新闻

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

[日期:2016-05-08] 来源:Linux社区  作者:zqb-all [字体: ]

安装了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  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指南  http://www.linuxidc.com/Linux/2015-12/126876.htm

如何在Ubuntu Server 14.04下安装Gitlab中文版  http://www.linuxidc.com/Linux/2015-12/126875.htm

CentOS源码安装GitLab汉化版  http://www.linuxidc.com/Linux/2015-10/124648.htm

在 Ubuntu 12.04 上安装 GitLab http://www.linuxidc.com/Linux/2012-12/75249.htm

GitLab 5.3 升级注意事项 http://www.linuxidc.com/Linux/2013-06/86473.htm

在 CentOS 上部署 GitLab (自托管的Git项目仓库) http://www.linuxidc.com/Linux/2013-06/85754.htm

在RHEL6/CentOS6/ScientificLinux6上安装GitLab 6.0.2 http://www.linuxidc.com/Linux/2014-03/97831.htm

CentOS 6.5安装GitLab教程及相关问题解决 http://www.linuxidc.com/Linux/2014-05/101526.htm

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

本文永久更新链接地址http://www.linuxidc.com/Linux/2016-05/131136.htm

linux
本文评论   查看全部评论 (0)
表情: 表情 姓名: 字数

       

评论声明
  • 尊重网上道德,遵守中华人民共和国的各项有关法律法规
  • 承担一切因您的行为而直接或间接导致的民事或刑事法律责任
  • 本站管理人员有权保留或删除其管辖留言中的任意内容
  • 本站有权在网站内转载或引用您的评论
  • 参与本评论即表明您已经阅读并接受上述条款