|
|
|
# 流水线设置[](#pipeline-settings "Permalink")
|
|
|
|
|
|
|
|
要访问流水线设置，请导航至项目的**"设置">" CI/CD"** .
|
|
|
|
要访问流水线设置，请导航至项目的**"设置">" CI/CD"** 。
|
|
|
|
|
|
|
|
可以为每个项目配置以下设置.
|
|
|
|
|
| ... | ... | @@ -11,47 +11,49 @@ |
|
|
|
|
|
|
|
## Git 策略[](#git-strategy "Permalink")
|
|
|
|
|
|
|
|
使用 Git 策略，您可以选择从作业中的 CODECHINA 提取存储库的默认方式.
|
|
|
|
使用 Git 策略，您可以选择从作业中的 CODECHINA 提取存储库的默认方式。
|
|
|
|
|
|
|
|
有两种选择. 使用：
|
|
|
|
有两种选择。使用：
|
|
|
|
|
|
|
|
* `git clone` ，速度较慢，因为它会为每个作业从头开始克隆存储库，以确保本地工作副本始终是原始的.
|
|
|
|
* `git fetch` ，它更快地重新使用本地工作副本（如果不存在，则回退为克隆）.
|
|
|
|
* `git clone` ，速度较慢，因为它会为每个作业从头开始克隆存储库，以确保本地工作副本始终是原始的。
|
|
|
|
* `git fetch` ，它更快地重新使用本地工作副本（如果不存在，则回退为克隆）。
|
|
|
|
|
|
|
|
默认的 Git 策略可以由`.codechina-ci.yml`的[GIT_STRATEGY 变量](../yaml/README.html#git-strategy)覆盖.
|
|
|
|
默认的 Git 策略可以由`.codechina-ci.yml`的 GIT_STRATEGY 变量覆盖。
|
|
|
|
|
|
|
|
## Git 浅克隆[](#git-shallow-clone "Permalink")
|
|
|
|
|
|
|
|
克隆存储库时，可以限制 CODECHINA CI/CD 获取的更改数量。设置限制`git depth`可以加快流水线的执行。
|
|
|
|
|
|
|
|
**注意：**新创建的项目自动具有默认的`git depth`值`50`,最大允许值为`1000`.
|
|
|
|
**注意：**新创建的项目自动具有默认的`git depth`值`50`,最大允许值为`1000`。
|
|
|
|
|
|
|
|
要禁用浅克隆并使 CODECHINA CI / CD 每次获取所有分支和标签，请将值保留为空或设置为`0` .
|
|
|
|
要禁用浅克隆并使 CODECHINA CI/CD 每次获取所有分支和标签，请将值保留为空或设置为`0` 。
|
|
|
|
|
|
|
|
`.codechina-ci.yml`文件中的[`GIT_DEPTH`](../large_repositories/index.html#shallow-cloning)变量也可以[覆盖](../large_repositories/index.html#shallow-cloning)此值.
|
|
|
|
`.codechina-ci.yml`文件中的`GIT_DEPTH`变量也可以覆盖此值。
|
|
|
|
|
|
|
|
## 超时[](#timeout "Permalink")
|
|
|
|
|
|
|
|
超时定义了流水线任务可以运行的最长时间（以分钟为单位）. 这可以在项目的**设置> CI / CD>流水线通用设置下进行配置** . 默认值为 60 分钟. 如果要对流水线任务的运行时间施加硬性限制，则减少时间限制，否则就增加时间限制. 在任何情况下，如果作业超过阈值，则将其标记为失败.
|
|
|
|
超时定义了流水线任务可以运行的最长时间（以分钟为单位）。
|
|
|
|
这可以在项目的**设置> CI/CD >流水线通用设置**下进行配置 。
|
|
|
|
默认值为 60 分钟。 如果要对流水线任务的运行时间施加硬性限制，则减少时间限制，否则就增加时间限制。在任何情况下，如果作业超过阈值，则将其标记为失败。
|
|
|
|
|
|
|
|
### Runner 超时覆盖[](#timeout-overriding-on-runner-level "Permalink")
|
|
|
|
|
|
|
|
项目定义的超时（用户设置的特定超时或默认的 60 分钟超时）可能会被[Runner 覆盖](../runners/README.html#set-maximum-job-timeout-for-a-runner).
|
|
|
|
项目定义的超时（用户设置的特定超时或默认的 60 分钟超时）可能会被[Runner 覆盖](/docs/ci/runners.mdl#set-maximum-job-timeout-for-a-runner)。
|
|
|
|
|
|
|
|
## 最大工件大小[](#maximum-artifacts-size-core-only "Permalink")
|
|
|
|
|
|
|
|
有关为项目设置最大工件大小的信息，请参见[最大工件大小](../../user/admin_area/settings/continuous_integration.html#maximum-artifacts-size-core-only) .
|
|
|
|
有关为项目设置最大工件大小的信息，请参见[最大工件大小](../../user/admin_area/settings/continuous_integration.html#maximum-artifacts-size-core-only)。
|
|
|
|
|
|
|
|
## 自定义 CI/CD 配置路径[](#custom-ci-configuration-path "Permalink")
|
|
|
|
|
|
|
|
默认情况下，我们在项目的根目录中查找`.codechina-ci.yml`文件. 如果需要，您可以指定备用路径和文件名，包括项目外部的位置.
|
|
|
|
默认情况下，我们在项目的根目录中查找`.codechina-ci.yml`文件。 如果需要，您可以指定备用路径和文件名，包括项目外部的位置。
|
|
|
|
|
|
|
|
自定义路径：
|
|
|
|
|
|
|
|
1. 转到项目的**设置> CI / CD** .
|
|
|
|
2. 展开**流水线通用**部分.
|
|
|
|
3. 在 **CI/CD 配置文件"**字段中提供一个值.
|
|
|
|
4. 点击 **保存更改**.
|
|
|
|
1. 转到项目的**设置> CI/CD** 。
|
|
|
|
2. 展开**流水线通用**部分。
|
|
|
|
3. 在 **CI/CD 配置文件"**字段中提供一个值。
|
|
|
|
4. 点击 **保存更改**。
|
|
|
|
|
|
|
|
如果 CI 配置在非默认位置存储在资源库中，则该路径必须相对于根目录. 有效路径和文件名的示例包括：
|
|
|
|
|
| ... | ... | @@ -69,44 +71,42 @@ |
|
|
|
* `.codechina-ci.yml@mygroup/another-project`
|
|
|
|
* `my/path/.my-custom-file.yml@mygroup/another-project`
|
|
|
|
|
|
|
|
将配置文件托管在单独的项目中，可以更严格地控制配置文件. 例如：
|
|
|
|
将配置文件托管在单独的项目中，可以更严格地控制配置文件。 例如：
|
|
|
|
|
|
|
|
* 创建一个公共项目来承载配置文件.
|
|
|
|
* 仅向被允许编辑文件的用户授予对项目的写权限.
|
|
|
|
* 创建一个公共项目来承载配置文件。
|
|
|
|
* 仅向被允许编辑文件的用户授予对项目的写权限。
|
|
|
|
|
|
|
|
其他用户和项目将能够访问配置文件而不能对其进行编辑.
|
|
|
|
其他用户和项目将能够访问配置文件而不能对其进行编辑。
|
|
|
|
|
|
|
|
## 测试覆盖率解析[](#test-coverage-parsing "Permalink")
|
|
|
|
|
|
|
|
如果您在代码中使用测试覆盖率，则 CODECHINA 可以使用正则表达式将其输出捕获到作业日志中.
|
|
|
|
在项目中，转到**设置> CI/CD**并展开**流水线通用**部分，在"测试覆盖解析"字段中输入正则表达式.
|
|
|
|
如果您在代码中使用测试覆盖率，则 CODECHINA 可以使用正则表达式将其输出捕获到作业日志中。
|
|
|
|
在项目中，转到**设置> CI/CD**并展开**流水线通用**部分，在"测试覆盖解析"字段中输入正则表达式。
|
|
|
|
|
|
|
|
[](img/pipelines_settings_test_coverage.png)
|
|
|
|
如果要禁用它或输入 Ruby 正则表达式，请保留空白. 您可以使用[https://rubular.com](https://rubular.com)来测试您的正则表达式。 正则表达式返回在输出中找到的**最后一个**匹配项。
|
|
|
|
|
|
|
|
如果要禁用它或输入 Ruby 正则表达式，请保留空白. 您可以使用[https://rubular.com](https://rubular.com)来测试您的正则表达式. 正则表达式返回在输出中找到的**最后一个**匹配项.
|
|
|
|
如果管道成功，则覆盖范围将显示在合并请求窗口小部件和作业表中.如果流水线中的多个作业具有覆盖率报告，则对它们进行平均。
|
|
|
|
|
|
|
|
如果管道成功，则覆盖范围将显示在合并请求窗口小部件和作业表中.如果流水线中的多个作业具有覆盖率报告，则对它们进行平均.
|
|
|
|
[](/docs/img/pipelines_test_coverage_mr_widget.png)
|
|
|
|
|
|
|
|
[](/docs/img/pipelines_test_coverage_mr_widget.png)
|
|
|
|
[](/docs/img/pipelines_test_coverage_build.png)
|
|
|
|
|
|
|
|
[](img/pipelines_test_coverage_build.png)
|
|
|
|
|
|
|
|
可以在管道设置页面中找到一些针对多种语言的已知覆盖工具的示例.
|
|
|
|
可以在管道设置页面中找到一些针对多种语言的已知覆盖工具的示例。
|
|
|
|
|
|
|
|
### 代码覆盖历史[](#code-coverage-history "Permalink")
|
|
|
|
|
|
|
|
如果您想查看项目代码覆盖率随时间的变化，则可以查看图形或下载包含此数据的 CSV 文件. 从您的项目中：
|
|
|
|
如果您想查看项目代码覆盖率随时间的变化，则可以查看图形或下载包含此数据的 CSV 文件。 从您的项目中：
|
|
|
|
|
|
|
|
1. 去 **项目分析>存储库，**以查看图表上方下拉列表中列出的每个作业的历史数据.
|
|
|
|
1. 去 **项目分析>存储库，**以查看图表上方下拉列表中列出的每个作业的历史数据。
|
|
|
|
2. 如果您想要该数据的 CSV 文件，请点击**下载原始数据（.csv）**
|
|
|
|
|
|
|
|
[](img/code_coverage_graph_v13_1.png)
|
|
|
|
[](img/code_coverage_graph_v13_1.png)
|
|
|
|
|
|
|
|
### 删除颜色代码[](#removing-color-codes "Permalink")
|
|
|
|
|
|
|
|
某些使用 ANSI 颜色代码输出的测试覆盖工具无法通过正则表达式正确解析，并且会导致覆盖解析失败.
|
|
|
|
某些使用 ANSI 颜色代码输出的测试覆盖工具无法通过正则表达式正确解析，并且会导致覆盖解析失败。
|
|
|
|
|
|
|
|
如果覆盖工具没有提供禁用输出中颜色代码的选项，则可以通过一个小的单行脚本通过管道传递覆盖工具的输出，该脚本将去除颜色代码.
|
|
|
|
如果覆盖工具没有提供禁用输出中颜色代码的选项，则可以通过一个小的单行脚本通过管道传递覆盖工具的输出，该脚本将去除颜色代码。
|
|
|
|
|
|
|
|
例如：
|
|
|
|
|
| ... | ... | @@ -118,10 +118,10 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
|
|
|
|
|
|
流水线可见性由以下因素决定:
|
|
|
|
|
|
|
|
* 您当前的[用户访问级别](../../user/permissions.html) .
|
|
|
|
* 项目**设置> CI / CD>流水线通用**下的**公开流水线**项目设置.
|
|
|
|
* 您当前的[用户访问级别](../../user/permissions.html) 。
|
|
|
|
* 项目**设置> CI/CD >流水线通用**下的**公开流水线**项目设置。
|
|
|
|
|
|
|
|
**注意：**如果项目可见性设置为" **私有"** ，则" [**公开流水线"**设置将无效](../enable_or_disable_ci.html#per-project-user-setting) .
|
|
|
|
**注意：**如果项目可见性设置为" **私有"** ，则" [**公开流水线"**设置将无效](../enable_or_disable_ci.html#per-project-user-setting) 。
|
|
|
|
|
|
|
|
这也决定了这些相关功能的可见性：
|
|
|
|
|
| ... | ... | @@ -129,55 +129,55 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
|
|
* 工作文物
|
|
|
|
* The [pipeline security dashboard](../../user/application_security/security_dashboard/index.html#pipeline-security)
|
|
|
|
|
|
|
|
**注意：**当前访客用户和非项目成员尚看不到作业日志和工件.
|
|
|
|
**注意：**当前访客用户和非项目成员尚看不到作业日志和工件。
|
|
|
|
|
|
|
|
如果启用了**公开流水线** （默认）：
|
|
|
|
|
|
|
|
* 对于**公共**项目，任何人都可以查看管道和相关功能.
|
|
|
|
* 对于**内部**项目，任何登录的用户都可以查看流水线和相关功能.
|
|
|
|
* 对于**私有**项目，任何项目成员（访客或更高级别）都可以查看流水线和相关功能.
|
|
|
|
* 对于**公共**项目，任何人都可以查看管道和相关功能。
|
|
|
|
* 对于**内部**项目，任何登录的用户都可以查看流水线和相关功能。
|
|
|
|
* 对于**私有**项目，任何项目成员（访客或更高级别）都可以查看流水线和相关功能。
|
|
|
|
|
|
|
|
如果禁用**公开流水线** ：
|
|
|
|
|
|
|
|
* 对于**公共**项目，任何人都可以查看管道，但是只有成员（报告者或更高级别）可以访问相关功能.
|
|
|
|
* 对于**内部**项目，任何登录的用户都可以查看流水线. 但是，只有成员（记者或更高级别）可以访问与工作相关的功能.
|
|
|
|
* 对于**私有**项目，只有项目成员（报告者或更高版本）才能查看流水线或访问相关功能.
|
|
|
|
* 对于**公共**项目，任何人都可以查看管道，但是只有成员（报告者或更高级别）可以访问相关功能。
|
|
|
|
* 对于**内部**项目，任何登录的用户都可以查看流水线。 但是，只有成员（记者或更高级别）可以访问与工作相关的功能。
|
|
|
|
* 对于**私有**项目，只有项目成员（报告者或更高版本）才能查看流水线或访问相关功能。
|
|
|
|
|
|
|
|
## 自动取消冗余流水线[](#auto-cancel-pending-pipelines "Permalink")
|
|
|
|
|
|
|
|
如果您希望每次创建新流水线时（例如在 Git 推送之后或从 UI 手动创建）自动取消分支上所有挂起或正在运行的流水线，可以在项目设置中启用此功能：
|
|
|
|
|
|
|
|
1. 去 **设置> CI / CD** .
|
|
|
|
2. 展开 **流水线通用**.
|
|
|
|
3. 选中**自动取消冗余流水线**复选框.
|
|
|
|
4. 点击 **保存更改**.
|
|
|
|
1. 去 **设置> CI / CD** 。
|
|
|
|
2. 展开 **流水线通用**。
|
|
|
|
3. 选中**自动取消冗余流水线**复选框。
|
|
|
|
4. 点击 **保存更改**。
|
|
|
|
|
|
|
|
请注意，使用[`interruptible`](../yaml/README.html#interruptible)关键字指示是否可以在完成之前取消正在运行的作业.
|
|
|
|
请注意，使用[`interruptible`](../yaml/README.html#interruptible)关键字指示是否可以在完成之前取消正在运行的作业。
|
|
|
|
|
|
|
|
## 跳过过时的部署作业[](#skip-outdated-deployment-jobs "Permalink")
|
|
|
|
|
|
|
|
您的项目可能有多个并发部署作业，这些作业计划在同一时间范围内运行.
|
|
|
|
您的项目可能有多个并发部署作业，这些作业计划在同一时间范围内运行。
|
|
|
|
|
|
|
|
这可能导致旧的部署作业在新的作业之后运行，而这可能不是您想要的.
|
|
|
|
这可能导致旧的部署作业在新的作业之后运行，而这可能不是您想要的。
|
|
|
|
|
|
|
|
为了避免这种情况：
|
|
|
|
|
|
|
|
1. 去 **设置> CI / CD** .
|
|
|
|
2. 展开 **流水线通用**.
|
|
|
|
3. 选中**跳过过时的部署作业**复选框.
|
|
|
|
4. 点击 **保存更改**.
|
|
|
|
1. 去 **设置> CI/CD** 。
|
|
|
|
2. 展开 **流水线通用**。
|
|
|
|
3. 选中**跳过过时的部署作业**复选框。
|
|
|
|
4. 点击 **保存更改**。
|
|
|
|
|
|
|
|
启用后，在新部署开始时将跳过任何较旧的部署作业.
|
|
|
|
启用后，在新部署开始时将跳过任何较旧的部署作业。
|
|
|
|
|
|
|
|
有关更多信息，请参阅[部署安全](../environments/deployment_safety.html) .
|
|
|
|
有关更多信息，请参阅[部署安全](../environments/deployment_safety.html) 。
|
|
|
|
|
|
|
|
## 流水线徽章[](#pipeline-badges "Permalink")
|
|
|
|
|
|
|
|
在流水线设置页面中，您可以找到项目的流水线状态和测试覆盖率徽章. 最新成功的流水线将用于读取流水线状态和测试覆盖率值.
|
|
|
|
在流水线设置页面中，您可以找到项目的流水线状态和测试覆盖率徽章。 最新成功的流水线将用于读取流水线状态和测试覆盖率值。
|
|
|
|
|
|
|
|
访问项目中的流水线设置页面，以查看指向徽章的确切链接，以及将徽章图像嵌入 HTML 或 Markdown 页面的方法.
|
|
|
|
访问项目中的流水线设置页面，以查看指向徽章的确切链接，以及将徽章图像嵌入 HTML 或 Markdown 页面的方法。
|
|
|
|
|
|
|
|
[](img/pipelines_settings_badges.png)
|
|
|
|
[](img/pipelines_settings_badges.png)
|
|
|
|
|
|
|
|
### 流水线状态标志[](#pipeline-status-badge "Permalink")
|
|
|
|
|
| ... | ... | @@ -199,7 +199,7 @@ https://example.gitlab.com/<namespace>/<project>/badges/<branch>/pipeline.svg |
|
|
|
|
|
|
|
### 测试覆盖率报告徽章[](#test-coverage-report-badge "Permalink")
|
|
|
|
|
|
|
|
CODECHINA 使定义[覆盖率报告](#test-coverage-parsing)的正则表达式成为可能，每个作业日志都将与之匹配. 这意味着流水线中的每个作业都可以定义测试覆盖率百分比值.
|
|
|
|
CODECHINA 使定义[覆盖率报告](#test-coverage-parsing)的正则表达式成为可能，每个作业日志都将与之匹配。 这意味着流水线中的每个作业都可以定义测试覆盖率百分比值。
|
|
|
|
|
|
|
|
可以使用以下链接访问测试覆盖率徽章：
|
|
|
|
|
| ... | ... | @@ -207,7 +207,7 @@ CODECHINA 使定义[覆盖率报告](#test-coverage-parsing)的正则表达式 |
|
|
|
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg
|
|
|
|
```
|
|
|
|
|
|
|
|
如果要从特定作业获取覆盖率报告，可以将`job=coverage_job_name`参数添加到 URL. 例如，以下 Markdown 代码会将`coverage`作业的测试覆盖率报告徽章嵌入到`README.md` ：
|
|
|
|
如果要从特定作业获取覆盖率报告，可以将`job=coverage_job_name`参数添加到 URL。 例如，以下 Markdown 代码会将`coverage`作业的测试覆盖率报告徽章嵌入到`README.md` ：
|
|
|
|
|
|
|
|
```
|
|
|
|
|
| ... | ... | @@ -215,7 +215,7 @@ https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg |
|
|
|
|
|
|
|
### 徽章样式[](#badge-styles "Permalink")
|
|
|
|
|
|
|
|
通过向 URL 添加`style=style_name`参数，可以以不同的样式呈现流水线徽章. 当前有两种样式：
|
|
|
|
通过向 URL 添加`style=style_name`参数，可以以不同的样式呈现流水线徽章。 当前有两种样式：
|
|
|
|
|
|
|
|
#### 扁平 (默认)[](#flat-default "Permalink")
|
|
|
|
|
| ... | ... | |
