在 GitLab 的持续集成 / 持续交付（CI/CD）配置体系里，“only: - tags” 是一个用于精细控制流水线运行时机的关键设置。
一、基本作用
当项目配置文件（通常是 .gitlab-ci.yml）中出现 “only: - tags” 声明时，其核心目的在于约束与之关联的 CI/CD 流水线的触发条件。具体而言，流水线将不再响应常规的代码提交事件，而是聚焦于那些被打上标签的提交。
二、实际场景示例
想象一个软件开发项目，开发团队在日常开发过程中频繁提交代码。然而，并非每次提交都需要全面触发构建、测试以及部署等一整套 CI/CD 流程。只有当开发阶段达到一个关键里程碑，比如完成了一个功能稳定的版本，准备对外发布时，开发人员会为对应的提交打上一个形如 “v1.0”“release_202309” 之类具有版本标识意义的标签。此时，由于流水线配置了 “only: - tags”，GitLab 检测到带有标签的提交后，便会立即启动预设的一系列任务：
- 构建任务：根据项目需求，可能会将源代码编译成可执行文件，或者将前端代码打包成静态资源文件，确保软件在不同环境下的可运行性与兼容性。
- 测试任务：涵盖单元测试、集成测试甚至用户验收测试等多个层面，全面验证软件功能的正确性、稳定性以及性能表现，只有测试通过的版本才有资格进入后续流程。
- 部署任务：依据项目部署策略，成功通过测试的版本可能会被部署到测试环境、预生产环境乃至生产环境，正式面向用户开放使用。
三、优势与意义
- 资源优化：避免了因频繁的常规提交而过度消耗计算资源、时间成本在不必要的重复构建与测试上，确保资源集中投入到关键版本的处理上。
- 流程精准控制：使得项目团队能够清晰地把控软件发布节奏，只有在精心筹备、完成关键节点任务并标记版本后，才开启全面的自动化流程，提升整体项目管理的严谨性与可控性。
综上所述，“only: - tags” 在 GitLab CI/CD 流程中扮演着精准 “把关人” 的角色，助力项目高效、有序推进。
