【日常】.gitlab-ci.yml解读
# .job: 定义暗藏的工作Job,该工作不会被Gitlab cicd执行# &template 定义锚点# 暗藏工作联合锚点,能够提供模板给工作Job复用 —— 不可跨文件应用,跨文件思考`!reference`API# .job: &template定义可复用的内容.script_package_install-deploy: &script_package_install-deploy | yarn global add @custom/deploy-tool# docker 镜像image: node:latest# 钩子函数,脚本执行之前须要执行的命令before_script: - npm config set registry https://registry.npm.taobao.org/ - npm config set cache-folder .cache - *script_package_install-deploy# 定义不同的周期阶段,属于同一周期的工作Job并行执行stages: - build - deploy_staging - deploy_preview - deploy_production# .job: &template定义可复用的内容.script_set_env: &script_set_env | if [ "$CI_COMMIT_REF_NAME" == "production" ]; then if [ "$CI_JOB_STAGE" == "deploy_production" ]; then export DEPLOY_ENVIRONMENT=prod else export DEPLOY_ENVIRONMENT=preview fi else [ "$CI_COMMIT_REF_NAME" == "staging" ] export DEPLOY_ENVIRONMENT=staging fi# .job: &template定义可复用的内容# 通过*template应用锚点定义的内容.deploy: &deploy_common script: - *script_set_env - deploy-tool deploy# 定义工作buildbuild: stage: build # 所属周期阶段,同周期的并行执行 cache: # 须要缓存文件 key: $CI_PROJECT_NAME paths: - .cache/**/* - node_modules/**/* script: # 该工作要执行的脚本 - npm i - *script_set_env # 通过*template应用锚点定义的内容 - deploy-tool build only: # 执行机会:staging、production分支push后主动执行 - staging - production# 定义工作deploy_stagingdeploy_staging: stage: deploy_staging # 所属周期阶段,同周期的并行执行 <<: *deploy_common # 通过<<: *template合并锚点定义的内容 environment: # 定义要部署的环境 name: staging only: # 执行机会:staging分支push后主动执行 - staging# 定义工作deploy_previewdeploy_preview: stage: deploy_preview # 所属周期阶段,同周期的并行执行 <<: *deploy_common # 通过<<: *template合并锚点定义的内容 environment: # 定义要部署的环境 name: preview only: # 执行机会:production分支push后主动执行 - production# 定义工作deploy_previewdeploy_production: stage: deploy_production # 所属周期阶段,同周期的并行执行 <<: *deploy_common # 通过<<: *template合并锚点定义的内容 environment: # 定义要部署的环境 name: production when: manual # 手动执行 only: # 因为when的存在,不主动执行了,when默认值on_success - production
*template
vs. <<: *template
*template
:复用的只是工作脚本的其中一个指令<<: *template
:复用的是整个工作脚本
【篇外】如何配置.gitlab-ci.yml
如何定义Job?
只有有script的就是Job?
- 定义在顶层(无缩进),且有script关键字
- 束缚Job何时执行、如何执行
- Job能够创立Job,嵌套
- Job都是独立的执行
stages是做什么的
- 定义Jobs执行的阶段
- 不同的Job能够归属于同一stage
- 同一stage的Jobs并行执行
stages: - build - deploy_staging - deploy_preview - deploy_productionbuild: stage: build // 约定所属stage cache: key: $CI_PROJECT_NAME paths: - .cache/**/* - node_modules/**/* script: - npm i - *script_set_env only: - tags // 打了tag时触发该工作 - staging // 提交staging分支时触发该工作 - production // 提交production分支时触发该工作
Job执行机会
- only/except关键字
- only关键字的默认策略是['branches', 'tags'],即提交了一个分支或者打了标签,就会触发
工作执行程序的策略when
- on_success:默认值,只有后面stages的所有工作胜利时才执行
- on_failure:当后面stages中任意一个jobs失败后执行
- always:无论后面stages中jobs状态如何都执行
- manual:手动执行
- delayed:提早执行
缓存cache
- 指定须要缓存的文件夹或者文件
- cache不能缓存工作门路以外的文件
自定义变量variables
variables:TEST: "HELLO WORLD"job1:script: - echo "$TEST"
复用脚本(锚点)
- https://docs.gitlab.com/ee/ci...