Skip to main content
Version: Next

CLI

NAME

woodpecker-cli - command line utility

SYNOPSIS

woodpecker-cli

[--log-level]=[value]
[--server|-s]=[value]
[--token|-t]=[value]

Usage:

woodpecker-cli [GLOBAL OPTIONS] command [COMMAND OPTIONS] [ARGUMENTS...]

GLOBAL OPTIONS

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

COMMANDS

pipeline, buildโ€‹

manage pipelines

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

lsโ€‹

show pipeline history

--branch="": branch filter

--event="": event filter

--format="": format output (default: Build #{{ .Number }}  Status: {{ .Status }} Event: {{ .Event }} Commit: {{ .Commit }} Branch: {{ .Branch }} Ref: {{ .Ref }} Author: {{ .Author }} {{ if .Email }}<{{.Email}}>{{ end }} Message: {{ .Message }} )

--limit="": limit the list size (default: 25)

--log-level="": set logging level (default: info)

--server, -s="": server address

--status="": status filter

--token, -t="": server auth token

lastโ€‹

show latest pipeline details

--branch="": branch name (default: master)

--format="": format output (default: Number: {{ .Number }} Status: {{ .Status }} Event: {{ .Event }} Commit: {{ .Commit }} Branch: {{ .Branch }} Ref: {{ .Ref }} Message: {{ .Message }} Author: {{ .Author }} )

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

logsโ€‹

show pipeline logs

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

infoโ€‹

show pipeline details

--format="": format output (default: Number: {{ .Number }} Status: {{ .Status }} Event: {{ .Event }} Commit: {{ .Commit }} Branch: {{ .Branch }} Ref: {{ .Ref }} Message: {{ .Message }} Author: {{ .Author }} )

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

stopโ€‹

stop a pipeline

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

startโ€‹

start a pipeline

--log-level="": set logging level (default: info)

--param, -p="": custom parameters to be injected into the step environment. Format: KEY=value

--server, -s="": server address

--token, -t="": server auth token

approveโ€‹

approve a pipeline

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

declineโ€‹

decline a pipeline

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

queueโ€‹

show pipeline queue

--format="": format output (default: {{ .FullName }} #{{ .Number }}  Status: {{ .Status }} Event: {{ .Event }} Commit: {{ .Commit }} Branch: {{ .Branch }} Ref: {{ .Ref }} Author: {{ .Author }} {{ if .Email }}<{{.Email}}>{{ end }} Message: {{ .Message }} )

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

psโ€‹

show pipeline steps

--format="": format output (default: Step #{{ .PID }}  Step: {{ .Name }} State: {{ .State }} )

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

createโ€‹

create new pipeline

--branch="": branch to create pipeline from

--format="": format output (default: Build #{{ .Number }}  Status: {{ .Status }} Event: {{ .Event }} Commit: {{ .Commit }} Branch: {{ .Branch }} Ref: {{ .Ref }} Author: {{ .Author }} {{ if .Email }}<{{.Email}}>{{ end }} Message: {{ .Message }} )

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

--var="": key=value

logโ€‹

manage logs

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

purgeโ€‹

purge a log

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

deployโ€‹

deploy code

--branch="": branch filter (default: master)

--event="": event filter (default: push)

--format="": format output (default: Number: {{ .Number }} Status: {{ .Status }} Commit: {{ .Commit }} Branch: {{ .Branch }} Ref: {{ .Ref }} Message: {{ .Message }} Author: {{ .Author }} Target: {{ .Deploy }} )

--log-level="": set logging level (default: info)

--param, -p="": custom parameters to be injected into the step environment. Format: KEY=value

--server, -s="": server address

--status="": status filter (default: success)

--token, -t="": server auth token

execโ€‹

execute a local pipeline

--backend-engine="": backend engine to run pipelines on (default: auto-detect)

--backend-k8s-namespace="": backend k8s namespace (default: woodpecker)

--backend-k8s-pod-annotations="": backend k8s additional worker pod annotations

--backend-k8s-pod-labels="": backend k8s additional worker pod labels

--backend-k8s-storage-class="": backend k8s storage class

--backend-k8s-storage-rwx: backend k8s storage access mode, should ReadWriteMany (RWX) instead of ReadWriteOnce (RWO) be used? (default: true)

--backend-k8s-volume-size="": backend k8s volume size (default 10G) (default: 10G)

--commit-author-avatar="":

--commit-author-email="":

--commit-author-name="":

--commit-branch="":

--commit-message="":

--commit-ref="":

--commit-refspec="":

--commit-sha="":

--env="":

--local: run from local directory

--log-level="": set logging level (default: info)

--netrc-machine="":

--netrc-password="":

--netrc-username="":

--network="": external networks

--pipeline-created="": (default: 0)

--pipeline-event="": (default: manual)

--pipeline-finished="": (default: 0)

--pipeline-link="":

--pipeline-number="": (default: 0)

--pipeline-parent="": (default: 0)

--pipeline-started="": (default: 0)

--pipeline-status="":

--pipeline-target="":

--prev-commit-author-avatar="":

--prev-commit-author-email="":

--prev-commit-author-name="":

--prev-commit-branch="":

--prev-commit-message="":

--prev-commit-ref="":

--prev-commit-refspec="":

--prev-commit-sha="":

--prev-pipeline-created="": (default: 0)

--prev-pipeline-event="":

--prev-pipeline-finished="": (default: 0)

--prev-pipeline-link="":

--prev-pipeline-number="": (default: 0)

--prev-pipeline-started="": (default: 0)

--prev-pipeline-status="":

--privileged="": privileged plugins (default: "plugins/docker", "plugins/gcr", "plugins/ecr", "woodpeckerci/plugin-docker-buildx")

--repo-clone-url="":

--repo-link="":

--repo-name="":

--repo-private="":

--server, -s="": server address

--step-number="": (default: 0)

--system-link="": (default: https://github.com/woodpecker-ci/woodpecker)

--system-name="": (default: woodpecker)

--system-platform="":

--timeout="": pipeline timeout (default: 1h0m0s)

--token, -t="": server auth token

--volumes="": pipeline volumes

--workspace-base="": (default: /woodpecker)

--workspace-path="": (default: src)

infoโ€‹

show information about the current user

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

registryโ€‹

manage registries

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

addโ€‹

adds a registry

--hostname="": registry hostname (default: docker.io)

--log-level="": set logging level (default: info)

--password="": registry password

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token

--username="": registry username

rmโ€‹

remove a registry

--hostname="": registry hostname (default: docker.io)

--log-level="": set logging level (default: info)

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token

updateโ€‹

update a registry

--hostname="": registry hostname (default: docker.io)

--log-level="": set logging level (default: info)

--password="": registry password

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token

--username="": registry username

infoโ€‹

display registry info

--hostname="": registry hostname (default: docker.io)

--log-level="": set logging level (default: info)

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token

lsโ€‹

list registries

--log-level="": set logging level (default: info)

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token

secretโ€‹

manage secrets

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

addโ€‹

adds a secret

--event="": secret limited to these events

--global: global secret

--image="": secret limited to these images

--log-level="": set logging level (default: info)

--name="": secret name

--organization="": organization name (e.g. octocat)

--plugins-only: secret limited to plugins

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token

--value="": secret value

rmโ€‹

remove a secret

--global: global secret

--log-level="": set logging level (default: info)

--name="": secret name

--organization="": organization name (e.g. octocat)

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token

updateโ€‹

update a secret

--event="": secret limited to these events

--global: global secret

--image="": secret limited to these images

--log-level="": set logging level (default: info)

--name="": secret name

--organization="": organization name (e.g. octocat)

--plugins-only: secret limited to plugins

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token

--value="": secret value

infoโ€‹

display secret info

--global: global secret

--log-level="": set logging level (default: info)

--name="": secret name

--organization="": organization name (e.g. octocat)

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token

lsโ€‹

list secrets

--global: global secret

--log-level="": set logging level (default: info)

--organization="": organization name (e.g. octocat)

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token

repoโ€‹

manage repositories

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

lsโ€‹

list all repos

--format="": format output (default: {{ .FullName }})

--log-level="": set logging level (default: info)

--org="": filter by organization

--server, -s="": server address

--token, -t="": server auth token

infoโ€‹

show repository details

--format="": format output (default: Owner: {{ .Owner }} Repo: {{ .Name }} Type: {{ .Kind }} Config: {{ .Config }} Visibility: {{ .Visibility }} Private: {{ .IsSCMPrivate }} Trusted: {{ .IsTrusted }} Gated: {{ .IsGated }} Forge: {{ .Clone }} )

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

addโ€‹

add a repository

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

updateโ€‹

update a repository

--config="": repository configuration path (e.g. .woodpecker.yml)

--gated: repository is gated

--log-level="": set logging level (default: info)

--pipeline-counter="": repository starting pipeline number (default: 0)

--server, -s="": server address

--timeout="": repository timeout (default: 0s)

--token, -t="": server auth token

--trusted: repository is trusted

--unsafe: validate updating the pipeline-counter is unsafe

--visibility="": repository visibility

rmโ€‹

remove a repository

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

repairโ€‹

repair repository webhooks

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

chownโ€‹

assume ownership of a repository

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

syncโ€‹

synchronize the repository list

--format="": format output (default: {{ .FullName }})

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

userโ€‹

manage users

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

lsโ€‹

list all users

--format="": format output (default: {{ .Login }})

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

infoโ€‹

show user details

--format="": format output (default: User: {{ .Login }} Email: {{ .Email }})

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

addโ€‹

adds a user

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

rmโ€‹

remove a user

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

lintโ€‹

lint a pipeline configuration file

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

log-levelโ€‹

get the logging level of the server, or set it with [level]

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

cronโ€‹

manage cron jobs

--log-level="": set logging level (default: info)

--server, -s="": server address

--token, -t="": server auth token

addโ€‹

add a cron job

--branch="": cron branch

--log-level="": set logging level (default: info)

--name="": cron name

--repository, --repo="": repository name (e.g. octocat/hello-world)

--schedule="": cron schedule

--server, -s="": server address

--token, -t="": server auth token

rmโ€‹

remove a cron job

--id="": cron id

--log-level="": set logging level (default: info)

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token

updateโ€‹

update a cron job

--branch="": cron branch

--id="": cron id

--log-level="": set logging level (default: info)

--name="": cron name

--repository, --repo="": repository name (e.g. octocat/hello-world)

--schedule="": cron schedule

--server, -s="": server address

--token, -t="": server auth token

infoโ€‹

display info about a cron job

--id="": cron id

--log-level="": set logging level (default: info)

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token

lsโ€‹

list cron jobs

--log-level="": set logging level (default: info)

--repository, --repo="": repository name (e.g. octocat/hello-world)

--server, -s="": server address

--token, -t="": server auth token