基于gitlab-ci的CICD

簡介

gitlab-ci全稱是gitlab continuous integration的意思，也就是持續集成。中心思想是當每一次push到gitlab的時候，都會觸發一次腳本執行，然后腳本的內容包括了測試，編譯，部署等一系列自定義的內容。

自動部署涉及了若干個角色，主要介紹如下

GitLab-CI
這個是一套配合GitLab使用的持續集成系統，是GitLab自帶的，也就是你裝GitLab的那臺服務器上就帶有的。.gitlab-ci.yml的腳本解析就由它來負責。

GitLab-Runner
這個是腳本執行的承載者，.gitlab-ci.yml的script部分的運行就是由runner來負責的。GitLab-CI瀏覽過項目里的.gitlab-ci.yml文件之后，根據里面的規則，分配到各個Runner來運行相應的腳本script。這些腳本有的是測試項目用的，有的是部署用的。

.gitlab-ci.yml
這個是在git項目的根目錄下的一個文件，記錄了一系列的階段和執行規則。GitLab-CI在push后會解析它，根據里面的內容調用runner來運行。

Pipeline
一次 Pipeline 其實相當于一次構建任務，里面可以包含多個流程，如安裝依賴、運行測試、編譯、部署測試服務器、部署生產服務器等流程。

Stages
Stages 表示構建階段，說白了就是上面提到的流程。我們可以在一次 Pipeline 中定義多個 Stages，這些 Stages 會有以下特點：

所有 Stages 會按照順序運行，即當一個 Stage 完成后，下一個 Stage 才會開始

只有當所有 Stages 完成后，該構建任務 (Pipeline) 才會成功

如果任何一個 Stage 失敗，那么后面的 Stages 不會執行，該構建任務 (Pipeline) 失敗

Jobs
Jobs 表示構建工作，表示某個 Stage 里面執行的工作。我們可以在 Stages 里面定義多個 Jobs，這些 Jobs 會有以下特點：
相同 Stage 中的 Jobs 會并行執行
相同 Stage 中的 Jobs 都執行成功時，該 Stage 才會成功
如果任何一個 Job 失敗，那么該 Stage 失敗，即該構建任務 (Pipeline) 失敗

發布流程圖如下：

安裝部署

添加gitlab官方庫

curl -L?https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh?| sudo bash

安裝最新版本的gitlab-runner

yum -y install gitlab-runner

啟動服務

gitlab-runner list 查看各個 Runner 的狀態
gitlab-runner stop 停止服務
gitlab-runner start 啟動服務
gitlab-runner restart 重啟服務

注冊

注冊之前需要先獲取到注冊令牌

1. specific令牌位置為：?gitlab 項目 -> 設置 -> CI / CD -> Runners 設置

share runner令牌位置為：Admin Area -> Runners設置

開始注冊

gitlab-runner? register

[root@localhost ~]# gitlab-runner register

Runtime platform????????????????????????????????????arch=amd64 os=linux pid=1784 revision=577f813d version=12.5.0

Running in system-mode.

##輸入你的Gitlab URL

Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):

http://192.168.60.133/

##輸入注冊令牌來注冊Runner

Please enter the gitlab-ci token for this runner:

SeyTs9_4mKEsYjmfPr4e

##輸入Runner說明

Please enter the gitlab-ci description for this runner:

[localhost]: test

##輸入Runner的tags

Please enter the gitlab-ci tags for this runner (comma separated):

test

Registering runner... succeeded?????????????????????runner=SeyTs9_4

##輸入Runner的執行方式

Please enter the executor: parallels, ssh, virtualbox, docker+machine, custom, docker, docker-ssh, shell, docker-ssh+machine, kubernetes:

shell

Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!

配置文件保存在/etc/gitlab-runner/config.toml

配置項類似下面，可能需要手動添加builds_dir和cache_dir這兩個變量，再重啟服務

[[runners]]

name = "216XX"

url = "https://git.XX.com/"

token = "xxxxxx"

executor = "shell"

builds_dir = "/home/gitlab-runner/builds"

cache_dir = "/home/gitlab-runner/cache"

[runners.cache]

如果要同時處理多個 build 的話，需要進?/etc/gitlab-runner/config.toml?文件配置?concurrent?它的值為 >1 的值

注銷runner:

gitlab-runner? unregister --url https://asdf.com/ci --token 43f334f34f34f34f4

或者

gitlab-runner? unregister --name NAME? ? ?刪除特定的Runner

下面我們去需要發布的項目里面的根目錄編寫.gitlab-ci.yml腳本進行自動發布

.gitlab.-ci.yml文件必須在項目的根目錄進行創建：

stages:
- build
- test
- deploy

#打包階段

? build-job:
? stage: build
? tags:
? - report
? script:
? - mvn clean package -Dmaven.test.skip=true -Pprod
? only:
? - master

#測試階段

test-job:
? stage: test
? tags:
? - report
? script:
? - docker run -d -v $(pwd)/target:/opt/tomcat-8.5/webapps?-p 8099:8080 --name=xxxx? public/tomcat-8.5
? only:
? - master

#手動部署階段

deploy-job:
? stage: deploy
? tags:
? - report
? only:
? - master
??environment:
? name: $report_v
? url: $report_url
? script:
? - echo $(whoami)
? - ssh -p 222 $report_host "/test/apache-tomcat/bin/shutdown.sh"
? - ssh -p 222 $report_host "rm -rf /test/tomcat/webapps/*"
? - scp -P 222 target/report.war $report_host:/test/tomcat/webapps
? - ssh -p 222 $report_host "/test/tomcat/bin/startup.sh"
? when: manual

配置.gitlab-ci.yml文件中用到的變量信息：CI / CD Settings/Variables，也可以直接在.gitlab.-ci.yml文件中指定，這里是為了安全考慮配置在了外面。

在項目的根目錄寫好.gitlab.-ci.yml腳本后就會自動觸發構建部署

我們在jobs里面可以看到執行的狀態，是否執行成功或者報錯。

手動執行部署

需要在手動執行的階段添加參數

when:?manual

這里可以看到build_job階段任務已經執行成功，test_job階段任務等待手動執行部署。

點擊test_job狀態可以查看到執行過程；如果有報錯，這里也可以顯示報錯信息。

接下來我們手動執行部署test_job階段任務。

執行后刷新下，就可以看到已經執行成功了。

上面我們在.gitlab-ci.yml中配置了回滾和手動執行部署任務；接下來我們看看回滾。

回滾

在deploy的任務時，添加參數如下：

environment:
? name:?lims3_v

我們可以看到這里有我們自定義的版本，點進去可以看到之前的歷史記錄。

點擊后面的回滾按鈕即可進行回滾。

Q&A:

報錯如下：

圖1：

原因是git版本太低，升級git版本到2.12之后版本即可。

圖2：

解決方法：

缺少git組件導致，可以重新編譯安裝git

圖3：

是用戶權限問題：

解決方法：chown -R gitlab-runner:gitlab-runner??/home/gitlab-runner