yusoltsev/drone-trigger-build repository overview

⁠drone-trigger-build

Drone CI / CD plugin to trigger builds for a list of downstream repositories.

This project uses the Build Create method⁠ of the Drone API to trigger builds with specified parameters for the listed repositories, partially replicating the functionality of drone-plugins/drone-downstream⁠ but with several improvements:

1. This project creates a new build instead of restarting the previous one.
2. It correctly parses the parameters with commas (e.g. KEY=VALUE1,VALUE2,VALUE3).
3. It builds as a multi-platform Docker image (linux/amd64, linux/arm64).

⁠Usage

⁠Drone Pipeline

kind: pipeline
name: default

steps:
  - name: trigger
    image: yusoltsev/drone-trigger-build
    settings:
      server: https://drone.example.com
      token:
        from_secret: drone_token
      repositories:
        - octocat/Hello-World
        - octocat/Spoon-Knife
      params:
        - KEY=VALUE
        - FOO=BAR

⁠Docker

$ docker run --rm \
  -e PLUGIN_SERVER=https://drone.example.com \
  -e PLUGIN_TOKEN=<drone_token> \
  -e PLUGIN_REPOSITORIES=octocat/Hello-World,octocat/Spoon-Knife \
  -e PLUGIN_PARAMS=KEY=VALUE,FOO=BAR \
  -v $(pwd):$(pwd) \
  -w $(pwd) \
  yusoltsev/drone-trigger-build

⁠Configuration

Drone passes each settings key to the plugin as a PLUGIN_* environment variable. All four are required; the plugin exits with an error when one is missing or empty.

A failed build request for one repository is logged and does not stop the others or change the exit code.

⁠Docker Images

This application is delivered as a multi-platform Docker image and is available for download from two image registries of choice: yusoltsev/drone-trigger-build⁠ and ghcr.io/yegor-usoltsev/drone-trigger-build⁠.

⁠Versioning

This project uses Semantic Versioning⁠

⁠Contributing

Pull requests are welcome. For major changes, please open an issue⁠ first to discuss what you would like to change. Please make sure to update tests as appropriate.

⁠License

MIT⁠