1. 工件配置

默认情况下，所有GitLab安装中均启用此功能。

（1） 禁用工件

  1. $ vim /etc/gitlab/gitlab.rb
  2. ...
  3. gitlab_rails['artifacts_enabled'] = false
  4. ...

（2）存储工件

默认情况下，工件存储在本地目录：/var/opt/gitlab/gitlab-rails/shared/artifacts ,也可修改存储目录。

  1. gitlab_rails['artifacts_path'] = "/mnt/storage/artifacts"

如果您不想使用安装了GitLab的本地磁盘来存储工件，则可以使用AWS S3之类的对象存储。参考：https://docs.gitlab.com/12.10/ee/administration/job_artifacts.html#using-object-storage

2. .gitlab.yml 配置工件

gitlab.yml 中，使用 artifacts 参数进行工件的配置。

//示例

  1. variables:
  2.   MAVEN_OPTS: "-Dmaven.repo.local=.m2"
  4. stages:
  5.   - test
  6.   - build
  8. test:
  9.   stage: test
  10.   image: harbor.xiodi.cn/tools/openjdk:11.0.6
  11.   tags:
  12.     - docker
  13.     - host20133-docker
  14.   script:
  15.     - chmod +x ./mvnw && ./mvnw test
  16.   cache:
  17.     key: maven-repo-cache
  18.     paths:
  19.       - .m2
  21. build:
  22.   stage: build
  23.   image: harbor.xiodi.cn/tools/openjdk:11.0.6
  24.   tags:
  25.     - docker
  26.     - host20133-docker
  27.   script:
  28.     - chmod +x ./mvnw && ./mvnw package
  29.   cache:
  30.     key: maven-repo-cache
  31.     paths:
  32.       - .m2
  33.   artifacts:
  34.     paths:
  35.       - target/*.jar
  36.     expire_in: 1 week

//示例2，等同于示例1

  1. stages:
  2.   - build
  4. build:
  5.   stage: build
  6.   image: harbor.xiodi.cn/tools/openjdk:11.0.6
  7.   tags:
  8.     - docker
  9.     - host20133-docker
  10.   script:
  11.     - mkdir artifacts
  12.     - cp target/*.jar artifacts/
  13.   artifacts:
  14.     paths:
  15.       - artifacts/
  16.     expire_in: 1 week

这种方式的好处是，存储更加简洁。

3. 工件的操作

3.1 浏览工件

当作业完成后，就会有以下的页面。
6.1 工件存储及配置 - 图1

  • 保持：当您设置了有效日期后，会有该选项，如果点击保持，则会取消有效日期
  • 浏览：用于 web查看工件详细信息。

6.1 工件存储及配置 - 图2

3.2 下载工件

下载的方式有两种：

  • GitLab UI 页面
  • GitLab URL

(1) GitLab UI 页面

可以下载的地方有很多，比如

//job页面
6.1 工件存储及配置 - 图3

//流水线页面
6.1 工件存储及配置 - 图4

（2）GitLab URL

//URL 结构，下载整个工件

  1. https://example.com/<namespace>/<project>/-/jobs/artifacts/<ref>/download?job=<job_name>

//URL 结构，下个单个文件

  1. https://example.com/<namespace>/<project>/-/jobs/artifacts/<ref>/raw/<path_to_file>?job=<job_name>

//例子

  1. https://gitlabtest.xiodi.cn/edu-java-demo/edu-java-spring/-/jobs/artifacts/feature-1/download?job=build
  3. https://gitlabtest.xiodi.cn/edu-java-demo/edu-java-spring/-/jobs/33/artifacts/raw/artifacts/demo-0.0.1-SNAPSHOT.jar

3.3 删除工件

删除作业的同时，也将删除作业的工件和跟踪。

6.1 工件存储及配置 - 图5

[info]可以通过 du -sh 查看存储目录大小就可以看出删除了工件。