# 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.

## Flags

| Flag | Type | What it does | Default |
|---|---|---|---|
| `--event` | string | workflow_dispatch (the default: a manual run), push, pull_request or schedule; the workflow's on: must list it |  |
| `--follow, -f` | bool | stream the logs until the run ends |  |
| `--input` | stringArray | a workflow_dispatch input, name=value (repeatable) | `[]` |
| `--job` | string | only this job |  |
| `--ref` | string | branch, tag or commit (default: the default branch) |  |
| `--secret` | stringArray | hand this secret (marked --pipelines) to the jobs (repeatable) | `[]` |
| `--size` | string | sandbox size for each job, e.g. 4x8 |  |
| `--status-secret` | string | the secret that posts commit statuses |  |
| `--timeout` | duration | stop the run after this long (default 1h, at most 6h) | `0s` |
| `--token-secret` | string | the secret that clones a private repository |  |
| `--workflow` | string | only 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
```

---
Source: https://docs.kosa8.com/reference/cloud-pipelines-run/
