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,存在同名时会失败)。
使用技巧
-
Tag 关联说明:
tagName标签存在将会直接使用,不存在的话会基于流水线运行的 commit 为起点创建 Tag。 -
附件路径规范:
assertFiles中的文件路径需基于流水线执行时的工作目录(通常为源码根目录),建议通过ls命令确认文件是否存在,避免因路径错误导致附件上传失败。 -
动态变量使用:支持在参数中引用流水线全局变量,例如通过
${GITEE_PIPELINE_BUILD_NUMBER}自动获取当前构建的标签作为tagName,示例:tagName: v.${GITEE_PIPELINE_BUILD_NUMBER}
releaseName: 版本${GITEE_PIPELINE_BUILD_NUMBER}
常用搭配
上述流程中,通过“代码拉取”获取源码,“构建打包”生成发布物,最后通过“Gitee Release”插件将版本信息和附件发布到 Gitee 仓库。