神甫 发表于 2018-1-8 07:43:29

局域网内利用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
  左边面板选择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 chmod777/www/books/测试  

  确定后 在本机clone  编辑一下 再push回去 看是否能触发构建  
  然后就可以在本机编辑,提交,然后到对应页面 比如 
  

http://192.168.1.2/books/测试/  

  查看效果了
  这样以后就可以用gitlab来管理gitbook了,只要提交就自动build并搬运到www文件夹供其他人访问
  本文链接:http://www.cnblogs.com/zqb-all/p/5371255.html
页: [1]
查看完整版本: 局域网内利用gitlab,jenkins自动生成gitbook并发布(nginx)