kosa8 docs

Commands / kosa8 cloud pipelines run

kosa8 cloud pipelines run

Start a pipeline run of a repository

Usage

kosa8 cloud pipelines run REPO_URL

--secret NAME hands a secret marked --pipelines to every job as an environment variable (npm-token becomes NPM_TOKEN). --token-secret names the secret that clones a private repository; --status-secret the one that posts commit statuses. --follow streams the logs until the run ends and exits non-zero if it failed.

Options

FlagTypeWhat it doesDefault
--eventstringworkflow_dispatch (the default: a manual run), push, pull_request or schedule; the workflow's on: must list it—
-f, --followboolstream the logs until the run ends—
--inputstringArraya workflow_dispatch input, name=value (repeatable)[]
--jobstringonly this job—
--refstringbranch, tag or commit (default: the default branch)—
--secretstringArrayhand this secret (marked --pipelines) to the jobs (repeatable)[]
--sizestringsandbox size for each job, e.g. 4x8—
--status-secretstringthe secret that posts commit statuses—
--timeoutdurationstop the run after this long (default 1h, at most 6h)0s
--token-secretstringthe secret that clones a private repository—
--workflowstringonly this file in .github/workflows—

Example

  kosa8 cloud pipelines run https://github.com/acme/app
  kosa8 cloud pipelines run https://github.com/acme/app --ref v1.2 --job test --size 4x8 --follow
  kosa8 cloud pipelines run https://github.com/acme/app --event workflow_dispatch --workflow release.yml --input version=1.2