sinlov/drone-gitea-cc-release

https://img.shields.io/docker/v/sinlov/drone-gitea-cc-release?sort=semver](https://hub.docker.com/r/sinlov/drone-gitea-cc-release/tags?page=1&ordering=last_updated) https://img.shields.io/docker/image-size/sinlov/drone-gitea-cc-release](https://hub.docker.com/r/sinlov/drone-gitea-cc-release) https://img.shields.io/docker/pulls/sinlov/drone-gitea-cc-release](https://hub.docker.com/r/sinlov/drone-gitea-cc-release/tags?page=1&ordering=last_updated) https://img.shields.io/github/v/release/convention-change/drone-gitea-cc-release?style=social](https://github.com/convention-change/drone-gitea-cc-release/releases)

镜像概述

sinlov/drone-gitea-cc-release 是一个Drone CI/CD插件，用于与Gitea集成实现自动化版本发布。该插件支持读取conventional-commits规范的变更日志，通过Git标签触发发布流程，上传指定文件并生成校验和，同时支持Gitea的Go包发布功能。

核心功能

• ✅ 仅支持通过Git标签触发Gitea发布（需Gitea环境）
• ✅ 使用Gitea访问令牌（Access Token）进行认证
• ✅ 通过glob模式上传发布文件
• ✅ 支持生成校验和文件（支持md5、sha1、sha256等算法）
• ✅ 读取conventional-commits规范的变更日志
• ✅ 支持干运行模式（v1.4.0+版本）
• ✅ 包发布支持：
  • ✅ Go包发布（需Gitea 1.20.1+，需设置gitea_publish_package_go: true，详见Gitea Go包文档）
  • ✅ Go包发布时可通过gitea_publish_go_remove_paths移除指定路径（v1.3.0+版本）
• ❌ 完善测试用例覆盖（开发中）
• 更多功能详见https://github.com/convention-change/drone-gitea-cc-release/blob/main/CHANGELOG.md

使用场景

适用于使用Drone CI/CD且需要自动化发布到Gitea的项目，尤其适合：

• 遵循conventional-commits规范的项目，需要自动生成发布说明
• 需要上传多文件到Gitea发布并生成校验和的场景
• 使用Gitea 1.20.1+版本并需要发布Go包的Go项目

使用方法

前置准备

1. 确保项目遵循https://www.conventionalcommits.org/
2. 获取Gitea访问令牌（Access Token），用于release_gitea_api_key配置（详见Gitea API认证文档）
3. 在Drone流水线配置文件（.drone.yml）中添加发布步骤

流水线配置示例（.drone.yml）

基础配置（1.x版本）

yaml
kind: pipeline
type: docker
name: basic-docker

steps:
  - name: gitea-cc-release
    image: docker.xuanyuan.run/sinlov/drone-gitea-cc-release:1.3.1 # 镜像标签详见 https://hub.docker.com/r/sinlov/drone-gitea-cc-release/tags
    pull: if-not-exists
    settings:
      prerelease: true # 是否为预发布，默认true
      release_gitea_base_url: https://gitea.xxxx.com # Gitea基础URL
      release_gitea_api_key:
        from_secret: release_gitea_api_key # 从Drone密钥中获取Gitea访问令牌
      release_gitea_files: # 按glob模式指定发布文件
        - "doc/*.md"
      release_gitea_files_checksum: # 生成指定类型的校验和，支持 [ md5 sha1 sha256 sha512 adler32 crc32 blake2b blake2s ]
        - md5
        - sha1
        - sha256
      release_gitea_file_exists_do: "overwrite" # 文件已存在时的处理策略，默认skip，支持 [ fail skip overwrite ]
      release_gitea_note_by_convention_change: true # 是否通过conventional-commits生成发布说明，默认false
      # gitea_publish_package_go: true # 启用Go包发布（需Gitea 1.20.1+），默认false
      # gitea_publish_package_path_go: "" # Go包发布路径（寻找go.mod），默认使用Git根目录
      # gitea_publish_go_remove_paths: ['dist'] # Go包发布前移除的路径（相对于gitea_publish_package_path_go）
    when:
      event: # 仅在tag事件触发时执行
        - tag

完整配置（1.x版本）

yaml
kind: pipeline
type: docker
name: basic-docker

steps:
  - name: gitea-cc-release
    image: docker.xuanyuan.run/sinlov/drone-gitea-cc-release:1.3.1 # 镜像标签详见 https://hub.docker.com/r/sinlov/drone-gitea-cc-release/tags
    pull: if-not-exists
    settings:
      # debug: true # 插件调试开关
      prerelease: true # 是否为预发布，默认true
      draft: true # 是否为草稿发布，默认false
      release_gitea_base_url: https://gitea.xxxx.com # Gitea基础URL
      release_gitea_api_key:
        from_secret: release_gitea_api_key # 从Drone密钥中获取Gitea访问令牌
      # release_gitea_insecure: false # 是否允许不安全的HTTPS连接，默认false
      release_gitea_file_root_path: "" # 发布文件的根路径，默认使用当前工作目录
      release_gitea_files: # 按glob模式指定发布文件
        - "doc/*.md"
        - "**/*.zip"
      release_gitea_files_checksum: # 生成指定类型的校验和
        - md5
        - sha1
        - sha256
      release_gitea_file_exists_do: "overwrite" # 文件已存在时的处理策略
      release_gitea_note_by_convention_change: true # 通过conventional-commits生成发布说明
      # release_read_change_log_file: CHANGELOG.md # 变更日志文件路径，默认CHANGELOG.md
      # release_gitea_title: "" # 发布标题，若启用release_gitea_note_by_convention_change则被覆盖，默认使用标签名
      # release_gitea_note: "" # 发布说明，若启用release_gitea_note_by_convention_change则被覆盖
      gitea_publish_package_go: true # 启用Go包发布（需Gitea 1.20.1+）
      gitea_publish_package_path_go: "" # Go包发布路径
      gitea_publish_go_remove_paths: ['dist'] # Go包发布前移除的路径
    when:
      event:
        - tag

配置参数说明