自定义流水线配置
Tier: 基础版，专业版，旗舰版
Offering: JihuLab.com，私有化部署
你可以自定义项目的流水线运行方式。
更改可以查看流水线的用户
对于公开和内部项目，你可以更改谁可以查看：
- 流水线
- 作业输出日志
- 作业产物
- 流水线安全结果
要更改流水线及相关功能的可见性：
- 在顶部栏中，选择 搜索或跳转到 并找到你的项目。
- 在左侧边栏中，选择 设置 > CI/CD。
- 展开 通用流水线。
- 选中或清除 基于项目的流水线可见性 复选框。 选中时，流水线和相关功能可见：
更改公开项目中非项目成员的流水线可见性
你可以控制 公开项目 中非项目成员的流水线可见性。
以下情况下此设置无效：
- 项目可见性设置为 内部 或 私有，因为非项目成员无法访问内部或私有项目。
- 基于项目的流水线可见性 设置被禁用。
要更改非项目成员的流水线可见性：
- 在顶部栏中，选择 搜索或跳转到 并找到你的项目。
- 在左侧边栏中，选择 设置 > 通用。
- 展开 可见性、项目功能、权限。
- 对于 CI/CD，选择：
- 仅项目成员：仅项目成员可以查看流水线。
- 所有有访问权限的人：非项目成员也可以查看流水线。
- 选择 保存更改。
CI/CD 权限表 列出了当选择 所有有访问权限的人 时非项目成员可以访问的流水线功能。
自动取消冗余流水线
你可以设置当同一分支上有新更改的流水线运行时，自动取消挂起或正在运行的流水线。你可以在项目设置中启用此功能：
- 在顶部栏中，选择 搜索或跳转到 并找到你的项目。
- 在左侧边栏中，选择 设置 > CI/CD。
- 展开 通用流水线。
- 选中 自动取消冗余流水线 复选框。
- 选择 保存更改。
使用 interruptible 关键字来指示正在运行的作业是否可以在完成前取消。当带有 interruptible: false 的作业开始后，整个流水线不再被视为可中断。
防止过时的部署作业
你的项目可能有多个并发的部署作业计划在同一时间范围内运行。 这可能导致较旧的部署作业在较新的部署作业之后运行，这可能不是你想要的结果。 为避免这种情况：
- 在顶部栏中，选择 搜索或跳转到 并找到你的项目。
- 在左侧边栏中，选择 设置 > CI/CD。
- 展开 通用流水线。
- 选中 防止过时的部署作业 复选框。
- 可选。清除 允许回滚部署的作业重试 复选框。
- 选择 保存更改。
更多信息，请参见 部署安全。
限制可以取消流水线或作业的角色
Tier: 专业版，旗舰版
Offering: JihuLab.com，私有化部署
版本历史
- 在 极狐GitLab 16.7 中引入。
你可以自定义哪些角色有权取消流水线或作业。 默认情况下，具有开发者、维护者或所有者角色的用户可以取消流水线或作业。 你可以将取消权限限制为仅具有维护者或所有者角色的用户，或者完全阻止取消任何流水线或作业。
要更改取消流水线或作业的权限：
- 在顶部栏中，选择 搜索或跳转到 并找到你的项目。
- 在左侧边栏中，选择 设置 > CI/CD。
- 展开 通用流水线。
- 从 取消流水线或作业所需的最低角色 中选择一个选项。
- 选择 保存更改。
指定自定义 CI/CD 配置文件
极狐GitLab 期望在项目的根目录中找到 CI/CD 配置文件（.gitlab-ci.yml）。但是，你可以指定一个替代的文件名路径，包括项目外部的位置。
要自定义路径：
- 在顶部栏中，选择 搜索或跳转到 并找到你的项目。
- 在左侧边栏中，选择 设置 > CI/CD。
- 展开 通用流水线。
- 在 CI/CD 配置文件 字段中，输入文件名。如果文件：
- 不在根目录中，请包含路径。
- 在其他项目中，请包含群组和项目名称。
- 在外部站点上，请输入完整的 URL。
- 选择 保存更改。
你不能使用项目的 流水线编辑器 来编辑其他项目或外部站点上的 CI/CD 配置文件。
自定义 CI/CD 配置文件示例
如果 CI/CD 配置文件不在根目录中，则路径必须相对于根目录。例如：
- my/path/.gitlab-ci.yml
- my/path/.my-custom-file.yml
如果 CI/CD 配置文件在外部站点上，则 URL 必须以 .yml 结尾：
- http://example.com/generate/ci/config.yml
如果 CI/CD 配置文件在其他项目中：
- 文件必须存在于其默认分支上，或者将分支指定为 refname。
- 路径必须相对于其他项目中的根目录。
- 路径后必须跟一个 @ 符号以及完整的群组和项目路径。
例如：
- .gitlab-ci.yml@namespace/another-project
- my/path/.my-custom-file.yml@namespace/subgroup/another-project
- my/path/.my-custom-file.yml@namespace/subgroup1/subgroup2/another-project:refname
如果配置文件在单独的项目中，你可以设置更精细的权限。例如：
- 创建一个公开项目来托管配置文件。
- 仅向允许编辑该文件的用户授予项目的写入权限。 然后其他用户和项目可以访问配置文件，但无法编辑它。
选择默认的 Git 策略
你可以选择在作业运行时如何从极狐GitLab 获取仓库。
- 在顶部栏中，选择 搜索或跳转到 并找到你的项目。
- 在左侧边栏中，选择 设置 > CI/CD。
- 展开 通用流水线。
- 在 Git 策略 下，选择一个选项：
- git clone 较慢，因为它为每个作业从头克隆仓库。但是，本地工作副本始终是干净的。
- git fetch 更快，因为它重用本地工作副本（如果不存在则回退到克隆）。建议使用，特别是对于 大型仓库。
配置的 Git 策略可以被 .gitlab-ci.yml 文件中的 GIT_STRATEGY 变量 覆盖。
限制克隆期间获取的更改数量
你可以限制极狐GitLab CI/CD 在克隆仓库时获取的更改数量。
- 在顶部栏中，选择 搜索或跳转到 并找到你的项目。
- 在左侧边栏中，选择 设置 > CI/CD。
- 展开 通用流水线。
- 在 Git 策略 下的 Git 浅克隆 中，输入一个值。 最大值为 1000。要禁用浅克隆并使极狐GitLab CI/CD 每次获取所有分支和标签，请将值留空或设置为 0。
新创建的项目默认的 git depth 值为 20。
此值可以被 .gitlab-ci.yml 文件中的 GIT_DEPTH 变量 覆盖。
设置作业运行时长限制
你可以定义作业在超时前可以运行多长时间。
- 在顶部栏中，选择 搜索或跳转到 并找到你的项目。
- 在左侧边栏中，选择 设置 > CI/CD。
- 展开 通用流水线。
- 在 超时 字段中，输入分钟数，或像 2 hours 这样的人类可读值。 必须为 10 分钟或以上，且少于一个月。默认值为 60 分钟。 挂起的作业在 24 小时无活动后会被丢弃。
超过超时时间的作业会被标记为失败。
当同时设置了项目超时和 Runner 超时 时，以较低值为准。
无论超时设置如何，一小时内没有输出的作业都会被丢弃。为防止这种情况发生，请添加一个脚本以持续输出进度。
流水线徽章
你可以使用 流水线徽章 来指示项目的流水线状态和测试覆盖率。这些徽章由最新的成功流水线决定。
禁用极狐GitLab CI/CD 流水线
极狐GitLab CI/CD 流水线在所有新项目中默认启用。如果你使用外部 CI/CD 服务器（如 Jenkins 或 Drone CI），可以禁用极狐GitLab CI/CD 以避免与提交状态 API 冲突。
你可以按项目禁用极狐GitLab CI/CD，或 针对实例上的所有新项目禁用。
禁用极狐GitLab CI/CD 后：
- 左侧边栏中的 CI/CD 项被移除。
- /pipelines 和 /jobs 页面不再可用。
- 现有的作业和流水线被隐藏，而非删除。
要在项目中禁用极狐GitLab CI/CD：
- 在顶部栏中，选择 搜索或跳转到 并找到你的项目。
- 在左侧边栏中，选择 设置 > 通用。
- 展开 可见性、项目功能、权限。
- 在 仓库 部分，关闭 CI/CD。
- 选择 保存更改。
这些更改不适用于 外部集成 中的项目。
自动流水线清理
Tier: 基础版，专业版，旗舰版
Offering: JihuLab.com，私有化部署
版本历史
- 在 极狐GitLab 17.7 中引入，带有一个名为 ci_delete_old_pipelines 的 功能标志。默认禁用。
- 功能标志 ci_delete_old_pipelines 在 极狐GitLab 17.9 中移除。
具有所有者角色的用户可以设置 CI/CD 流水线过期时间，以帮助管理流水线存储并提高系统性能。 系统会自动删除在配置值之前创建的流水线。
- 在顶部栏中，选择 搜索或跳转到 并找到你的项目。
- 在左侧边栏中，选择 设置 > CI/CD。
- 展开 通用流水线。
- 在 自动流水线清理 字段中，输入秒数，或像 2 weeks 这样的人类可读值。 必须为一天或以上，且少于一年。留空则永不自动删除流水线。 默认为空。
- 选择 保存更改。
对于极狐GitLab 私有化部署，管理员可以提高 自动流水线清理 的上限。