grafana/drone-downstream

Drone下游流水线触发插件

镜像概述和主要用途

该镜像为Drone CI/CD平台的官方插件，旨在解决流水线间的依赖调度问题。通过该插件，用户可配置在当前流水线执行特定阶段或完成后，自动触发一个或多个下游仓库的Drone流水线，实现多流水线协同工作，简化复杂项目的自动化流程管理。

核心功能和特性

• 下游流水线触发：支持在当前流水线执行完成后，自动触发指定仓库的下游流水线
• 多仓库支持：可同时配置并触发多个下游仓库的流水线，实现批量调度
• 参数传递：支持将当前流水线的环境变量、构建参数等传递给下游流水线，确保上下文一致性
• 触发条件控制：可配置触发条件（如仅当前流水线成功时触发），避免无效触发
• 状态反馈：可选等待下游流水线执行状态，并将结果反馈至当前流水线

使用场景和适用范围

• 微服务架构：服务A构建部署完成后，自动触发依赖服务B的集成测试流水线
• 多模块项目：基础模块构建完成后，触发依赖该模块的其他业务模块构建流水线
• 前端后端协同：后端API构建完成后，触发前端应用的联调测试流水线
• 发布流程衔接：应用构建测试通过后，自动触发镜像推送及生产环境部署流水线

详细使用方法和配置说明

Drone配置文件示例

在Drone流水线配置文件（.drone.yml）中添加如下步骤：

yaml
kind: pipeline
name: default

steps:
  # 其他构建/测试步骤...
  
  - name: trigger-downstream-pipelines
    image: drone/downstream-trigger  # 插件镜像名称
    settings:
      # Drone服务器地址（必填）
      server: https://drone.example.com
      # Drone API访问令牌（必填，建议通过secret管理）
      token:
        from_secret: drone_api_token
      # 下游仓库列表（必填，格式：owner/repo）
      repos:
        - myorg/service-b
        - myorg/service-c
      # 触发下游流水线的分支（可选，默认使用当前分支）
      branch: main
      # 传递给下游流水线的参数（可选）
      params:
        UPSTREAM_BUILD_ID: ${DRONE_BUILD_NUMBER}
        UPSTREAM_COMMIT: ${DRONE_COMMIT}
      # 是否等待下游流水线完成（可选，默认false）
      wait: true
      # 等待超时时间（可选，默认30m）
      timeout: 45m
    # 触发条件：仅当前流水线成功时执行（可选）
    when:
      status:
        - success

配置参数说明

环境变量说明

插件支持通过环境变量覆盖部分配置（优先级低于settings配置）：

权限要求

• Drone API令牌需具备对下游仓库的read和write权限，以触发流水线
• 确保Drone服务器可访问互联网或内部网络中的下游仓库Drone服务

注意事项

• 建议使用from_secret方式管理token参数，避免敏感信息泄露
• 当wait: true时，当前流水线会等待所有下游流水线完成，可能增加整体构建时间
• 下游流水线需正确配置以接收并使用传递的参数（通过params配置）