CLI · ComandosPipelines & artefactos

Pipelines & artefactos

Inspecionar execuções de CI e o registry.

eqs runs ls

Lista as execuções de CI recentes do workspace ativo, cada uma com o seu repositório. v2.

--repo <repo>Só as execuções deste repositório: o nome completo ou um prefixo do id. Um repositório que o workspace não tem é um erro

--limit <n>Quantas mostrar (1–100, predefinição 30)

shell

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

eqs runs get <run>

Detalhes de uma execução: jobs, steps e conclusão. A execução é o seu número, o id ou um prefixo do id.

--repo <repo>O repositório da execução (nome completo ou prefixo do id). O número de uma execução conta por repositório: sem esta opção, um número que vários repositórios têm é recusado

shell

eqs runs get 1042 --repo eQuantic/demo

eqs runs logs <run>

Transmite os registos de um job de CI, o registo inteiro primeiro e depois as linhas novas enquanto corre.

--job <key>O job: a chave dele, ou o prefixo do id que o eqs runs get mostra. Uma matrix dá a mesma chave a vários jobs, e aí só o prefixo escolhe um

--repo <repo>O repositório da execução (nome completo ou prefixo do id). O número de uma execução conta por repositório: sem esta opção, um número que vários repositórios têm é recusado

shell

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

eqs runs cancel <run>

Cancela uma execução que ainda não terminou: o scheduler para, os containers em execução caem, e a execução com os jobs pendentes termina como cancelled. Precisa de run.write.

--repo <repo>O repositório da execução (nome completo ou prefixo do id). O número de uma execução conta por repositório: sem esta opção, um número que vários repositórios têm é recusado

shell

eqs runs cancel 1042 --repo eQuantic/demo

eqs runs dispatch

Dispara à mão um workflow com workflow_dispatch. O workflow é indicado pelo ficheiro, pelo caminho ou pelo name: que declara; um nome que não corresponde a nada responde com os workflows que podem ser disparados. Precisa de run.write.

--repo <r>O repositório (nome completo ou prefixo do id)

--workflow <w>O workflow: ci.yml, .github/workflows/ci.yml ou o nome declarado

--ref <ref>Branch, tag ou sha em que corre (predefinição: a branch predefinida do repositório)

--input <KEY=VALUE>Um input do workflow_dispatch; repita a flag para vários. A api valida contra o que o workflow declara

shell

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

eqs runs rerun <run>

Reexecuta uma execução já terminada. A execução mantém o número — jobs, steps e registos são reiniciados no lugar — por isso o eqs runs logs acompanha também a nova tentativa. Precisa de run.write.

--failedReexecuta só os jobs que não passaram; os que correram bem são preservados

--repo <repo>O repositório da execução (nome completo ou prefixo do id). O número de uma execução conta por repositório: sem esta opção, um número que vários repositórios têm é recusado

shell

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

eqs images ls

Lista as imagens de container no registry. v2.

shell

eqs images ls

eqs spaces ls

Lista os spaces do workspace ativo.

shell

eqs spaces ls

eqs secret ls

Lista os nomes dos secrets de CI do repositório (os valores são apenas de escrita).

--repo <r>O repositório (nome completo ou prefixo do id)

--jsonImprime o JSON bruto

shell

eqs secret ls --repo eQuantic/demo

eqs secret set <KEY>

Grava um secret. Sem =, o valor vem do stdin (ou é pedido sem eco), pelo que não fica no histórico da shell.

--repo <r>O repositório

shell

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

eqs secret rm <KEY>

Remove um secret do repositório.

--repo <r>O repositório

shell

eqs secret rm NPM_TOKEN --repo eQuantic/demo

eqs var ls

Lista as variables de CI com os respetivos valores (não são secretas).

--repo <r>O repositório

--jsonImprime o JSON bruto

shell

eqs var ls --repo eQuantic/demo

eqs var set <KEY=VALUE>

Grava uma variable. Use KEY= para gravar um valor vazio de propósito.

--repo <r>O repositório

shell

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

eqs var rm <KEY>

Remove uma variable do repositório.

--repo <r>O repositório

shell

eqs var rm REGISTRY --repo eQuantic/demo

Combine --json com jq para automações: eqs services ls --json | jq '.[].name'.