The Python package replaces task Bash logic for source preparation, wheel builds, and sdist normalization. Git, Fromager, auditwheel, ORAS, and cosign remain external tools. Build-index generation belongs to fath-cuan; clone, acquisition, and ClamAV tasks retain their existing owners.
Tekton owns transport through separate quay.io/konflux-ci/build-trusted-artifacts
steps. Python accepts filesystem paths, copies restored inputs into scratch space,
and stages outputs for create. It never handles trusted-artifact URIs.
| Task | Restored input | Python output | create result |
|---|---|---|---|
source-to-sdist |
SOURCE_ARTIFACT → /var/workdir/source-repo-readonly (--source-dir) |
/var/workdir/sdists-repo (--sdists-output) |
SDISTS_ARTIFACT |
python-fromager-build-wheels |
SDISTS_ARTIFACT → /var/workdir/sdists-repo (--sdists-dir) |
/var/workdir/build-manifest.json (--manifest-output) |
MANIFEST_ARTIFACT |
fromager-build-sdist |
SDISTS_ARTIFACT → /var/workdir/sdists-repo (--sdists-dir) |
Final sdist OCI image and evidence | None |
The source handoff contains sdists, a build-config snapshot and commit, and backend settings as JSON. Source and wheel tasks must migrate together: old shell-based handoffs are incompatible. The wheel manifest records produced/cached packages for fath-cuan; produced entries take precedence over identical cached entries.
Use fresh handoff and result paths for every run. Python writes success results
only after required processing and publication, including wheel SBOM attachment.
Run create only after Python succeeds. A failed attachment may leave an uploaded
image, but no successful manifest handoff. Result names remain unchanged; Python
result files have no trailing newline. Trusted-artifact URIs identify blob digests,
while IMAGE_DIGEST identifies the published OCI manifest.
| Build type | Version | Dependency policy |
|---|---|---|
| Backport | upstream+rhlw.B; B counts ingestion→HEAD |
Source-build allowlist and optional wheel cache |
| Novel | upstream+rhlw.B.n.N; B counts ingestion→baseline, N counts baseline→HEAD |
Same as Backport |
| Validated | Upstream version | Full dependency closure and optional wheel cache |
| Scratch | upstream+rhlw.0; fixed, no Git lineage queried |
Same as Backport |
The ingestion tag is <package>/<version> and the baseline tag is
baseline/<version>. Omit .n.N when N=0; validate ancestry before counting.
LIGHTWELL_BUILDS_TAG is retained for compatibility; Git history drives versioning.
- Config schema, version coverage, environment, rewrites, and allowed artifacts come from one selected snapshot.
- Sdist cache aliases cover canonical, underscore, and original-case package names with upstream and computed versions. Fromager runs bootstrap and build-sequence.
- Native x86_64 wheels undergo auditwheel repair; SPDX SBOMs gain system dependencies and wheel filenames. The published artifact includes the dependency closure.
- With
AI_ASSISTED=true, the attached SBOM copy gets one document-level SPDX 2.3 annotation that listsAI_MODELS. Embedded wheel SBOMs are never modified. - Sdist normalization preserves acquired origin evidence and records input/output
hashes in
sdist-transformation.json.
-
Build-config validation accepts optional package rename
aliases, matching calunga-python: a list of unique, nonempty strings, including an empty list. Aliases are metadata and do not change the builder's primary package identity. -
Validated builds accept an optional prebuilt wheel server. Cached or skipped dependencies are recorded as cached in the wheel manifest; source builds retain the upstream version and the full dependency-closure policy.
-
Fromager bootstrap, wheel builds, and repair use a fixed
SOURCE_DATE_EPOCHof315532800(1980-01-01 UTC), preserving reproducibility with ZIP-compatible dates. -
JSON replaces executable config handoffs; config repository scripts are not run.
-
Archives preserve executable bits and safe symlinks with normalized timestamps and ownership. Their bytes may differ from the original Bash implementation.
-
Metadata rewrites validate paths and matches before writing. Default TOML/INI edits target project/metadata sections only.
-
Default Python-source version scans use
surrogateescapeand retain universal-newline text handling. Non-UTF-8 PEP 263 sources can be scanned and rewritten without rejecting the build, while changed Python files keep the original newline-normalization behavior. Explicit rewrite rules continue to require strict UTF-8. -
Scratch is a reversioning-check build mode with no orchestrator equivalent: it skips all Git lineage queries and stamps a fixed
upstream+rhlw.0, so a build-config can be exercised without ingestion/baseline tags. Whether the rewrite actually landed is confirmed by the usual primary-wheel version check, not by this task. Scratch wheels are annotated with the dedicateddev.lightwell.distribution-targetvaluescratch; scratch builds skip release so the target is never gated, but a dedicated value keeps a scratch-only wheel from being mistaken for a shippable artifact. -
Missing/invalid build summaries, ambiguous sdists, and mismatched primary wheel filename, METADATA, or SPDX versions fail the task. A primary SBOM is required.
-
Wheel RECORD is regenerated as CSV with hashes. Only the root
.dist-infois rewritten; vendored metadata remains intact. Duplicate members and signatures on the outer wheel are rejected. -
AI_ASSISTEDaccepts onlytrueorfalse(case-insensitive, surrounding spaces ignored; empty means false). Other values fail the wheel task instead of being treated as false. WithAI_ASSISTED=true,AI_MODELSmust be empty or comma-separated IDs using only letters, digits, and. _ : / @ + -; other values fail the task before the build starts, so they cannot add fields to the annotation. -
Image digests come from the manifest ORAS exports at push time. Registry retries are bounded; build commands are not retried. Credentials remain in private temporary files and never enter command arguments or logs.
-
python-fromager-build-wheelsemits aPYTHON_BUILDER_IMAGE_REFERENCEresult echoing the digest-pinned execution image (--python-builder-image). The release policy derives its set of trusted build-input digests from the build task's results, so surfacing the builder image this way lets it recognize the builder as a trusted parameter without loosening the policy.
| Repository | Revision |
|---|---|
| lightwell-konflux-orchestrator | 5a3e8361001e12a925e2a27e7846699ea4fc9c7e |
| plumbing | 3a5d00d81e01b8ab6f758343cf9f56041dcfc16b |
| calunga-python | b94994abee416da9b462a48dc26652097ec3eec7 |
See task configuration and image builds.