Skip to content

guilouro/multiple-repositories-dispatch

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

Multiple Repositories Dispatch

An action to dispatch event to multiple repositories.

How to use

- name: Dispatch event
  uses: guilouro/multiple-repositories-dispatch@latest
  with:
    repo_token: ${{ secrets.REPO_TOKEN }}
    event_type: event_name
    repositories: |
      user/repo1
      user/repo2
    client_payload: '{"github": ${{ toJson(github) }}}'

Action params

Name Required Description Default
repo_token true The Personal Access Token with repo scope of the project which will receive the event
event_type true Event type name that will be used in on: repository_dispatch
repositories true A list of repositories that will receive the event. org/repo
client_payload false JSON payload with extra data {}

Obs: The client_payload is able to send a json with a maximum of 10 top-level as a specification of Github API. Therefore, set the value as this example below when need more than 10

client_payload: '{"github": ${{ toJson(github) }}}'

How to receive the event

name: Receive Dispatch
on:
  repository_dispatch:
    types: [event_name]
jobs:
  echo:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
        run: echo ${{ github.event.client_payload }}

License

MIT

About

An action to dispatch event to multiple repositories

Resources

License

Stars

Watchers

Forks

Packages

No packages published