kosa8 docs

Commands / kosa8 ci run

kosa8 ci run

Start a pipeline run and follow its logs

Starts a run of a repository at a ref (default: this checkout's origin and branch; push first: the run clones from the git host, not from this machine). Prints the logs as they come and exits non-zero unless the run succeeds; --detach prints the run's ID and returns.

Options

FlagTypeWhat it doesDefault
--detachboolprint the run's ID and return—
--eventstringpush, pull_request, workflow_dispatch (default) or schedule—
--inputstringArrayworkflow_dispatch input NAME=value; repeat[]
--jobstringact runs: one job id—
--refstringbranch, tag or SHA (default: this checkout's branch)—
--repostringhttps:// clone URL (default: this checkout's origin)—
--secretstringArraya kosa8 secret (made with pipelines: true) to give the jobs; repeat[]
--sizestringact runs: the sandbox size, such as 4x8—
--status-secretstringa secret with a GitHub token that sets the commit's status—
--timeoutdurationthe run's limit (default 1h, at most 6h)0s
--token-secretstringa secret with a token that can clone the repository (private repositories)—
--workflowstringact runs: one file in .github/workflows, such as ci.yml—