CLI · CommandsPipelines & artifacts

Pipelines & artifacts

Inspect CI runs and the registry.

eqs runs ls

Lists the active workspace's recent CI runs, each with its repository. v2.

--repo <repo>Only this repository's runs: its full name or an id prefix. A repository the workspace does not have is an error

--limit <n>How many to show (1–100, default 30)

shell

eqs runs ls --repo eQuantic/demo --limit 10

eqs runs get <run>

Details of a run: jobs, steps and outcome. The run is its number, its id or an id prefix.

--repo <repo>The run's repository (full name or id prefix). Run numbers count per repository: without it, a number several repositories have is refused

shell

eqs runs get 1042 --repo eQuantic/demo

eqs runs logs <run>

Streams a CI job's logs, the whole log first and then new lines while it runs.

--job <key>The job: its key, or the id prefix eqs runs get shows. A matrix gives several jobs one key, and then only the prefix picks one

--repo <repo>The run's repository (full name or id prefix). Run numbers count per repository: without it, a number several repositories have is refused

shell

eqs runs logs 1042 --repo eQuantic/demo --job build

eqs runs cancel <run>

Cancels a run that has not finished yet: the scheduler stops, the live containers come down, and the run with its unfinished jobs ends as cancelled. Needs run.write.

--repo <repo>The run's repository (full name or id prefix). Run numbers count per repository: without it, a number several repositories have is refused

shell

eqs runs cancel 1042 --repo eQuantic/demo

eqs runs dispatch

Starts a workflow_dispatch workflow by hand. The workflow is named by its file, its path or the name: it declares; a name that matches nothing answers with the workflows that can be dispatched. Needs run.write.

--repo <r>The repository (full name or id prefix)

--workflow <w>The workflow: ci.yml, .github/workflows/ci.yml or its declared name

--ref <ref>Branch, tag or sha to run on (default: the repository's default branch)

--input <KEY=VALUE>A workflow_dispatch input; repeat the flag for several. The api checks them against the workflow's declarations

shell

eqs runs dispatch --repo eQuantic/demo --workflow ci.yml --input target=linux

eqs runs rerun <run>

Re-runs a finished run. The run keeps its number — its jobs, steps and logs are reset in place — so eqs runs logs follows the new attempt too. Needs run.write.

--failedRe-run only the jobs that didn't succeed; the successful ones are kept

--repo <repo>The run's repository (full name or id prefix). Run numbers count per repository: without it, a number several repositories have is refused

shell

eqs runs rerun 1042 --repo eQuantic/demo --failed

eqs images ls

Lists the container images in the registry. v2.

shell

eqs images ls

eqs spaces ls

Lists the active workspace's spaces.

shell

eqs spaces ls

eqs secret ls

List the repository's CI secret names (values are write-only).

--repo <r>The repository (full name or id prefix)

--jsonPrint the raw JSON

shell

eqs secret ls --repo eQuantic/demo

eqs secret set <KEY>

Upsert a secret. Without = the value comes from stdin (or is asked for with the echo muted), so it never reaches your shell history.

--repo <r>The repository

shell

printf '%s' "$TOKEN" | eqs secret set NPM_TOKEN --repo eQuantic/demo

eqs secret rm <KEY>

Remove a secret from the repository.

--repo <r>The repository

shell

eqs secret rm NPM_TOKEN --repo eQuantic/demo

eqs var ls

List the CI variables with their values (they are not secret).

--repo <r>The repository

--jsonPrint the raw JSON

shell

eqs var ls --repo eQuantic/demo

eqs var set <KEY=VALUE>

Upsert a variable. Use KEY= to store a deliberately empty value.

--repo <r>The repository

shell

eqs var set REGISTRY=ghcr.io --repo eQuantic/demo

eqs var rm <KEY>

Remove a variable from the repository.

--repo <r>The repository

shell

eqs var rm REGISTRY --repo eQuantic/demo

Combine --json with jq for automation: eqs services ls --json | jq '.[].name'.