工作中第一次用到gitlab自带的cicd， 记录一下备忘
GitLab CI/CD 配置文件 (.gitlab-ci.yml) 中有许多关键字，用于定义不同的行为和阶段。以下是一些常见且重要的关键字：
全局和 job 特定关键字
-
image
指定运行 CI job 时的 Docker 镜像。image: node:16 -
services
为 job 提供的额外的服务容器，如数据库或缓存服务。services:- postgres:latest -
stages
定义 job 的阶段，例如build、test、deploy等。stages:- build- test- deploy -
script
定义 job 中实际执行的命令。script:- npm install- npm run test -
after_script
在 job 结束后执行的命令（无论成功与否）。after_script:- echo "This runs after the job finishes" -
only/except
用于控制 job 在特定的分支或提交时执行。only:- master- tags except:- develop -
variables
定义环境变量，支持全局和 job 级别。variables:NODE_ENV: "production" -
cache
缓存依赖文件或其他生成的文件，以加速后续的 pipeline 执行。cache:paths:- node_modules/ -
artifacts
定义 job 生成的工件，能够在 pipeline 的后续 job 中使用。artifacts:paths:- build/ -
dependencies
明确指出某个 job 依赖于哪个前面的 job 的artifacts。dependencies:- build_job
其他常用关键字
-
before_script
在script执行之前运行的命令。 -
stage
定义 job 属于哪个阶段，必须与stages中的值对应。stage: build -
retry
当 job 失败时自动重试的次数。retry: 2 -
timeout
指定 job 最大运行时间，超时后自动失败。timeout: 20m -
tags
用于指定在哪些 GitLab Runner 上运行 job，通常用于选择特定的 runner。tags:- docker -
allow_failure
允许某个 job 失败，不会导致整个 pipeline 失败。allow_failure: true -
when
控制 job 在何时执行，默认是on_success，可以设置为manual、always等。when: manual -
extends
允许从预定义的 job 模板或设置中继承配置。.base_job:script:- echo "Base job"my_job:extends: .base_job
文件示例
下面是一个包含尽可能多关键字和功能的标准 GitLab CI/CD 配置文件示例，展示了如何使用多个关键字来管理和优化 CI/CD 流程。这个例子展示了从代码构建、测试、缓存、工件管理到自动部署等多方面的功能。
# 全局配置
stages: # 定义各个阶段- setup- build- test- deployvariables: # 全局变量设置NODE_ENV: "development"PACKAGE_VERSION: "1.0.0"GIT_SUBMODULE_STRATEGY: "recursive" # 设置git子模块策略before_script: # 全局的before_script，适用于所有job- echo "Setting up the environment"- apt-get update -y- apt-get install -y python3-pip# Cache设置，适用于所有的job
cache:paths:- node_modules/- .cache/pipsetup_job: # setup 阶段的 jobstage: setupimage: node:16script:- npm installartifacts:paths:- node_modules/build_job: # build 阶段的 jobstage: buildimage: node:16script:- npm run buildartifacts:paths:- dist/expire_in: 1 week # 设置 artifacts 的过期时间test_job: # test 阶段的 jobstage: testimage: node:16dependencies: # 声明依赖于 build_job 的 artifacts- build_jobscript:- npm run testcache: # 局部 cache 配置，覆盖全局配置paths:- .cache/test_python: # 另一个 test 阶段的 job，用 Python 执行测试stage: testimage: python:3.9script:- pip install -r requirements.txt- pytestartifacts:paths:- test-reports/reports:junit: test-reports/report.xml # 生成 JUnit 格式的测试报告manual_deploy: # deploy 阶段的 job，手动执行stage: deployscript:- echo "Deploying to production server..."when: manual # 手动触发only:- masterauto_deploy: # 自动部署，允许失败stage: deployscript:- echo "Deploying to staging server..."environment: # 设置环境变量name: stagingurl: https://staging.example.comallow_failure: true # 部署失败不影响 pipeline 成功状态pages: # 使用 GitLab Pages 部署静态站点stage: deployscript:- echo "Building static pages"- mkdir .public- echo "<html><body><h1>My Project</h1></body></html>" > .public/index.htmlartifacts:paths:- .publiconly:- masterretry_example: # 设置失败后自动重试stage: testscript:- echo "This will retry on failure"- exit 1retry: 2 # 失败时重试2次timeout_example: # 设置超时stage: testscript:- echo "This job has a timeout"- sleep 120timeout: 1m # 超时时间1分钟# 使用extends继承配置
.base_job_template: # 定义一个基础job模板image: alpine:latestbefore_script:- echo "This is before script from base template"script:- echo "Running from base template"my_extended_job:extends: .base_job_template # 继承模板script:- echo "This is an extended job"# Docker in Docker 服务示例
docker_build:stage: buildimage: docker:latestservices:- docker:dind # 使用 Docker in Dockerscript:- docker build -t myapp .only_master_branch: # 只在 master 分支上运行的 jobstage: testscript:- echo "This runs only on the master branch"only:- masterexcept_develop_branch: # 除了 develop 分支外，所有分支都运行的 jobstage: testscript:- echo "This runs on all branches except develop"except:- develop
文件说明：
-
全局设置：
stages：定义 CI/CD 流水线的不同阶段。variables：定义全局变量。before_script：全局的前置脚本，适用于所有 job。cache：全局的缓存配置，指定缓存的目录。
-
job 示例：
setup_job：安装依赖并缓存node_modules/。build_job：构建项目，并将构建产物存储为 artifacts。test_job和test_python：分别测试 JavaScript 和 Python 项目，生成 JUnit 格式报告。
-
部署：
manual_deploy：手动触发部署，仅在master分支上执行。auto_deploy：自动部署至staging环境，允许失败。pages：通过 GitLab Pages 部署静态站点。
-
特殊功能：
retry_example：在 job 失败时自动重试两次。timeout_example：设置了超时时间为1分钟的 job。my_extended_job：演示了如何使用extends关键字继承另一个 job 模板。docker_build：使用docker:dind服务运行 Docker in Docker。
-
条件执行：
only_master_branch：仅在master分支上运行。except_develop_branch：除develop分支外在所有分支上运行。
这个 .gitlab-ci.yml 文件展示了 GitLab CI/CD 的广泛功能，几乎涵盖了实际使用中常见的场景。你可以根据项目需求定制每个 job 和关键字的使用。