Github Search Downstream

The example Yaml configurations in this file are using the legacy 0.8 syntax. If you are using Drone 1.0 or Drone Cloud please ensure you use the appropriate 1.0 syntax. Learn more here.

Use this plugin to trigger builds for a list of downstream repositories fetched from a Github repository search. This is useful when updates to a repository have downstream impacts that should also be tested, and those repository are searchable on Github.

This plugin is heavily based on the original Downstream plugin.

pipeline:
  trigger:
    image: gboo/github-search-downsream
    github_query: "org:drone-plugins topic:drone-plugin"
    drone_server: https://drone.example.com
    drone_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Example target specific branches:

pipeline:
  trigger:
    image: gboo/github-search-downsream
    github_query: "org:drone-plugins topic:drone-plugin"
    drone_server: https://drone.example.com
    drone_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+   branch: develop

Example with Github authentication:

pipeline:
  trigger:
    image: gboo/github-search-downsream
    github_query: "org:drone-plugins topic:drone-plugin"
+   github_token: d8e8fca2dc0f896fd7cb4cb0031ba249
    drone_server: https://drone.example.com
    drone_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

This plugins also supports sourcing sensitive parameters from the secret store. Example configuration sources the token from the secret store:

pipeline:
  trigger:
    image: gboo/github-search-downsream
    github_query: "org:drone-plugins topic:drone-plugin"
-   github_token: d8e8fca2dc0f896fd7cb4cb0031ba249
    drone_server: https://drone.example.com
-   drone_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+   secrets: [ drone_token, github_token ]

Secret Reference

drone_token: drone server auth token
drone_server: drone server url
github_token: Github authentication token

Parameter Reference

drone_token: drone server auth token
drone_server: drone server url
ignore_missing: continue triggering if build is not found
wait: wait for any currently running builds to finish if true, else fails
timeout: how long to wait on any currently running builds defaults to 60 seconds