sinlov/woodpecker-gitea-publisher-golang

woodpecker-gitea-publisher-golang

镜像概述和主要用途

woodpecker-gitea-publisher-golang是Woodpecker CI的插件，用于将Golang包发布到Gitea的Go包注册表（[***] zip文件、干运行模式、单体仓库支持及发布信息输出等功能，适用于需要通过Woodpecker CI自动化发布Golang包到Gitea的场景。

核心功能和特性

• ✅ 推送到Gitea Go包注册表
• ✅ 使用临时目录生成go mod zip文件
• ✅ 支持干运行模式
• ✅ 通过CI_FORGE_URL自动获取Gitea基础URL
• ✅ 支持单体仓库
  • 使用settings.gitea-publish-golang-path-go逐个发布目录中的go.mod文件
• ✅ 输出发布信息JSON文件，默认路径为dist/go-mod-upload.json
  • 通过settings.gitea-publish-golang-update-result-root-path修改输出根路径，默认值为dist
  • 通过settings.gitea-publish-golang-update-result-file-name修改输出文件名，默认值为go-mod-upload.json

配置参数

基本配置

隐藏配置

使用示例

Docker后端工作流

yml
labels:
  backend: docker
steps:
  woodpecker-gitea-publisher-golang:
    image: sinlov/woodpecker-gitea-publisher-golang:latest
    pull: false
    settings:
      # debug: true  # 开启调试日志
      # gitea-publish-golang-dry-run: true  # 干运行模式（仅检查不发布）
      gitea-publish-golang-api-key:  # Gitea API密钥（必填）
        from_secret: gitea_api_key_release
      gitea-publish-golang-path-go: ""  # 发布目录（默认项目根路径）
      gitea-publish-golang-remove-paths:  # 需要移除的路径（默认包含dist）
        - "dist"
      # gitea-publish-golang-update-result-root-path: "dist"  # 输出根路径（默认dist）
      # gitea-publish-golang-update-result-file-name: "go-mod-upload.json"  # 输出文件名（默认值）

Local后端工作流（需本地安装并配置环境变量PATH）

安装插件

• 安装最新版本到${GOPATH}/bin：

  bash
  go install -a github.com/woodpecker-kit/woodpecker-gitea-publisher-golang/cmd/woodpecker-gitea-publisher-golang@latest
  

• 安装指定版本（如v1.0.0）：

  bash
  go install -v github.com/woodpecker-kit/woodpecker-gitea-publisher-golang/cmd/woodpecker-gitea-publisher-golang@v1.0.0
  

工作流配置

yml
labels:
  backend: local
steps:
  woodpecker-gitea-publisher-golang:
    image: woodpecker-gitea-publisher-golang
    settings:
      # debug: true  # 开启调试日志
      # gitea-publish-golang-dry-run: true  # 干运行模式
      gitea-publish-golang-api-key:  # Gitea API密钥（必填）
        from_secret: gitea_api_key_release
      gitea-publish-golang-path-go: ""  # 发布目录（默认项目根路径）
      gitea-publish-golang-remove-paths:
        - "dist"

完整配置示例

yaml
labels:
  backend: docker
steps:
  woodpecker-gitea-publisher-golang:
    image: sinlov/woodpecker-gitea-publisher-golang:latest
    pull: false
    settings:
      debug: true  # 开启调试日志
      gitea-publish-golang-dry-run: true  # 干运行模式
      gitea-publish-golang-timeout-second: 120  # API超时时间（秒）
      gitea-publish-golang-api-key:  # Gitea API密钥（必填）
        from_secret: gitea_api_key_release
      gitea-publish-golang-base-url: "https://gitea.example.com"  # 自定义Gitea基础URL（默认从CI_FORGE_URL获取）
      gitea-publish-golang-insecure: true  # 允许不安全连接
      gitea-publish-golang-path-go: "sub-go"  # 发布子目录（如单体仓库中的sub-go目录）
      gitea-publish-golang-remove-paths:
        - "dist"
      gitea-publish-golang-update-result-root-path: "dist"  # 输出根路径
      gitea-publish-golang-update-result-file-name: "go-mod-upload.json"  # 输出文件名

注意事项

• Go mod zip文件通过临时目录生成，发布后会尝试删除。
• 临时目录路径格式：tempDir/woodpecker-gitea-publisher-golang/{repo-hostname}/{owner}/{repo}/{build_number}

已知限制

1. Go mod zip文件通过zip.CreateFromDir生成，该方法会检查版本是否符合语义化版本规范，因此插件使用CI_COMMIT_TAG生成版本号。
2. 开启gitea-publish-golang-dry-run模式可通过所有检查，但不会实际发布到Gitea。
3. 若无标签事件（CI_COMMIT_TAG），版本会标记为latest，此版本不符合zip.CreateFromDir检查，因此不会发布到Gitea。