Git PushDashboards

Git PushDashboards
Certified
Push dashboards to Git

Commits saved dashboards to Git under gitDirectory (default _dashboards), filtered by glob patterns. Creates the branch if missing; supports dry-run diff generation.

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

Examples

Manually push a single dashboard to Git if the input push is set to true.

yaml
id: push_dashboards
namespace: prod

inputs:
  - id: push
    type: BOOL
    defaults: false

tasks:
  - id: if
    type: io.kestra.plugin.core.flow.If
    condition: "{{ inputs.push == true}}"
    then:
      - id: commit_and_push
        type: io.kestra.plugin.git.PushDashboards
        dashboards: mydashboard # if you prefer templating, you can use "{{ flow.id }}"
        url: https://github.com/kestra-io/scripts
        username: git_username
        password: "{{ secret('GITHUB_ACCESS_TOKEN') }}"
        branch: main
        commitMessage: "add mydashboard from {{ flow.namespace ~ '.' ~ flow.id }}"

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.

authorEmail string

Commit author email

If null, no author is set.

authorName string

Commit author name

Defaults to username when empty.

branch string

Defaultmain

Branch to push dashboards

Defaults to main; created if it does not exist.

cloneSubmodules booleanstring

Clone submodules

Default false; enable to fetch and initialize nested submodules.

commitMessage string

DefaultAdd dashboards from flow: {{ flow.id }}

Git commit message

connectTimeout integerstring

Default10000

HTTP connect timeout (ms)

Default 10000 ms.

dashboards stringarray

Default**

Dashboards to include

Glob pattern(s) matching dashboard IDs; defaults to all (**).

delete booleanstring

Defaulttrue

Delete removed resources

If true (default), removes Git files that no longer exist in Kestra.

dryRun booleanstring

Defaultfalse

Dry run only

When true, writes a diff file without pushing. Default false pushes immediately.

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

Dashboard destination directory

Relative path inside the repository; 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.