... | ... | @@ -11,18 +11,18 @@ |
|
|
|
|
|
## Git 策略[](#git-strategy "Permalink")
|
|
|
|
|
|
使用 Git 策略,您可以选择从作业中的 CODECHINA 提取存储库的默认方式。
|
|
|
使用 Git 策略,您可以选择获取仓库的默认方式在一个流水线任务中。
|
|
|
|
|
|
有两种选择。使用:
|
|
|
|
|
|
* `git clone` ,速度较慢,因为它会为每个作业从头开始克隆存储库,以确保本地工作副本始终是原始的。
|
|
|
* `git clone` ,速度较慢,因为它会为每个流水线任务从头开始克隆仓库,以确保本地工作副本始终是原始的。
|
|
|
* `git fetch` ,它更快地重新使用本地工作副本(如果不存在,则回退为克隆)。
|
|
|
|
|
|
默认的 Git 策略可以由`.codechina-ci.yml`的 GIT_STRATEGY 变量覆盖。
|
|
|
|
|
|
## Git 浅克隆[](#git-shallow-clone "Permalink")
|
|
|
|
|
|
克隆存储库时,可以限制 CODECHINA CI/CD 获取的更改数量。设置限制`git depth`可以加快流水线的执行。
|
|
|
克隆仓库时,可以限制 CODECHINA CI/CD 获取的更改数量。设置限制`git depth`可以加快流水线的执行。
|
|
|
|
|
|
**注意:**新创建的项目自动具有默认的`git depth`值`50`,最大允许值为`1000`。
|
|
|
|
... | ... | @@ -40,10 +40,6 @@ |
|
|
|
|
|
项目定义的超时(用户设置的特定超时或默认的 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)。
|
|
|
|
|
|
## 自定义 CI/CD 配置路径[](#custom-ci-configuration-path "Permalink")
|
|
|
|
|
|
默认情况下,我们在项目的根目录中查找`.codechina-ci.yml`文件。 如果需要,您可以指定备用路径和文件名,包括项目外部的位置。
|
... | ... | @@ -57,7 +53,7 @@ |
|
|
|
|
|
如果 CI 配置在非默认位置存储在资源库中,则该路径必须相对于根目录. 有效路径和文件名的示例包括:
|
|
|
|
|
|
* `.codechina-ci.yml` (default)
|
|
|
* `.codechina-ci.yml` (默认)
|
|
|
* `.my-custom-file.yml`
|
|
|
* `my/path/.codechina-ci.yml`
|
|
|
* `my/path/.my-custom-file.yml`
|
... | ... | @@ -118,7 +114,7 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
|
|
|
|
流水线可见性由以下因素决定:
|
|
|
|
|
|
* 您当前的[用户访问级别](../../user/permissions.html) 。
|
|
|
* 您当前的[用户访问级别](/docs/user/permissions.md) 。
|
|
|
* 项目**设置> CI/CD >流水线通用**下的**公开流水线**项目设置。
|
|
|
|
|
|
**注意:**如果项目可见性设置为" **私有"** ,则" [**公开流水线"**设置将无效](../enable_or_disable_ci.html#per-project-user-setting) 。
|
... | ... | @@ -127,9 +123,9 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
|
|
|
|
* 作业输出日志
|
|
|
* 工作文物
|
|
|
* The [pipeline security dashboard](../../user/application_security/security_dashboard/index.html#pipeline-security)
|
|
|
* 流水线的安全仪表板
|
|
|
|
|
|
**注意:**当前访客用户和非项目成员尚看不到作业日志和工件。
|
|
|
**注意:**当前访客用户和非项目成员尚看不到流水线任务日志和工件。
|
|
|
|
|
|
如果启用了**公开流水线** (默认):
|
|
|
|
... | ... | @@ -147,7 +143,7 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
|
|
|
|
如果您希望每次创建新流水线时(例如在 Git 推送之后或从 UI 手动创建)自动取消分支上所有挂起或正在运行的流水线,可以在项目设置中启用此功能:
|
|
|
|
|
|
1. 去 **设置> CI / CD** 。
|
|
|
1. 去 **设置> CI/CD** 。
|
|
|
2. 展开 **流水线通用**。
|
|
|
3. 选中**自动取消冗余流水线**复选框。
|
|
|
4. 点击 **保存更改**。
|
... | ... | @@ -156,9 +152,9 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
|
|
|
|
## 跳过过时的部署作业[](#skip-outdated-deployment-jobs "Permalink")
|
|
|
|
|
|
您的项目可能有多个并发部署作业,这些作业计划在同一时间范围内运行。
|
|
|
您的项目可能有多个并发部署流水线任务,这些流水线任务计划在同一时间范围内运行。
|
|
|
|
|
|
这可能导致旧的部署作业在新的作业之后运行,而这可能不是您想要的。
|
|
|
这可能导致旧的部署作业在新的流水线任务之后运行,而这可能不是您想要的。
|
|
|
|
|
|
为了避免这种情况:
|
|
|
|
... | ... | @@ -167,9 +163,7 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
|
3. 选中**跳过过时的部署作业**复选框。
|
|
|
4. 点击 **保存更改**。
|
|
|
|
|
|
启用后,在新部署开始时将跳过任何较旧的部署作业。
|
|
|
|
|
|
有关更多信息,请参阅[部署安全](../environments/deployment_safety.html) 。
|
|
|
启用后,在新部署开始时将跳过任何较旧的部署流水线任务。
|
|
|
|
|
|
## 流水线徽章[](#pipeline-badges "Permalink")
|
|
|
|
... | ... | @@ -177,7 +171,7 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
|
|
|
|
访问项目中的流水线设置页面,以查看指向徽章的确切链接,以及将徽章图像嵌入 HTML 或 Markdown 页面的方法。
|
|
|
|
|
|
[![Pipelines badges](/docs/img/pipelines_settings_badges.png)](img/pipelines_settings_badges.png)
|
|
|
[![Pipelines badges](/docs/img/pipelines_settings_badges.png)](/docs/img/pipelines_settings_badges.png)
|
|
|
|
|
|
### 流水线状态标志[](#pipeline-status-badge "Permalink")
|
|
|
|
... | ... | @@ -194,7 +188,7 @@ lein cloverage | perl -pe 's/\e\[?.*?[\@-~]//g' |
|
|
您可以使用以下链接访问流水线状态徽章图像:
|
|
|
|
|
|
```
|
|
|
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/pipeline.svg
|
|
|
https://codechina.csdn.net/<namespace>/<project>/badges/<branch>/pipeline.svg
|
|
|
```
|
|
|
|
|
|
### 测试覆盖率报告徽章[](#test-coverage-report-badge "Permalink")
|
... | ... | @@ -204,13 +198,13 @@ CODECHINA 使定义[覆盖率报告](#test-coverage-parsing)的正则表达式 |
|
|
可以使用以下链接访问测试覆盖率徽章:
|
|
|
|
|
|
```
|
|
|
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg
|
|
|
https://codechina.csdn.net/<namespace>/<project>/badges/<branch>/coverage.svg
|
|
|
```
|
|
|
|
|
|
如果要从特定作业获取覆盖率报告,可以将`job=coverage_job_name`参数添加到 URL。 例如,以下 Markdown 代码会将`coverage`作业的测试覆盖率报告徽章嵌入到`README.md` :
|
|
|
如果要从特定流水线任务获取覆盖率报告,可以将`job=coverage_job_name`参数添加到 URL。 例如,以下 Markdown 代码会将`coverage`作业的测试覆盖率报告徽章嵌入到`README.md` :
|
|
|
|
|
|
```
|
|
|
![coverage](https://gitlab.com/gitlab-org/gitlab/badges/master/coverage.svg?job=coverage)
|
|
|
![coverage](https://codechina.csdn.net/codechina/help-docs/badges/master/coverage.svg?job=coverage)
|
|
|
```
|
|
|
|
|
|
### 徽章样式[](#badge-styles "Permalink")
|
... | ... | @@ -220,25 +214,25 @@ https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg |
|
|
#### 扁平 (默认)[](#flat-default "Permalink")
|
|
|
|
|
|
```
|
|
|
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg?style=flat
|
|
|
https://codechina.csdn.net/<namespace>/<project>/badges/<branch>/coverage.svg?style=flat
|
|
|
```
|
|
|
|
|
|
[![Badge flat style](img/69a8b09a09599e563d1796eac13f945e.png)](https://gitlab.com/gitlab-org/gitlab/badges/master/coverage.svg?job=coverage&style=flat)
|
|
|
[![Badge flat style](/docs/img/coverage.svg)](/docs/img/coverage.svg)
|
|
|
|
|
|
#### 扁平正方形[](#flat-square "Permalink")
|
|
|
|
|
|
```
|
|
|
https://example.gitlab.com/<namespace>/<project>/badges/<branch>/coverage.svg?style=flat-square
|
|
|
https://codechina.csdn.net/<namespace>/<project>/badges/<branch>/coverage.svg?style=flat-square
|
|
|
```
|
|
|
|
|
|
[![Badge flat square style](img/c7918abdac813cb6d0b57bb682269b93.png)](https://gitlab.com/gitlab-org/gitlab/badges/master/coverage.svg?job=coverage&style=flat-square)
|
|
|
[![Badge flat square style](/docs/img/coverage2.svg)](/docs/img/coverage2.svg)
|
|
|
|
|
|
### 自定义徽章文本[](#custom-badge-text "Permalink")
|
|
|
|
|
|
徽章的文本可以自定义. 这有助于区分在同一流水线中运行的多个覆盖作业. 通过将`key_text=custom_text`和`key_width=custom_key_width`参数添加到 URL 来定制徽章文本和宽度:
|
|
|
|
|
|
```
|
|
|
https://gitlab.com/gitlab-org/gitlab/badges/master/coverage.svg?job=karma&key_text=Frontend+Coverage&key_width=100
|
|
|
https://codechina.csdn.net/codechina/help-docs/badges/master/coverage.svg?job=karma&key_text=Frontend+Coverage&key_width=100
|
|
|
```
|
|
|
|
|
|
[![Badge with custom text and width](img/8e5585152d153d9f1f4073f0cddba269.png)](https://gitlab.com/gitlab-org/gitlab/badges/master/coverage.svg?job=karma&key_text=Frontend+Coverage&key_width=100) |
|
|
\ No newline at end of file |
|
|
[![Badge with custom text and width](/docs/img/coverage3.svg)](/docs/img/coverage3.svg) |
|
|
\ No newline at end of file |