跳到主要内容
gitee logo

Gitee Release 插件

表单介绍

  • Release 描述(description):对该 Release 版本的详细说明,可包含功能变更、修复内容等信息,支持从流水线运行时的 commit 仓库代码中文件中进行内容读取,示例:优化登录流程,修复已知bug | releaseNode.txt

  • Tag 名称(tagName):关联的 Git 标签名称,用于标记该 Release 对应的代码版本,标签存在将会直接使用,不存在的话会基于流水线运行的 commit 为起点创建 Tag,示例:v1.0.0

  • 附件文件(assertFiles):需要附加到 Release 中的文件路径列表,填写文件在源码仓库中的相对路径,支持多文件,文件来源为流水线运行时的 commit 仓库路径,示例:./dist/app.zip./CHANGELOG.md

  • 预发布版本(prerelease):勾选后该 Release 将被标记为预发布版本(通常用于测试或非正式版本),默认不勾选(false)。

  • 允许覆盖(allowUpdate):勾选后若存在同 Tag 创建的 Release,将覆盖已有版本,默认不勾选(false,存在同名时会失败)。

使用技巧

  1. Tag 关联说明tagName 标签存在将会直接使用,不存在的话会基于流水线运行的 commit 为起点创建 Tag。

  2. 附件路径规范assertFiles 中的文件路径需基于流水线执行时的工作目录(通常为源码根目录),建议通过 ls 命令确认文件是否存在,避免因路径错误导致附件上传失败。

  3. 动态变量使用:支持在参数中引用流水线全局变量,例如通过 ${GITEE_PIPELINE_BUILD_NUMBER} 自动获取当前构建的标签作为 tagName,示例:

    tagName: v.${GITEE_PIPELINE_BUILD_NUMBER}
    releaseName: 版本${GITEE_PIPELINE_BUILD_NUMBER}

常用搭配

上述流程中,通过“代码拉取”获取源码,“构建打包”生成发布物,最后通过“Gitee Release”插件将版本信息和附件发布到 Gitee 仓库。