CI CLI Command Reference

Every dcloud ci command. The shape is dcloud <service> <resource> <verb>; every command also takes the global flags (--json, --profile, --dry-run, …).

dcloud ci workflows

Workflow files: check one, or convert one from another CI system

  • validateCheck a workflow file against the parser without pushing it
  • convertTranslate a GitHub Actions or GitLab CI file into a Deutsche Cloud workflow

dcloud ci runners

Self-hosted machines that claim runs their labels match

  • listList the self-hosted runners registered to this organization
  • create-registration-tokenIssue a one-time token a machine registers itself with
  • set-groupMove a runner into a runner group, or back to Default
  • disableDisable a runner and revoke its credential

dcloud ci runner-groups

Which runs self-hosted runners may take: repositories, refs, protected branches only, pull requests

  • listList the runner groups of this organization
  • createCreate a runner group
  • updateChange a runner group
  • deleteDelete a runner group

dcloud ci runner-pools

Machines the platform starts for GitHub-syntax jobs whose labels a pool carries, one job per just-in-time runner

  • listList the runner pools of this organization
  • getA pool with its machines, waiting and running jobs, and the last scaling decision
  • createCreate a runner pool
  • updateChange a pool’s labels, sizes, spare machines or machine reuse
  • deleteDelete a pool: its machines drain (a running job finishes) and go

dcloud ci runs

Workflow runs: one per push, pull request or re-run

  • listList a repository’s most recent runs, newest first
  • getOne run with its jobs and their steps, each with status and timing
  • cancelCancel a run that is queued or in progress
  • rerunStart a new run of the same workflow at the same commit

dcloud ci dispatch

Start a workflow by hand (workflow_dispatch / on.manual)

  • startRun one workflow file now, at a branch or tag, with inputs

dcloud ci jobs

One job of a run: a machine running its steps

  • logsRead one page of a job’s log

dcloud ci variables

Configuration variables — the `vars` context of GitHub-syntax workflows

dcloud ci environments

Deployment environments: who may deploy where, from which branches, after whose approval

  • listList a repository’s environments and their protection rules
  • putCreate an environment or change its protection rules
  • deleteDelete an environment with its rules and variables
  • approvalsJobs waiting at an environment for a reviewer (all=true: decided ones too)
  • reviewApprove or reject a job waiting at an environment

dcloud ci artifacts

Files a run uploaded, kept until they expire

  • listList a run’s artifacts with size and expiry
  • downloadDownload an artifact

Generated from the API description, the same one the API checks requests against and the CLI is built from.