Git SyncDashboards

Git SyncDashboards
Certified
Sync dashboards from Git

Imports dashboards from a Git branch. Can delete dashboards missing in Git, respects .kestraignore, and supports dry-run diff output.

yaml
type: io.kestra.plugin.git.SyncDashboards

Examples

Sync all dashboards from Git to Kestra every full hour.

yaml
id: git_sync
namespace: company

tasks:
  - id: sync_dashboards
    type: io.kestra.plugin.git.SyncDashboards
    gitDirectory: _dashboards
    branch: dashboards
    username: kestra-git-user
    url: https://github.com/my-company/my-repo
    password: "{{ secret('GITHUB_ACCESS_TOKEN') }}"
    dryRun: false

triggers:
  - id: every_full_hour
    type: io.kestra.plugin.core.trigger.Schedule
    cron: "0 * * * *"

Properties

auth

Kestra API authentication

Definitions

io.kestra.plugin.git.AbstractCloningTask-Auth

apiTokenstring

API token for authentication.

autobooleanstring

Defaulttrue

Automatically retrieve the URL and the credentials from Kestra's configuration if available

Can be configured globally in the Kestra configuration file:

Set kestra.tasks.sdk.authentication.url for the API URL
Set kestra.tasks.sdk.authentication.api-token for API token auth
Set kestra.tasks.sdk.authentication.username and kestra.tasks.sdk.authentication.password for HTTP Basic auth The Enterprise Edition also allows an administrator to set these defaults at the namespace or the tenant level.

passwordstring

Password for HTTP Basic authentication.

usernamestring

Username for HTTP Basic authentication.

branch string

Defaultmain

Branch to sync

Defaults to main.

cloneSubmodules booleanstring

Clone submodules

Default false; enable to fetch and initialize nested submodules.

connectTimeout integerstring

Default10000

HTTP connect timeout (ms)

Default 10000 ms.

delete booleanstring

Defaultfalse

Delete dashboards missing in Git

Default false to avoid destructive syncs.

dryRun booleanstring

Defaultfalse

Dry run only

When true, writes a diff without applying changes to Kestra.

failOnMissingDirectory booleanstring

Defaulttrue

Fail if git directory missing

Default true. If false, skips when the rendered gitDirectory path does not exist.

gitConfig object

Git configuration overrides

Map of git config keys and values applied after clone, e.g.:

core.fileMode: false (ignore permission flips)
core.autocrlf: false (preserve line endings)

gitDirectory string

Default_dashboards

Git directory for dashboards

Relative path containing dashboard YAML; defaults to _dashboards.

kestraUrl string

Kestra API URL

URL of the Kestra server API. If not set, the URL of the default SDK authentication is used, set with the kestra.tasks.sdk.authentication.url configuration property, or at the namespace or the tenant level on the Enterprise Edition. It then falls back to the kestra.url configuration property, and finally to http://localhost: 8080.

noProxy booleanstring

Disable proxy for HTTP

When true, forces direct connections instead of using the JVM proxy settings.

passphrase string

Passphrase for privateKey

password string

Password or personal access token

Supplies HTTP credentials. When a PAT is used, pushes are recorded under that PAT’s user without needing authorName and authorEmail.

**GitHub PAT permissions required: **

Fine-grained PAT: Contents: Read (clone/fetch) or Contents: Read and Write (push), plus Metadata: Read (mandatory base permission). Add Workflows: Read and Write when pushing .github/workflows/ files.
Classic PAT: repo scope covers all read/write operations; add workflow when pushing workflow files.

pluginDefaultsRef string

Reference (ref) of the pluginDefaults to apply to this task.

privateKey string

PEM private key

PEM-formatted private key matching a public key registered on the Git server. Generate with ssh-keygen -t ecdsa -b 256 -m PEM.

readTimeout integerstring

Default60000

HTTP read timeout (ms)

Default 60000 ms.

trustedCaPemPath string

Extra trusted CA PEM path

Optional PEM-encoded CA bundle added to the JVM truststore; equivalent to git config http.sslCAInfo <path> for self-signed or internal CAs.

url string

Repository URL

HTTP(S) or SSH URI used for clone and push operations.

username string

Username or organization

Used for HTTP basic authentication and as a fallback commit author.

Zulip

Tasks that send messages to Zulip streams or users.

Business

Tasks that send notifications via Telegram bots.

Business

Git SyncDashboardsCertifiedSync dashboards from Git

Git SyncDashboards

More Plugins in this Category

Zulip

Telegram

Git SyncDashboards
Certified
Sync dashboards from Git