vole

Clone

Read only, no credentials:

https://rodent.software/vole.git

Write over SSH with a registered key:

git clone ssh://git@rodent.software:2222/vole.git

A free and open-source forge that lives in your Git repo.

Read a run and its log from the CLI

92d8afc86ab7a5e8f2e56a8981e0614aa55980f1 · Keenan Nemetz · 3h ago · parent 4b8c9e1d

Read a run and its log from the CLI

The queue and its logs live on the instance, so the CLI now has read verbs
beside the cancel and rerun writes: run list, run show and run logs. They
check the repository's read capability, scope an id to its repository, and
stream a log to stdout with refusals on stderr.

change show lists the runs for the head and, when the landing needs one, the
combined result, so a red check carries the id needed to open it. The queue
search narrows by status, branch and commit prefix without a pager.

closes: 01M6YZAQZVJWTA9BA5RV2H6PQ8

docs/runner.md +15

@@ -515,6 +515,21 @@ Step timing is recorded beside the range.
	515	515	/<repo>/runs/<id>/log?step=N # one step inside that attempt
	516	516	```
	517	517
		518	The same bytes are one command away from a terminal:
		519
		520	```sh
		521	vole run logs <id> # the default attempt, whole
		522	vole run logs <id> --attempt 2 --step 1 # step 1 of the second attempt
		523	vole run show <id> # status, steps, attempts, artifacts
		524	vole run list --state failed --limit 5 # find the run to open
		525	```
		526
		527	`vole run show` and `vole run list` read the queue; `vole run logs` writes the log to
		528	stdout and sends a refusal to stderr, so a redirect gets the log or an empty file.
		529	Reading is the repository's read capability. `vole change show` lists the runs for a
		530	change's head and for its combined result, which is where the id usually comes from
		531	when a check is red.
		532
	518	533	If a runner is killed, its attempt has no log. A record written before step
	519	534	timing existed still opens; it simply has no step ranges to show.
	520	535