一、Release的创建流程
1、创建标签
在GitLab上创建标签是Release的前提,需要在项目中指定提交的SHA和标签名。可以在项目源代码页的顶部右侧的“Add Tag”按钮处创建标签。
<img src="add_tag.png" alt="Add Tag">
2、创建Release
在标签创建完成后,选择“Releases”选项卡,点击“New Release”按钮进行Release的创建,在页面上填写相应的信息并保存即可。
<img src="new_release.png" alt="New Release">
3、上传文件(可选)
可以在Release页面上传需要发布的文件,确保文件能够为使用者所需要和可用。上传文件可以创建Release时进行,也可以后续操作完成后再进行。
<img src="upload_assets.png" alt="Upload Assets">
二、Release的使用场景
1、版本发布
对于一个代码项目,版本的发布十分关键,Release提供了一个方便快捷的发布方式。
2、热修补发布
当线上版本存在严重的问题,需要进行热修补发布时,我们可以在代码库中对问题进行修复,然后在位于线上的标记版本处创建一个Release,使更新同步到线上版本。
3、周期性发布
一些软件需要周期性地进行大型版本更新。使用Release,你可以为每一次更新做出记录,并可在后面的更新中建立链接并方便地对比不同版本的更改。
三、Release的注意事项
1、标签命名规则
标签命名需要遵循语义化版本号规范,格式为x.y.z(均为数字),x,y,z分别代表主版本号、次版本号、修订号。
2、文件上传大小限制
GitLab对于Release上传的文件有大小限制,默认限制为10MB,但是可以在服务器上进行配置。
git config --system core.fssize 20m
指令改为20MB,即可上传文件大小不超过20MB。
3、显式指定构建产物
在Release页面上传任意文件存在一定的风险,为避免上传影响到整个网络,在CI/CD流程的脚本中需要显式指定构建产物,并通过构建脚本将该产物上传至Release中。
- script:
- mv $CI_BUILD_NAME.tar.gz $CI_PROJECT_NAMESPACE/$CI_PROJECT_NAME
- curl --request POST --header "PRIVATE-TOKEN:
" --form "file=@/$CI_PROJECT_NAMESPACE/$CI_PROJECT_NAME/$CI_BUILD_NAME.tar.gz" https://gitlab.example.com/api/v4/projects/
/uploads
- git tag -a $CI_BUILD_NAME -m"$CI_PROJECT_NAMESPACE/$CI_PROJECT_NAME:$CI_COMMIT_SHA - Release $CI_BUILD_NAME"
- git push --tags
这段脚本展示了从CI/CD流程构建一个jar包,然后把它作为构建产物上传至Release中。在流程结束时,还会创建一个标签并推送至GitLab的服务器上。
四、总结
本篇文章详细介绍了GitLab Release的创建流程、使用场景和注意事项。通过使用GitLab Release,开发人员可以更加方便快捷地进行版本迭代、热修补发布和周期性发布。在操作过程中需要根据实际情况细心规划,并严格按照GitLab的规范进行创建和使用。