Releases
- Create a release
- Edit a release
- Associate milestones with a release
- Prevent unintentional releases by setting a deploy freeze
- Release evidence
Releases
在 GitLab 11.7 中 .
要在源代码历史记录中引入检查点,可以在发布时分配Git 标签 . 但是,在大多数情况下,您的用户不仅需要原始源代码. 他们需要 CI / CD 系统输出的已编译对象或其他资产.
GitLab 发行版是与代码的发行版本相关联的源,构建输出,工件和其他元数据的快照.
您可以在任何分支上创建一个 GitLab 版本. 创建发行版时:
- manbetx 客户端打不开自动归档源代码,并将其与版本关联.
- GitLab 会自动创建一个 JSON 文件,其中列出了发行版中的所有内容,因此您可以比较和审核发行版. 该文件称为 .
- 您可以添加发行说明以及与发行版关联的标签的消息.
创建发行版后,您可以将里程碑与其关联 ,并附加 ,例如运行手册或软件包.
在 GitLab 12.8 中引入 .
要查看版本列表:
转到项目概述>版本 ,或
在项目的概述页面上,如果存在至少一个版本,请单击版本数.
- 在公共项目上,此数字对所有用户可见.
- 在私有项目上,具有 Reporter 权限或更高用户可以看到此数字.
Create a release
在 GitLab 12.9 中 . 可以在 GitLab UI 中直接创建发布.
注意:只有具有开发者权限或更高权限的用户才能创建发行版. 阅读有关释放权限的更多信息.
您可以在用户界面中或使用创建发布. 我们建议使用 API添加发行说明,作为 CI / CD 发行流程中的最后步骤之一.
要通过 GitLab UI 创建新版本:
- 导航到项目概述>发布 ,然后单击新发布按钮.
- 在标签名称框中,输入一个名称.
- In the 从创建 list, select the branch or enter a tag or commit SHA.
- 在” 消息”框中,输入与标签关联的消息.
- (可选)在” 字段中,输入发行说明. 您可以使用 Markdown 并将文件拖放到此字段.
- 如果将此字段留空,则只会创建一个标签.
- 如果您填充它,将同时创建标签和发行版.
- Click 创建标签.
如果创建了发行版,则可以在项目概述>发行版中对其进行查看. 如果创建了标签,则可以在存储库>标签中查看它.
现在,您可以编辑发布以添加里程碑和 .
在 GitLab 12.1 中引入 .
您可以使用提前创建发行版 . 当您设置将来的日期时,将在发布标签旁边显示即将发布的发布标志. 经过released_at
日期和时间后,会自动删除徽章.
Edit a release
在 GitLab 12.6 中 . 在 GitLab 12.10 中引入了资产链接编辑.
注意:只有具有开发者权限或更高权限的用户才能编辑发行版. 阅读有关更多信息.
要编辑发布的详细信息:
- 导航到项目概述>发布 .
- 在您要修改的发行版的右上角,单击” 编辑此发行版” (铅笔图标).
- 在” 编辑版本”页面上,更改版本的详细信息.
- Click 保存更改.
您可以编辑发行标题,注释,关联的里程碑和资产链接. 要更改其他发行信息,例如标签或发行日期,请使用Releases API .
If you have an existing Git tag, you can add release notes to it.
您可以在用户界面中或使用来执行此操作. 我们建议使用 API添加发行说明,作为 CI / CD 发行流程中的最后步骤之一.
在界面中,要向新的 Git 标签添加发行说明:
- 导航到您项目的Repository> Tags .
- Click 新的一天.
- 在发行说明字段中,输入发行说明. 您可以使用 Markdown 并将文件拖放到此字段.
- Click 创建标签.
在界面中,要将发行说明添加到现有的 Git 标签:
- 导航到您项目的Repository> Tags .
- 在发行说明字段中,输入发行说明. 您可以在此字段中使用 Markdown,并将文件拖放到该字段中.
- Click 保存更改.
Associate milestones with a release
版本历史
- 在 GitLab 12.5 中 .
- 已更新 ,可在 GitLab 13.0 中的 UI 中编辑里程碑.
您可以在用户界面中执行此操作,也可以在对请求中包含一个milestones
数组.
在用户界面中,要将里程碑与版本关联:
- 导航到项目概述>发布 .
- 在您要修改的发行版的右上角,单击” 编辑此发行版” (铅笔图标).
- 从” 里程碑”列表中,选择要关联的每个里程碑. 您可以选择多个里程碑.
- Click 保存更改.
在” 项目概述”>”发布”页面上, 里程碑列在顶部,以及有关里程碑问题的统计信息.
在” 问题”>”里程碑”页面上,以及当您单击此页面上的里程碑时,也可以看到发行版本.
这是一个里程碑示例,分别没有发布,一个发布和两个发布.
Get notified when a release is created
在 GitLab 12.4 中 .
为您的项目创建新版本时,将通过电子邮件通知您.
订阅发布通知:
- 导航到” 项目概述” .
- 单击通知设置 (响铃图标).
- 在列表中,点击自定义 .
- Select the 新品发布 check box.
- 关闭对话框进行保存.
在 GitLab 13.0 中引入 .
通过设置可以在指定的时间内防止意外的生产发布. 冻结部署有助于减少自动化部署时的不确定性和风险.
使用” 冻结时间” API设置被定义为条目的freeze_start
和freeze_end
.
如果正在执行的作业处于冻结期,则 GitLab CI / CD 会创建一个名为$CI_DEPLOY_FREEZE
的环境变量.
为了防止执行部署作业,请在gitlab-ci.yaml
创建一个rules
条目,例如:
如果项目包含多个冻结期,则所有时期都适用. 如果它们重叠,则冻结将覆盖整个重叠期间.
有关更多信息,请参阅部署安全 .
Release fields
创建或编辑发行版时,以下字段可用.
Tag name
发行标签名称应包括发行版本. GitLab 在我们的发行版中使用 ,我们建议您也这样做. 使用(Major).(Minor).(Patch)
,如GitLab 版本控制政策中所述.
例如,对于 GitLab 版本10.5.7
:
10
代表主要版本. 主要版本是10.0.0
,但通常称为10.0
.5
代表次要版本. 次要版本为10.5.0
,但通常称为10.5
.- 代表补丁号码.
版本号的任何部分都可以是多个数字,例如13.10.11
.
Release notes description
每个版本都有说明. 您可以添加任何您喜欢的文本,但是我们建议您添加一个变更日志来描述发行版本的内容. 这可以帮助用户快速扫描您发布的每个版本之间的差异.
注意: Git 的标记消息和发行说明描述无关. 说明支持 .
当前,您可以将以下类型的资产添加到每个版本:
manbetx 客户端打不开将在未来支持更多的资产类型,包括诸如预装包,合规性/安全证据或容器图像之类的对象.
Permanent links to release assets
在 GitLab 12.9 中 .
与发布相关联的资产可通过永久 URL 访问. GitLab 将始终将此 URL 重定向到实际资产位置,因此,即使资产移动到其他位置,您也可以继续使用相同的 URL. 这是在链接创建或期间定义的.
每个资产都有一个名称, 实际资产位置的 URL,以及一个可选的filepath
参数,如果您指定它,它将创建指向发布的资产的 URL. URL 的格式为:
https://host/namespace/project/releases/:release/downloads/:filepath
该资产具有以下直接链接:
https://gitlab.com/gitlab-org/gitlab-runner/releases/v11.9.0-rc2/downloads/binaries/gitlab-runner-linux-amd64
资产的物理位置可以随时更改,并且直接链接将保持不变.
Source code
GitLab 会根据给定的 Git 标签自动生成zip
, tar.gz
, tar.bz2
和tar
归档的源代码. 这些是只读资产.
Links
A link is any URL which can point to whatever you like: documentation, built binaries, or other related materials. These can be both internal or external links from your GitLab instance.
链接的四种类型是” Runbook”,” Package”,” Image”和” Other”.
Release evidence
在 GitLab 12.6 中 .
每次创建发行版时,GitLab 都会拍摄与之相关的数据快照. 此数据保存在 JSON 文件中,称为发布证据 . 它包括链接的里程碑和问题,并且可以促进内部流程,例如外部审核.
要访问发布证据,请在”发布”页面上,单击” 证据集合”标题下列出的 JSON 文件的链接.
您还可以使用 API生成现有版本的版本证据. 因此,每个版本可以具有多个版本证据快照. 您可以在”发布”页面上查看发布证据及其详细信息.
注意:禁用问题跟踪器后, 发布证据.
这是释放证据对象的示例:
Introduced in 12.10.
创建发布后,将自动收集发布证据. 要在其他任何时间启动证据收集,请使用API 调用 . 您可以为一个发布多次收集发布证据.
在”发布”页面上可以看到证据收集快照,以及收集证据的时间戳.
Include report artifacts as release evidence
Introduced in 13.2.
创建发布时,如果作业工件包含在最后运行的管道中,则它们会自动作为发布证据包含在发布中.
尽管工作工件通常会过期,但发布证据中包含的工件不会过期.
要启用作业工件收集,您需要同时指定两个:
ruby:
- gem install bundler
- bundle install
- bundle exec rspec --format progress --format RspecJunitFormatter --out rspec.xml
artifacts:
paths:
- rspec.xml
reports:
junit: rspec.xml
如果管道成功运行,则在创建发布时, rspec.xml
文件将保存为发布证据.
注:如果您 ,则某些证据可能在证据收集时已经过期. 为了避免这种情况,可以使用关键字. 了解更多在这个问题上 .
Schedule release evidence collection
在 GitLab 12.8 中引入 .
在 API 中:
- 如果您指定未来的
released_at
日期,则该发布将成为即将发布的发布,并且将在发布日期收集证据. 在此之前,您无法收集释放证据. - 如果您未指定
released_at
日期,则在创建发布的日期收集发布证据.
:release_evidence_collection
功能标志在 GitLab 自管理实例中默认启用. 要关闭它,请要求具有 Rails 控制台访问权限的 GitLab 管理员运行以下命令:
注意:无论使用此功能标志如何,都将收集发布证据,该标志仅启用或禁用”发布”页面上的数据显示.
在 GitLab 12.10 中 .
GitLab Releaser 是一个 CLI 工具,用于从命令行或 GitLab 的 CI / CD 配置文件.gitlab-ci.yml
管理 GitLab 版本.
有了它,您可以直接通过终端创建,更新,修改和删除发行版.
有关详细信息,请阅读GitLab Releaser 文档 .