在持续集成过程中，版本发布常常伴随一系列重复且易错的操作：手动创建 Tag、编辑更新说明、上传构建产物……这些步骤若不能自动完成，不仅效率低下，也易埋下失误隐患。

为此，Gitee 流水线现已支持 Release 插件，提供从构建产物到版本发布的完整自动化能力。插件可将版本信息、更新日志、构建文件一键发布至仓库 Release 页面，适用于正式发版、预发布测试、开源产物同步等场景。

将 Release 流程集成至流水线

Gitee Go Release 插件定位为流水线内的发布步骤，通过配置参数可完成以下任务：

• 自动创建 Release 页面，附带描述与构建产物；
• 自动生成或复用对应 Tag；
• 支持预发布版本与重复覆盖；
• 结合流水线变量实现构建号驱动的版本管理。

适配 Gitee 流水线的插件机制，用户可通过表单或 YAML 方式快速集成。

应用场景示例

💻 开源项目：合并主干后自动发布更新日志与构建产物，贡献者可直接下载最新版本。

💻 迭代发布：读取 CHANGELOG.md 作为描述，上传 dist 压缩包，全流程无需手动操作。

💻 测试发布：启用「预发布」与「允许覆盖」，支持同一 Tag 下多次更新，用于测试验证。

手把手实操一次自动发布流程

以下是一个典型流程：当开发者在主干提交包含release:前缀的变更时，流水线自动触发构建并发布 Release。

配置触发条件

进入对应流水线的触发事件配置页面，设置如下：

• 事件类型：Push
• 触发分支：master（或你的主分支）
• 提交注释关键字匹配：提交信息包含^release:.*

配置 Release 插件参数

• 选择任务编排，新建 Gitee Go Release 任务：

• 根据需求填入相关参数：

详细参数说明可查看 Gitee Release 文档页面：https://help.gitee.com/enterprise/pipeline/plugin/gitee-release

使用技巧

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

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

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

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

同时你也可以进入代码视图，使用 YAML 进行精确控制。以下是推荐配置：

stages:
  - name: stage-e4e45c6b
    displayName: 构建
    strategy: naturally
    trigger: auto
    executor: []
    steps:
      - step: build@golang
        name: build_golang
        displayName: Golang 构建
        golangVersion: '1.12'
        commands:
          - CGO_ENABLED=0 && GOOS=linux GOARCH=amd64 go build -o plugin-amd64 main.go
          - CGO_ENABLED=0 && GOOS=linux GOARCH=arm64 go build -o plugin-arm64 main.go
        artifacts:
          - name: PLUGIN_RELEASE
            path:
              - plugin-amd64
              - plugin-arm64
        caches:
          - /go/pkg/mod
        notify: []
        strategy:
          retry: '0'
  - name: stage-1933bd18
    displayName: 发版
    strategy: naturally
    trigger: auto
    executor: []
    steps:
      - step: release@gitee
        name: release_gitee
        displayName: Gitee Release
        releaseName: release-v.${GITEE_PIPELINE_BUILD_NUMBER}
        # Release描述：读取CHANGELOG.md内容，附加构建信息
        description: CHANGELOG.md
        # Tag名称：结合构建号生成，格式如v1.0.1
        tagName: v.${GITEE_PIPELINE_BUILD_NUMBER}
        # 上游构建产物标识
        upstreamArtifact:
          - PLUGIN_RELEASE
        # 附件文件列表
        assertFiles:
          - plugin-arm64
          - plugin-amd64
        # 预发布版本：测试阶段可改为true，正式发布改为false
        prerelease: false
        # 允许覆盖：测试阶段可改为true，正式发布改为false
        allowUpdate: true
        notify: []
        strategy:
          retry: '0'

执行效果验证

• 代码提交推送，生成CHANGELOG.md，Commit 信息为release: add artifact。

• 流水线被触发，成功完成 Gitee Go Release 任务的执行：Golang 构建、tag 创建、release 创建、附件上传。

• 进入仓库发行版页面，查看对应的 Release。

常见问题解答

Q：附件上传失败怎么办？

A：首先通过 ls 路径命令在流水线中校验文件是否存在，确认路径为源码根目录的相对路径，而非绝对路径。

Q：Tag已经存在，想更新Release内容怎么操作？

A：勾选「允许覆盖」参数，插件会用新内容覆盖同名 Tag 的旧 Release。

Q：如何自定义Release的显示名称？

A：在插件参数中添加releaseName，例如releaseName: 演示项目v1.0.${GITEE_PIPELINE_BUILD_NUMBER}。

Gitee Go Release 插件将版本发布整合入流水线流程，显著提升自动化程度，让版本发布从「繁琐操作」变成「流水线的最后一步」。无论是个人开发还是团队协作，都能通过它提升版本管理效率。

目前 Gitee Go Release 插件已在社区版与企业版全面上线，欢迎试用并在使用过程中反馈建议，我们将持续优化插件功能，支持更多发布场景。