1 持續(xù)集成
gitlab-ci全稱是gitlab continuous integration的意思,也就是持續(xù)集成,中心思想是當(dāng)每一次push到gitlab的時(shí)候或者每隔一定時(shí)間,都會(huì)觸發(fā)一次腳本(.gitlab-ci.yml)執(zhí)行,然后腳本的內(nèi)容包括了測(cè)試,編譯,部署等一系列自定義的內(nèi)容。
2 GitLab CI相關(guān)概念
- pipeline
:相當(dāng)于一次構(gòu)建任務(wù)(執(zhí)行腳本),面可以包含多個(gè)流程,如安裝依賴、運(yùn)行測(cè)試、編譯、部署測(cè)試服務(wù)器、部署生產(chǎn)服務(wù)器等流程。
+------------------+ +----------------+
| | trigger | |
| Commit / MR +---------->+ Pipeline |
| | | |
+------------------+ +----------------+
- Stages:表示構(gòu)建階段,一次任務(wù)里有多個(gè)階段,這些階段有一下特點(diǎn):
- 所有 Stages 會(huì)按照順序運(yùn)行,即當(dāng)一個(gè) Stage 完成后,下一個(gè) Stage 才會(huì)開始。
- 只有當(dāng)所有 Stages 完成后,該構(gòu)建任務(wù) (Pipeline) 才會(huì)成功。
- 如果任何一個(gè) Stage 失敗,那么后面的 Stages 不會(huì)執(zhí)行,該構(gòu)建任務(wù) (Pipeline) 失敗。
Stages 和 Pipeline 的關(guān)系就是:
+--------------------------------------------------------+
| |
| Pipeline |
| |
| +-----------+ +------------+ +------------+ |
| | Stage 1 |---->| Stage 2 |----->| Stage 3 | |
| +-----------+ +------------+ +------------+ |
| |
+--------------------------------------------------------+
- Jobs 表示構(gòu)建工作,表示某個(gè) Stage 里面執(zhí)行的工作。我們可以在 Stages 里面定義多個(gè) Jobs,這些 Jobs 會(huì)有以下特點(diǎn):
- 相同 Stage 中的 Jobs 會(huì)并行執(zhí)行
- 相同 Stage 中的 Jobs 都執(zhí)行成功時(shí),該 Stage 才會(huì)成功
- 如果任何一個(gè) Job 失敗,那么該 Stage 失敗,即該構(gòu)建任務(wù) (Pipeline) 失敗
Jobs 和 Stage 的關(guān)系圖就是:
+------------------------------------------+
| |
| Stage 1 |
| |
| +---------+ +---------+ +---------+ |
| | Job 1 | | Job 2 | | Job 3 | |
| +---------+ +---------+ +---------+ |
| |
+------------------------------------------+
3 編寫.gitlab-ci.yml 文件
實(shí)用例子:
######################## 定義以下五個(gè)階段 ###########################
stages:
- install_deps
- test
- build
- deploy_test
- deploy_production
#加載緩存
cache:
key: ${CI_BUILD_REF_NAME}
paths:
- node_modules/
- dist/
######################## job ###########################
# 安裝依賴
install_deps:
stage: install_deps
only:
- develop
- master
script:
- npm install
######################## job ###########################
# 運(yùn)行測(cè)試用例
test:
stage: test
only:
- develop
- master
script:
- npm run test
######################## job ###########################
# 編譯
build:
stage: build
only:
- develop
- master
script:
- npm run clean
- npm run build:client
- npm run build:server
######################## job ###########################
# 部署測(cè)試服務(wù)器
deploy_test:
stage: deploy_test
only:
- develop
script:
- pm2 delete app || true
- pm2 start app.js --name app
######################## job ###########################
# 部署生產(chǎn)服務(wù)器
deploy_production:
stage: deploy_production
only:
- master
script:
- bash scripts/deploy/deploy.sh
每一個(gè)job內(nèi)常用的幾個(gè)關(guān)鍵字
| 關(guān)鍵字 | 是否必須 | 描述 |
|---|---|---|
| script | Y | 定義一些由Runner執(zhí)行腳本命令 |
| stage | N | 定義job的階段 |
| before_script | N | 定義job運(yùn)行前都會(huì)執(zhí)行的命令 |
| after_script | N | 定義任何 Jobs 運(yùn)行完后都會(huì)執(zhí)行的命令。 |
| variables | N | 定義一些變量 |
| cache | N | 定義需要緩存的文件 |
| only | N | 定義要構(gòu)建工作的分支 |
| except | N | 定義要不需要構(gòu)建工作的分支 |
| when | N | 定義如何運(yùn)行下一個(gè)階段,參數(shù)有:on_success、 on_failure、always 、 manual(手動(dòng)) |
參考:
http://scarletsky.github.io/2016/07/29/use-gitlab-ci-for-continuous-integration/