1 Commits
Author SHA1 Message Date
bquarkz 22769aa438 docs: close runtime quality review with consolidated lesson
Intrepid/Prometeu/Runtime/pipeline/pr-master There was a failure building this commit
2026-10-14 14:09:12 +01:00
3 changed files with 9 additions and 39 deletions
+7 -13
View File
@@ -155,17 +155,11 @@ steps inside one gate cannot protect against an independent process.
### Prerequisites and reports
Jenkins uses `bash scripts/check-quality-gate-prerequisites.sh` to validate an
already provisioned agent. The job does not install system packages, Rust
components or Cargo tools and does not require root or sudo. The agent image
must supply a supported Rust toolchain and rustup in CARGO_HOME/bin, rustfmt,
Clippy, llvm-tools-preview and pinned cargo-llvm-cov 0.8.5.
Provision the Jenkins agent before running jobs. The standalone
`bash scripts/provision-quality-gate.sh` helper requires root or sudo on
Debian/Ubuntu and an existing Rust/rustup installation; run it during agent
setup, with Rust tools installed for the job user. GitHub's disposable hosted
runner still uses this helper after installing stable Rust.
Both pipelines use `bash scripts/provision-quality-gate.sh`. A Debian/Ubuntu
agent needs root or sudo for apt provisioning, and an existing Rust/rustup
installation. GitHub installs stable Rust first; Jenkins must supply a supported
Rust toolchain and rustup in CARGO_HOME/bin. The script installs rustfmt, Clippy,
llvm-tools-preview and pinned cargo-llvm-cov 0.8.5 (`--locked`).
Linux packages include build-essential, pkg-config, libasound2-dev, libudev-dev,
libxkbcommon-dev, libwayland-dev, libx11-dev, libxrandr-dev, libxi-dev, Python 3,
@@ -182,10 +176,10 @@ status; the log preserves underlying Cargo diagnostics. Three regression cases
check failure logs/identity, fresh success evidence and partial-report retention
when a later gate fails.
Both pipelines discard old generated report directories before environment checks or setup and
Both pipelines discard old generated report directories before provisioning and
publish current artifacts even after gate failure. An early failed gate has
metadata/logs but no old coverage report. Failure after generation preserves the
partial current reports. Prerequisite or setup failure can leave no report at all and
partial current reports. Provisioning failure can leave no report at all and
still fails CI. Reports are archived from `target/quality-gate/**` and
`target/llvm-cov/**`; Jenkins also publishes current HTML when present. Artifact
publication does not turn a failed gate into success.
+2 -2
View File
@@ -14,12 +14,12 @@ pipeline {
dir('target/llvm-cov') { deleteDir() }
}
}
stage('Check prerequisites') {
stage('Provision') {
steps {
sh '''
set -eu
export PATH="$CARGO_HOME/bin:$PATH"
bash scripts/check-quality-gate-prerequisites.sh
bash scripts/provision-quality-gate.sh
'''
}
}
@@ -1,24 +0,0 @@
#!/usr/bin/env bash
# Validate an already provisioned agent; never install dependencies in Jenkins.
set -euo pipefail
fail() {
echo "Quality-gate prerequisite missing: $*. Provision the agent image before running this job." >&2
exit 1
}
for command in rustup cargo rustc python3 jq rg git make pkg-config; do
command -v "$command" >/dev/null || fail "$command"
done
components=$(rustup component list --installed)
for component in rustfmt clippy llvm-tools-preview; do
if ! grep -Eq "^${component}(-|$)" <<< "$components"; then
fail "Rust component $component"
fi
done
[[ "$(cargo llvm-cov --version 2>/dev/null || true)" == 'cargo-llvm-cov 0.8.5' ]] || fail 'cargo-llvm-cov 0.8.5'
if [[ "$(uname -s)" == Linux ]]; then
pkg-config --exists alsa || fail 'ALSA development files (libasound2-dev)'
fi