|
# 流水线设置[](#pipeline-settings "Permalink")
|
|
# 流水线设置[](#pipeline-settings "Permalink")
|
|
|
|
|
|
要访问流水线设置,请导航至项目的**"设置">" CI/CD"** 。
|
|
要访问流水线设置,请导航至项目的**设置 > DevOps** 。
|
|
|
|
|
|
可以为每个项目配置以下设置.
|
|
可以为每个项目配置以下设置。
|
|
|
|
|
|
你可以使用流水线状态来确定是否可以合并合并请求:
|
|
你可以使用流水线状态来确定是否可以合并合并请求:
|
|
|
|
|
|
- [流水线成功时合并](../../user/project/merge_requests/merge_when_pipeline_succeeds)。
|
|
- 流水线成功时合并。
|
|
- [仅当流水线成功时才允许合并合并请求](../../user/project/merge_requests/merge_when_pipeline_succeeds#only-allow-merge-requests-to-be-merged-if-the-pipeline-succeeds)。
|
|
- 仅当流水线成功时才允许合并合并请求。
|
|
|
|
|
|
## Git 策略[](#git-strategy "Permalink")
|
|
## Git 策略[](#git-strategy "Permalink")
|
|
|
|
|
... | @@ -24,7 +24,7 @@ |
... | @@ -24,7 +24,7 @@ |
|
|
|
|
|
克隆仓库时,可以限制 CODECHINA CI/CD 获取的更改数量。设置限制`git depth`可以加快流水线的执行。
|
|
克隆仓库时,可以限制 CODECHINA CI/CD 获取的更改数量。设置限制`git depth`可以加快流水线的执行。
|
|
|
|
|
|
**注意:**新创建的项目自动具有默认的`git depth`值`50`,最大允许值为`1000`。
|
|
**注意**:新创建的项目自动具有默认的`git depth`值`50`,最大允许值为`1000`。
|
|
|
|
|
|
要禁用浅克隆并使 CODECHINA CI/CD 每次获取所有分支和标签,请将值保留为空或设置为`0` 。
|
|
要禁用浅克隆并使 CODECHINA CI/CD 每次获取所有分支和标签,请将值保留为空或设置为`0` 。
|
|
|
|
|
... | @@ -33,12 +33,12 @@ |
... | @@ -33,12 +33,12 @@ |
|
## 超时[](#timeout "Permalink")
|
|
## 超时[](#timeout "Permalink")
|
|
|
|
|
|
超时定义了流水线任务可以运行的最长时间(以分钟为单位)。
|
|
超时定义了流水线任务可以运行的最长时间(以分钟为单位)。
|
|
这可以在项目的**设置> DevOps >流水线通用设置**下进行配置 。
|
|
这可以在项目的 **设置> DevOps >流水线通用设置**下进行配置 。
|
|
默认值为 60 分钟。 如果要对流水线任务的运行时间施加硬性限制,则减少时间限制,否则就增加时间限制。在任何情况下,如果流水线任务超过阈值,则将其标记为失败。
|
|
默认值为 60 分钟。 如果要对流水线任务的运行时间施加硬性限制,则减少时间限制,否则就增加时间限制。在任何情况下,如果流水线任务超过阈值,则将其标记为失败。
|
|
|
|
|
|
### Runner 超时覆盖[](#timeout-overriding-on-runner-level "Permalink")
|
|
### Runner 超时覆盖[](#timeout-overriding-on-runner-level "Permalink")
|
|
|
|
|
|
项目定义的超时(用户设置的特定超时或默认的 60 分钟超时)可能会被[Runner 覆盖](/docs/ci/runnersl#set-maximum-job-timeout-for-a-runner)。
|
|
项目定义的超时(用户设置的特定超时或默认的 60 分钟超时)可能会被[Runner 覆盖](/docs/ci/runners#set-maximum-job-timeout-for-a-runner)。
|
|
|
|
|
|
## 自定义 CI/CD 配置路径[](#custom-ci-configuration-path "Permalink")
|
|
## 自定义 CI/CD 配置路径[](#custom-ci-configuration-path "Permalink")
|
|
|
|
|
... | @@ -46,12 +46,12 @@ |
... | @@ -46,12 +46,12 @@ |
|
|
|
|
|
自定义路径:
|
|
自定义路径:
|
|
|
|
|
|
1. 转到项目的**设置> DevOps** 。
|
|
1. 转到项目的 **设置> DevOps** 。
|
|
2. 展开**流水线通用**部分。
|
|
2. 展开**流水线通用设置**部分。
|
|
3. 在 **CI/CD 配置文件"**字段中提供一个值。
|
|
3. 在 **CI/CD 配置文件**字段中提供一个值。
|
|
4. 点击 **保存更改**。
|
|
4. 点击 **保存更改**。
|
|
|
|
|
|
如果 CI 配置在非默认位置存储在资源库中,则该路径必须相对于根目录. 有效路径和文件名的示例包括:
|
|
如果 CI 配置在非默认位置存储在资源库中,则该路径必须相对于根目录。 有效路径和文件名的示例包括:
|
|
|
|
|
|
* `.codechina-ci.yml` (默认)
|
|
* `.codechina-ci.yml` (默认)
|
|
* `.my-custom-file.yml`
|
|
* `.my-custom-file.yml`
|
... | @@ -77,11 +77,11 @@ |
... | @@ -77,11 +77,11 @@ |
|
## 测试覆盖率解析[](#test-coverage-parsing "Permalink")
|
|
## 测试覆盖率解析[](#test-coverage-parsing "Permalink")
|
|
|
|
|
|
如果你在代码中使用测试覆盖率,则 CODECHINA 可以使用正则表达式将其输出捕获到流水线任务日志中。
|
|
如果你在代码中使用测试覆盖率,则 CODECHINA 可以使用正则表达式将其输出捕获到流水线任务日志中。
|
|
在项目中,转到**设置> DevOps**并展开**流水线通用**部分,在"测试覆盖解析"字段中输入正则表达式。
|
|
在项目中,转到 **设置> DevOps** 并展开**流水线通用设置**部分,在**测试覆盖解析**字段中输入正则表达式。
|
|
|
|
|
|
如果要禁用它或输入 Ruby 正则表达式,请保留空白. 你可以使用[https://rubular.com](https://rubular.com)来测试你的正则表达式。 正则表达式返回在输出中找到的**最后一个**匹配项。
|
|
如果要禁用它或输入 Ruby 正则表达式,请保留空白。你可以使用[https://rubular.com](https://rubular.com)来测试你的正则表达式。 正则表达式返回在输出中找到的**最后一个**匹配项。
|
|
|
|
|
|
如果流水线成功,则覆盖范围将显示在合并请求窗口小部件和流水线任务表中.如果流水线中的多个流水线任务具有覆盖率报告,则对它们进行平均。
|
|
如果流水线成功,则覆盖范围将显示在合并请求窗口小部件和流水线任务表中。如果流水线中的多个流水线任务具有覆盖率报告,则对它们进行平均。
|
|
|
|
|
|
[![MR widget coverage](/docs/img/pipelines_test_coverage_mr_widget.png)](/docs/img/pipelines_test_coverage_mr_widget.png)
|
|
[![MR widget coverage](/docs/img/pipelines_test_coverage_mr_widget.png)](/docs/img/pipelines_test_coverage_mr_widget.png)
|
|
|
|
|
... | @@ -93,8 +93,8 @@ |
... | @@ -93,8 +93,8 @@ |
|
|
|
|
|
如果你想查看项目代码覆盖率随时间的变化,则可以查看图形或下载包含此数据的 CSV 文件。 从你的项目中:
|
|
如果你想查看项目代码覆盖率随时间的变化,则可以查看图形或下载包含此数据的 CSV 文件。 从你的项目中:
|
|
|
|
|
|
1. 去 **项目分析>存储库,**以查看图表上方下拉列表中列出的每个流水线任务的历史数据。
|
|
1. 去 **项目分析 >存储库**,以查看图表上方下拉列表中列出的每个流水线任务的历史数据。
|
|
2. 如果你想要该数据的 CSV 文件,请点击**下载原始数据(.csv)**
|
|
2. 如果你想要该数据的 CSV 文件,请点击**下载原始数据(.csv)**。
|
|
|
|
|
|
[![Code coverage graph of a project over time](/docs/img/code_coverage_graph_v13_1.png)](img/code_coverage_graph_v13_1.png)
|
|
[![Code coverage graph of a project over time](/docs/img/code_coverage_graph_v13_1.png)](img/code_coverage_graph_v13_1.png)
|
|
|
|
|
... | @@ -115,9 +115,9 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
... | @@ -115,9 +115,9 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
流水线可见性由以下因素决定:
|
|
流水线可见性由以下因素决定:
|
|
|
|
|
|
* 你当前的[用户访问级别](/docs/user/permissions) 。
|
|
* 你当前的[用户访问级别](/docs/user/permissions) 。
|
|
* 项目**设置> DevOps >流水线通用**下的**公开流水线**项目设置。
|
|
* 项目**设置> DevOps >流水线通用设置**下的**公开流水线**项目设置。
|
|
|
|
|
|
**注意:**如果项目可见性设置为" **私有"** ,则" [**公开流水线"**设置将无效](../enable_or_disable_ci.html#per-project-user-setting) 。
|
|
**注意:**如果项目可见性设置为 **私有** ,则 **公开流水线** 设置将无效 。
|
|
|
|
|
|
这也决定了这些相关功能的可见性:
|
|
这也决定了这些相关功能的可见性:
|
|
|
|
|
... | @@ -125,7 +125,7 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
... | @@ -125,7 +125,7 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
* 工作文物
|
|
* 工作文物
|
|
* 流水线的安全仪表板
|
|
* 流水线的安全仪表板
|
|
|
|
|
|
**注意:**当前访客用户和非项目成员尚看不到流水线任务日志和工件。
|
|
**注意**:当前访客用户和非项目成员尚看不到流水线任务日志和工件。
|
|
|
|
|
|
如果启用了**公开流水线** (默认):
|
|
如果启用了**公开流水线** (默认):
|
|
|
|
|
... | @@ -143,12 +143,12 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
... | @@ -143,12 +143,12 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
|
|
|
|
如果你希望每次创建新流水线时(例如在 Git 推送之后或从 UI 手动创建)自动取消分支上所有挂起或正在运行的流水线,可以在项目设置中启用此功能:
|
|
如果你希望每次创建新流水线时(例如在 Git 推送之后或从 UI 手动创建)自动取消分支上所有挂起或正在运行的流水线,可以在项目设置中启用此功能:
|
|
|
|
|
|
1. 去 **设置> DevOps** 。
|
|
1. 去 **设置 > DevOps** 。
|
|
2. 展开 **流水线通用**。
|
|
2. 展开 **流水线通用设置**。
|
|
3. 选中**自动取消冗余流水线**复选框。
|
|
3. 选中**自动取消冗余流水线**复选框。
|
|
4. 点击 **保存更改**。
|
|
4. 点击 **保存更改**。
|
|
|
|
|
|
请注意,使用[`interruptible`](../yaml/README.html#interruptible)关键字指示是否可以在完成之前取消正在运行的流水线任务。
|
|
请注意,使用[`interruptible`](/docs/ci/yaml.md#interruptible)关键字指示是否可以在完成之前取消正在运行的流水线任务。
|
|
|
|
|
|
## 跳过过时的部署流水线任务[](#skip-outdated-deployment-jobs "Permalink")
|
|
## 跳过过时的部署流水线任务[](#skip-outdated-deployment-jobs "Permalink")
|
|
|
|
|
... | @@ -159,7 +159,7 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
... | @@ -159,7 +159,7 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
为了避免这种情况:
|
|
为了避免这种情况:
|
|
|
|
|
|
1. 去 **设置> DevOps** 。
|
|
1. 去 **设置> DevOps** 。
|
|
2. 展开 **流水线通用**。
|
|
2. 展开 **流水线通用设置**。
|
|
3. 选中**跳过过时的部署流水线任务**复选框。
|
|
3. 选中**跳过过时的部署流水线任务**复选框。
|
|
4. 点击 **保存更改**。
|
|
4. 点击 **保存更改**。
|
|
|
|
|
... | | ... | |