woodpeckerci/plugin-trigger

Woodpecker CI Trigger插件镜像

概述

Woodpecker CI Trigger插件是一个专为Woodpecker CI设计的Docker镜像，提供在CI/CD流水线中触发其他流水线、工作流或外部服务的能力。该插件允许用户在当前流水线执行过程中，根据特定条件自动启动其他自动化流程，实现复杂的构建和部署流程编排。

核心功能和特性

• 支持触发Woodpecker CI中的其他流水线
• 可配置触发条件和参数
• 支持向触发的流水线传递环境变量和参数
• 支持异步和同步触发模式
• 提供触发结果的状态反馈
• 支持重试机制和错误处理

使用场景和适用范围

• 微服务架构中的依赖服务构建触发
• 多环境部署流程（开发、测试、生产）的顺序触发
• 夜间批量任务的定时触发
• 外部系统集成（如通知系统、部署系统）
• 基于构建结果的条件触发后续流程

使用方法和配置说明

基本用法

在Woodpecker CI配置文件（.woodpecker.yml）中添加以下步骤：

yaml
steps:
  trigger-downstream:
    image: codeberg.org/woodpecker-plugins/trigger
    settings:
      repo: username/downstream-repo
      event: push
      branch: main

配置参数

Docker Run示例

bash
docker run --rm \
  -e PLUGIN_REPO=username/downstream-repo \
  -e PLUGIN_EVENT=push \
  -e PLUGIN_BRANCH=main \
  -e PLUGIN_TOKEN=your-woodpecker-token \
  -e CI_SERVER_URL=https://woodpecker.example.com \
  codeberg.org/woodpecker-plugins/trigger

高级配置示例

传递参数和环境变量：

yaml
steps:
  trigger-deployment:
    image: codeberg.org/woodpecker-plugins/trigger
    settings:
      repo: username/deployment-repo
      event: custom
      branch: main
      token:
        from_secret: woodpecker_token
      wait: true
      timeout: 600
      parameters:
        app_version: ${CI_COMMIT_SHA:0:8}
        deploy_env: production
      environment:
        - DB_PASSWORD=${DB_PASSWORD}
        - API_KEY=${API_KEY}

注意事项

• 确保提供的Woodpecker令牌具有足够的权限来触发目标仓库的流水线
• 同步触发（wait: true）会阻塞当前流水线直到触发的流水线完成
• 长时间运行的触发可能导致当前流水线超时
• 敏感信息应使用Woodpecker的secret功能进行管理，避免直接在配置中暴露