bstein/lesavka
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

ci(lesavka): document headless gate toggle

Browse Source
This commit is contained in:
Brad Stein 2026-05-19 21:16:53 -03:00
parent 7f7e613ffc
commit 5a222a717c
2 changed files with 2 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
docs/operational-env.md
View File

@ -87,6 +87,7 @@ from `LESAVKA_CLIENT_PKI_SSH_SOURCE` over SSH. Runtime clients require the insta
| `PROBE_EVENT_WIDTH_CODES` | manual client-to-RCT transport probe identity sequence; defaults to unique codes `1..16` so final RCT observations can be joined to client-origin timeline events after startup drops | | `PROBE_EVENT_WIDTH_CODES` | manual client-to-RCT transport probe identity sequence; defaults to unique codes `1..16` so final RCT observations can be joined to client-origin timeline events after startup drops |
| `LESAVKA_CLIENT_RELAYCTL_BIN_SRC` | test/build contract variable; not runtime operator config | | `LESAVKA_CLIENT_RELAYCTL_BIN_SRC` | test/build contract variable; not runtime operator config |
| `LESAVKA_CLIENT_VIDEO_SUPPORT_SRC` | test/build contract variable; not runtime operator config | | `LESAVKA_CLIENT_VIDEO_SUPPORT_SRC` | test/build contract variable; not runtime operator config |
| `LESAVKA_CI_HEADLESS_GTK` | CI toggle for wrapping GUI-adjacent gates in a virtual display on headless agents; set to `0` only when a real display is already available |
| `LESAVKA_CI_PROFILE` | Jenkins/CI profile selector; `safe` runs non-disruptive gates, `daily` wraps primary-branch daily gates, and `lab` is reserved for isolated bare-metal probes | | `LESAVKA_CI_PROFILE` | Jenkins/CI profile selector; `safe` runs non-disruptive gates, `daily` wraps primary-branch daily gates, and `lab` is reserved for isolated bare-metal probes |
| `LESAVKA_COVERAGE_ENFORCE` | CI quality-gate toggle; when enabled, below-target coverage fails the Jenkins run instead of publishing observe-mode coverage telemetry | | `LESAVKA_COVERAGE_ENFORCE` | CI quality-gate toggle; when enabled, below-target coverage fails the Jenkins run instead of publishing observe-mode coverage telemetry |
| `LESAVKA_CLIPBOARD_CHORD` | input routing/clipboard override | | `LESAVKA_CLIPBOARD_CHORD` | input routing/clipboard override |

1
scripts/ci/headless_run.sh
View File

@ -1,5 +1,6 @@
#!/usr/bin/env bash #!/usr/bin/env bash
# Run GUI-adjacent CI commands safely on headless Jenkins agents. # Run GUI-adjacent CI commands safely on headless Jenkins agents.
set -euo pipefail
lesavka_ci_run_headless() { lesavka_ci_run_headless() {
local cmd=("$@") local cmd=("$@")