構建GitBook並基於GitLab自動發布

整個GitBook構建過程分為以下幾個部分： 安裝node，npm部署gitbook gitlab版本8以上支援pipelines，伺服器上安裝，設定gitlab runner。

1.安裝node

curl -sL https://rpm.nodesource.com/setup_6.x | bash -  （6.9.5）

yum install -y nodejs

2.安裝gitbook

npm install -g gitbook-cli

3.gitlab-ci實現 gitlab的CI主要通過新版本的pipelines功能。 實現原理： 在部署伺服器上執行一個gitlab的runner，並且在gitlab專案的根目錄下建立.gitlab-ci.yml檔案，裡面主要儲存一些執行 指令碼，當有新資料被push時，就會執行其中的程式碼，實現持續整合。 實現步驟： 1.在專案根目錄下新建.gitlab-ci.yml檔案，內容如下

rspec:
  script:
    - gitbook init
    - gitbook build
    - sh start.sh

當專案內容更新時，更新的內容就會pull到部署伺服器，然後依次執行上面程式碼，完成gitbook的更新。 2.安裝runner到伺服器上

#增加gitlab的yum源倉庫
curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-ci-multi-runner/script.rpm.sh | sudo bash
#yum安裝runner
yum install gitlab-ci-multi-runner

為了把runner新增到gitlab專案中，需要專案的token和gitlab的url，在伺服器上執行如下程式碼：

gitlab-ci-multi-runner register

Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):
your url
Please enter the gitlab-ci token for this runner:
your token
Please enter the gitlab-ci description for this runner:
[opstest]: 
Please enter the gitlab-ci tags for this runner (comma separated):
opsdoc  
Whether to run untagged builds [true/false]:
[false]:true  #此處我選擇的是true，不然每次push還得弄tag 
Whether to lock Runner to current project [true/false]:
[false]: 
Registering runner... succeeded

然後根據提示資訊輸入，具體的token和url在專案的Settings-->CI/CD Pipelines下。 然後你就會在面看到你增加的runner了。記得要Whether to run untagged builds [true/false]:選擇true，不然觸發時會卡住~ 理論上建立完畢之後就會部署一次，可在專案路徑下Pipelines--->Pipelines裡面檢視部署過程。

本文永久更新連結地址：http://www.linuxidc.com/Linux/2017-07/145434.htm