woodpeckerci/plugin-trigger Docker Image Overview

woodpeckerci/plugin-trigger

woodpeckerci

Woodpecker CI的trigger插件Docker镜像，用于在CI/CD流程中触发其他流水线、工作流或外部服务，支持灵活配置触发条件和参数，简化自动化流程编排。

下载次数: 0状态：社区镜像维护者：woodpeckerci仓库类型：镜像最近更新：10 天前

轩辕镜像，不浪费每一次拉取。点击查看

中文简介版本下载

轩辕镜像，不浪费每一次拉取。点击查看

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

配置参数

参数	描述	类型	是否必填	默认值
repo	目标仓库，格式为"owner/name"	string	是	-
event	触发事件类型（push, pull_request, tag等）	string	否	push
branch	目标分支	string	否	main
status	触发状态（success, failure, always）	string	否	success
token	Woodpecker API令牌	string	是	-
base_url	Woodpecker服务器URL	string	否	CI_SERVER_URL环境变量
parameters	传递给目标流水线的参数	map	否	{}
environment	传递给目标流水线的环境变量	map	否	{}
wait	是否等待触发的流水线完成	bool	否	false
timeout	等待超时时间（秒）	int	否	300
retry	失败重试次数	int	否	0
retry_delay	重试延迟时间（秒）	int	否	10

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}