GitLab中文网站 > 售前问题 > GitLab如何管理构建产物 GitLab中怎样配置工件存储路径

GitLab如何管理构建产物 GitLab中怎样配置工件存储路径

发布时间:2025-06-12 09: 00: 00

在使用GitLab进行CI/CD构建时,构建产物(Artifacts)是非常重要的一环。无论是构建出的二进制文件、编译产物、测试报告,还是打包好的安装包,都需要妥善管理和存储。要是不对构建产物进行统一管理,时间久了文件散落各处,不仅查找不便,还会占用大量磁盘空间。那么,GitLab如何管理构建产物 GitLab中怎样配置工件存储路径?接下来,我就带大家详细了解一下。

 

一、GitLab如何管理构建产物

GitLab CI/CD可以通过Artifacts(工件)来保存构建产物。工件可以是编译文件、打包好的应用程序、测试报告、日志文件等。合理配置这些工件,不仅有助于后期检查,还能避免产物丢失或混乱。

 

1. 什么是构建产物(Artifacts)?

简单来说,Artifacts就是CI/CD流水线生成的文件或目录。比如在Node.js项目中,打包好的dist目录就是构建产物。在C++项目中,生成的可执行文件(如.exe或.out)也是Artifacts。

 

典型场景:

 

构建后的二进制文件:如Java的.jar文件或Python的.whl包。

 

测试报告:如JUnit生成的测试结果。

 

编译日志:构建过程中的详细日志信息。

 

安装包:如Docker镜像或压缩文件。

 

2. 如何在GitLab中配置构建产物?

要管理构建产物,首先要在.gitlab-ci.yml中配置Artifacts。以下是一个Node.js项目的示例:

 

stages:

- build

- test

 

build:

stage: build

script:

- npm install

- npm run build

artifacts:

paths:

- dist/

expire_in: 7 days

 

test:

stage: test

script:

- npm test

artifacts:

paths:

- reports/

when: always

expire_in: 3 days

解释:

 

artifacts: 定义工件的保存规则。

 

paths: 指定保存的路径,比如dist/和reports/。

 

expire_in: 设置工件的过期时间,这里是7天和3天。

 

when: 什么时候保存,always表示无论成功或失败都保存。

 

3. 如何查看和下载构建产物?

GitLab生成构建产物后,可以在项目页面查看:

 

打开GitLab项目,进入CI/CD > Pipelines。

 

点击某次流水线,进入详情页。

 

在右侧找到“工件”,点击可以直接下载或查看。

 

快速访问:

如果构建成功,还可以通过GitLab API直接下载:

 

curl --header "PRIVATE-TOKEN: " \

"https://gitlab.com/api/v4/projects//jobs//artifacts"

GitLab如何管理构建产物

二、GitLab中怎样配置工件存储路径

默认情况下,GitLab会将Artifacts存储在GitLab服务器的**/var/opt/gitlab/gitlab-rails/shared/artifacts目录下。但在一些企业环境中,可能需要将工件保存到远程存储或自定义目录**。

 

1. 修改默认存储路径

修改GitLab配置文件,设置新的存储路径:

 

修改配置:

编辑GitLab配置文件:

 

sudo nano /etc/gitlab/gitlab.rb

增加以下配置:

 

gitlab_rails['artifacts_path'] = "/mnt/gitlab/artifacts"

重启GitLab服务:

 

sudo gitlab-ctl reconfigure

sudo gitlab-ctl restart

效果:

GitLab将把构建产物保存到/mnt/gitlab/artifacts目录下。

 

2. 使用远程存储(如AWS S3)

有时候,构建产物很多,占用服务器磁盘空间。我们可以将Artifacts存储在AWS S3或其他对象存储服务上。

 

配置AWS S3存储:

修改GitLab配置文件:

 

gitlab_rails['artifacts_enabled'] = true

gitlab_rails['artifacts_object_store_enabled'] = true

gitlab_rails['artifacts_object_store_remote_directory'] = "gitlab-artifacts"

gitlab_rails['artifacts_object_store_connection'] = {

'provider' => 'AWS',

'region' => 'us-east-1',

'aws_access_key_id' => 'your_access_key',

'aws_secret_access_key' => 'your_secret_key',

'endpoint' => 'https://s3.amazonaws.com'

}

应用配置:

 

sudo gitlab-ctl reconfigure

3. 配置工件的上传和下载

在.gitlab-ci.yml中配置上传和下载路径:

 

build:

stage: build

script:

- echo "开始构建..."

- npm run build

artifacts:

paths:

- dist/

expire_in: 1 week

下载工件:

在GitLab流水线详情页,可以直接看到生成的Artifacts列表,点击即可下载。如果配置了AWS S3,点击下载时会自动跳转到S3存储链接。

GitLab中怎样配置工件存储路径

三、GitLab构建产物管理的优化技巧

1. 自动清理过期工件

为了节省存储空间,可以配置GitLab自动清理过期的Artifacts:

 

在.gitlab-ci.yml中指定过期时间:

 

artifacts:

expire_in: 3 days

在GitLab后台设置:

 

进入管理员设置 > CI/CD > Artifacts。

 

设置全局过期策略,比如7天。

 

2. 按环境分类存储工件

如果同一个项目有多个环境,比如开发、测试、生产,可以按环境分类存储工件:

 

artifacts:

paths:

- dist/

name: "$CI_COMMIT_REF_NAME-$CI_JOB_ID"

expire_in: 5 days

这样,下载时会按照分支和作业ID进行分类,方便查找。

 

3. 归档日志和错误信息

除了构建产物,日志和错误信息也可以作为Artifacts保存下来,方便日后排查问题:

 

artifacts:

paths:

- logs/

when: on_failure

这样,当流水线失败时,GitLab会自动保存日志文件,供开发者下载查看。

GitLab构建产物管理的优化技巧

四、总结

GitLab如何管理构建产物 GitLab中怎样配置工件存储路径,其实就是通过合理配置Artifacts来管理和存储构建结果。通过设置过期时间、分类存储、远程存储,可以有效地管理和保存构建文件。同时,将日志和错误报告也作为Artifacts保存,能够更好地追踪问题和分析故障。希望这些方法能帮你在GitLab项目管理中更高效地管理构建产物,让CI/CD流程更加顺畅稳定!

展开阅读全文

标签:极狐gitlab代码存储

读者也访问过这里:
极狐GitLab
助力企业数字化转型
立即购买
最新文章
GitLab如何接入第三方登录 GitLab中怎样配置OAuth2认证
很多公司自建服务器搭建了GitLab服务,并且想要定制化登录,如果要使用公司自己创建好的账号密码登录,就需要使用SSO单点登录技术。其次为GitLab接入第三方登录和配置OAuth2认证,能提升系统的安全性。本文将为大家介绍GitLab如何接入第三方登录,GitLab中怎样配置OAuth2认证的相关内容。
2025-07-28
GitLab怎么撤销错误提交 GitLab如何修改commit历史
在软件开发过程中,版本控制可以记录代码的迭代,出现问题时可以及时恢复到正常版本。GitLab是一款很多公司在用的代码托管与协作平台,它是基于Git的版本控制机制,作为一个程序员,我们需要掌握错误提交的撤销及commit历史的修改方法。本文将为大家介绍GitLab怎么撤销错误提交,GitLab如何修改commit历史的相关内容。
2025-07-28
GitLab如何管理访问令牌 GitLab的API访问权限怎样配置
很多公司都在使用GitLab作为代码管理平台,GitLab访问令牌管理以及API权限配置关系到代码安全,GitLab访问令牌是一种安全的身份验证凭证,无需账号密码就可以发起API请求获取GitLab的数据,或者实现类似自动化CI/CD流水线构建、项目数据批量克隆等场景下的身份验证。随着团队规模扩大,我们需要合理配置访问令牌与API权限,防止数据泄露的风险。本文将为大家介绍GitLab如何管理访问令牌,GitLab的API访问权限怎样配置的相关内容。
2025-07-28
GitLab如何恢复误删的文件 GitLab如何找回文件的历史版本
程序员在软件开发过程中,需要进行代码的版本控制,以便历史版本回溯。作为企业级代码托管平台,GitLab有着完善的版本控制机制,并且提供了数据恢复手段。本文将为大家介绍GitLab如何恢复误删的文件,GitLab如何找回文件的历史版本的相关内容。
2025-07-28
GitLab如何设置项目可见性 GitLab怎么配置私有仓库权限
在团队协作开发过程中,我们需要严格控制代码仓库访问权限,防止未经授权的人能拉取代码,GitLab可以设置项目可见性,并且提供了私有仓库权限管理功能,既能保障代码安全,又能满足不同团队的协作需求。本文将为大家介绍GitLab如何设置项目可见性,GitLab怎么配置私有仓库权限的相关内容。
2025-07-28
GitLab如何防范代码泄露 GitLab的分支保护规则怎么设置
在当今的软件开发行业,代码泄露是很多公司比较担心的问题,因为很多企业曾遭遇过不同程度的代码泄露事件,大疆前员工就有泄露公司源代码的情况。很多公司都在使用GitLab作为代码托管平台,该平台提供了一系列强大的安全机制来防范代码泄露,同时通过分支保护规则确保代码的安全。本文将为大家介绍GitLab如何防范代码泄露,GitLab的分支保护规则怎么设置的相关内容。
2025-07-28

读者也喜欢这些内容:

咨询热线 400-8765-888