[kayibal]

Adds sync-grafana-dashboards.yaml, a reusable workflow that pushes Grafana dashboard JSON files from the calling repository to Grafana through the dashboards API.

• On a push, it sends only the .json files under dashboards_path that the push added or changed. If nothing under the path changed, the push step is skipped, so the job can sit in an existing main workflow without a paths: filter.
• On workflow_dispatch, or on a push with no previous commit, it sends every dashboard under the path.
• Each file must have a fixed uid. A file without one fails the job, because Grafana would otherwise create a new copy on each push.
• Deleting a file does not delete the dashboard. Edits made in the Grafana UI are overwritten the next time the file changes.
• The job summary links to each dashboard it updated.

Usage

Call it once per dashboard directory. Each call can target its own Grafana folder.

  sync-grafana-dashboards:
    uses: propeller-heads/ci-cd-templates/.github/workflows/sync-grafana-dashboards.yaml@main
    with:
      dashboards_path: ops/grafana/dashboards
      folder_uid: <grafana-folder-uid>   # optional, empty = General
    secrets:
      grafana_token: ${{ secrets.GRAFANA_SA_TOKEN }}

The token is a Grafana service account token with dashboards:write on the target folder. grafana_url defaults to https://grafana.propellerheads.xyz.

Testing

actionlint, zizmor and shellcheck report nothing. I ran both steps locally against a scratch repository and against grafana.propellerheads.xyz, using a separate test dashboard (tycho-router-trades-ci-test in the tmp folder):

Case	Result
Dashboards added, one of them in a subdirectory	both selected
Push that changed only other files	count=0, push step skipped
Zero before SHA, or workflow_dispatch	all dashboards selected
dashboards_path does not exist	fails with an error
File without uid	fails and names the file
Invalid token	fails and shows Grafana's 401 message
Real push	test dashboard updated in place

🤖 Generated with Claude Code

[michcio1234]

Nice 👌🏻