1 持續(xù)集成
gitlab-ci全稱是gitlab continuous integration的意思易茬,也就是持續(xù)集成,中心思想是當每一次push到gitlab的時候或者每隔一定時間,都會觸發(fā)一次腳本(.gitlab-ci.yml)執(zhí)行抽莱,然后腳本的內(nèi)容包括了測試范抓,編譯,部署等一系列自定義的內(nèi)容食铐。
2 GitLab CI相關(guān)概念
- pipeline
:相當于一次構(gòu)建任務(wù)(執(zhí)行腳本)匕垫,面可以包含多個流程,如安裝依賴虐呻、運行測試象泵、編譯、部署測試服務(wù)器斟叼、部署生產(chǎn)服務(wù)器等流程单芜。
+------------------+ +----------------+
| | trigger | |
| Commit / MR +---------->+ Pipeline |
| | | |
+------------------+ +----------------+
- Stages:表示構(gòu)建階段,一次任務(wù)里有多個階段犁柜,這些階段有一下特點:
- 所有 Stages 會按照順序運行洲鸠,即當一個 Stage 完成后,下一個 Stage 才會開始馋缅。
- 只有當所有 Stages 完成后扒腕,該構(gòu)建任務(wù) (Pipeline) 才會成功。
- 如果任何一個 Stage 失敗萤悴,那么后面的 Stages 不會執(zhí)行瘾腰,該構(gòu)建任務(wù) (Pipeline) 失敗。
Stages 和 Pipeline 的關(guān)系就是:
+--------------------------------------------------------+
| |
| Pipeline |
| |
| +-----------+ +------------+ +------------+ |
| | Stage 1 |---->| Stage 2 |----->| Stage 3 | |
| +-----------+ +------------+ +------------+ |
| |
+--------------------------------------------------------+
- Jobs 表示構(gòu)建工作覆履,表示某個 Stage 里面執(zhí)行的工作蹋盆。我們可以在 Stages 里面定義多個 Jobs,這些 Jobs 會有以下特點:
- 相同 Stage 中的 Jobs 會并行執(zhí)行
- 相同 Stage 中的 Jobs 都執(zhí)行成功時硝全,該 Stage 才會成功
- 如果任何一個 Job 失敗栖雾,那么該 Stage 失敗,即該構(gòu)建任務(wù) (Pipeline) 失敗
Jobs 和 Stage 的關(guān)系圖就是:
+------------------------------------------+
| |
| Stage 1 |
| |
| +---------+ +---------+ +---------+ |
| | Job 1 | | Job 2 | | Job 3 | |
| +---------+ +---------+ +---------+ |
| |
+------------------------------------------+
3 編寫.gitlab-ci.yml 文件
實用例子:
######################## 定義以下五個階段 ###########################
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 ###########################
# 運行測試用例
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 ###########################
# 部署測試服務(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
每一個job內(nèi)常用的幾個關(guān)鍵字
關(guān)鍵字 | 是否必須 | 描述 |
---|---|---|
script | Y | 定義一些由Runner執(zhí)行腳本命令 |
stage | N | 定義job的階段 |
before_script | N | 定義job運行前都會執(zhí)行的命令 |
after_script | N | 定義任何 Jobs 運行完后都會執(zhí)行的命令伟众。 |
variables | N | 定義一些變量 |
cache | N | 定義需要緩存的文件 |
only | N | 定義要構(gòu)建工作的分支 |
except | N | 定義要不需要構(gòu)建工作的分支 |
when | N | 定義如何運行下一個階段析藕,參數(shù)有:on_success、 on_failure凳厢、always 账胧、 manual(手動) |
參考:
http://scarletsky.github.io/2016/07/29/use-gitlab-ci-for-continuous-integration/