.gitlab-ci.yml关键词概览解析（三）

### .gitlab-ci.yml 关键字详解 #### 1. 配置文件概述 `.gitlab-ci.yml` 是 GitLab CI/CD 中的核心配置文件，用于定义项目的构建、测试和部署流程。它基于 YAML 格式编写，因此需要注意缩进规则以及语法准确性。 #### 2. 常见关键字及其作用 ##### (1) `stages` `stages` 定义了流水线的不同阶段顺序，这些阶段决定了作业的执行次序。每个作业都必须属于某个特定的阶段。 ```yaml stages: - build - test - deploy ``` 上述例子表明流水线分为三个阶段：build、test 和 deploy[^1]。 ##### (2) `job` `job` 表示具体的任务单元，在 `.gitlab-ci.yml` 文件中通常以独立的部分表示。每一个 job 至少需要指定一个 stage 属性来决定其所属阶段。 ```yaml my_job: stage: test script: - echo "Running my job" ``` 此部分展示了名为 `my_job` 的 task 将会在 `test` 阶段被执行，并打印一条消息到控制台[^2]。 ##### (3) `script` `script` 字段指定了实际运行的一系列命令或者脚本。这是最基础也是最重要的字段之一。 ```yaml rspec: script: - bundle install - rake db:create RAILS_ENV=test - rails spec ``` 这里展示了一个典型的 Ruby 测试环境设置过程[^4]。 ##### (4) `artifacts` 当某些 jobs 结束后可能希望保存一些产物供后续使用或下载查看时可以利用 artifact 功能。例如生成的日志文件或者其他二进制数据等都可以作为 artifacts 被保留下来。 ```yaml build_artifact: ... artifacts: paths: - public/ expire_in: '1 week' ``` 上面的例子设置了路径下的所有内容会被打包成压缩包并存储一周时间[^3]。 ##### (5) `cache` 为了加速重复性的操作比如依赖安装可以通过缓存机制实现减少冗余计算量的目的。 ```yaml caching_example: cache: key: "$CI_COMMIT_REF_SLUG" paths: - vendor/ruby script: - gem install bundler && bundle install --path=vendor/ruby ``` 这段代码片段说明如果存在相同的分支名称则会尝试加载已存在的 gems 缓存从而加快第二次及以后的构建速度。 ##### (6) 特殊字符处理（针对 Windows） 由于操作系统差异，在 windows 平台上运行 yaml 脚本时需注意特殊变量符号 `$` 应改为 `%` 来适应 cmd 解析器的要求。 ```yaml windows_specific_job: artifacts: name: "%CI_JOB_STAGE%_%CI_COMMIT_REF_NAME%" untracked: true ``` 此处演示了如何修改默认行为使得能够在 windows 下正常工作。 --- ###