Fix image publication policies and support Homelab RKE2 tools #111

Merged
gitchegumi merged 1 commit from kiyi/rke2-owned-tool-images into main 2026-10-16 16:32:52 -05:00
Member

Base-images run 264 passed its complete source and Docker image scans, then publication falsely reported “Mitigation expired.” The signed evidence retained only the checkout-root policy, losing the image-context approvals. Retain both exact reviewed policies in the existing mitigation asset, deduplicate identical entries, reject conflicts and report which decision is blocked. Approval scope, November 6 expiry, scan gates, receipt schema and evidence inventory stay intact.

The published controller/helper rebuilds also need the RKE2 implementation to accept their two exact Homelab repositories. Bind reviewed tool release/version/source metadata into controller inventories, preserve legacy Rancher receipt shapes, and select the correct helper/controller paths and digests during Zarf postflight and upgrade Job verification. Bootstrap resources, Plan target, identities, manual approvals and workflow/status names are unchanged.

Validation: 113 affected source-only container/base-image/evidence/security/RKE2 regression tests pass in WSL; the final added tamper assertion also passes in the 11-test container suite. Ruff F checks, git diff --check and the active native Gitleaks 8.30.1 hook pass. The actual Platform caller contract and all three source inventories validate with this library; bootstrap and Plan inventories/manifests are identical to merged Platform main. The broad local suite is limited by missing defusedxml and Windows-linked Git metadata in WSL; hosted full-library/integration checks remain required. No local container build or live operation ran.

Merge, publish one workflow release and promote it to stable-v1 before fresh owning runs. Then Docker can be rebuilt/published through base-images, and the separate Platform digest-adoption PR can pass its new hosted checks and build a signed controller bundle. These PRs do not deploy a controller or activate Plans.

Base-images [run 264](https://git.gitchegumi.com/Homelab/base-images/actions/runs/264/jobs/1/attempt/1) passed its complete source and Docker image scans, then publication falsely reported “Mitigation expired.” The signed evidence retained only the checkout-root policy, losing the image-context approvals. Retain both exact reviewed policies in the existing mitigation asset, deduplicate identical entries, reject conflicts and report which decision is blocked. Approval scope, November 6 expiry, scan gates, receipt schema and evidence inventory stay intact. The published controller/helper rebuilds also need the RKE2 implementation to accept their two exact Homelab repositories. Bind reviewed tool release/version/source metadata into controller inventories, preserve legacy Rancher receipt shapes, and select the correct helper/controller paths and digests during Zarf postflight and upgrade Job verification. Bootstrap resources, Plan target, identities, manual approvals and workflow/status names are unchanged. Validation: 113 affected source-only container/base-image/evidence/security/RKE2 regression tests pass in WSL; the final added tamper assertion also passes in the 11-test container suite. Ruff F checks, git diff --check and the active native Gitleaks 8.30.1 hook pass. The actual Platform caller contract and all three source inventories validate with this library; bootstrap and Plan inventories/manifests are identical to merged Platform main. The broad local suite is limited by missing defusedxml and Windows-linked Git metadata in WSL; hosted full-library/integration checks remain required. No local container build or live operation ran. Merge, publish one workflow release and promote it to stable-v1 before fresh owning runs. Then Docker can be rebuilt/published through base-images, and the separate Platform digest-adoption PR can pass its new hosted checks and build a signed controller bundle. These PRs do not deploy a controller or activate Plans.
Preserve image mitigation evidence and support owned RKE2 tools
All checks were successful
Workflow acceptance / acceptance (pull_request) Successful in 1m30s
Repository security / security-1 (pull_request) Successful in 4m18s
Library checks / tests (pull_request) Successful in 6m54s
c0a406141d
kiyi added this to the Homelab Roadmap project 2026-10-16 16:16:06 -05:00
portegumi approved these changes 2026-10-16 16:17:00 -05:00
portegumi left a comment

Independent source review of c0a406141d: publication combines and validates the checkout and selected-context mitigation policies before the source/image scans, retains their signed evidence inventory, and re-evaluates both decisions before registry publication; duplicate entries and conflicting/expired policies fail closed. The RKE2 contract restricts owned controller/kubectl repositories and binds each pin to a version/source declaration; the controller postflight and Plan Job checks select role-specific image paths and signed digests while legacy Rancher references remain supported. Reviewed the added positive/negative regression cases for policy loss/tamper, release metadata, registry rewrites, and wrong running digests. No changed deployment manifests, gateway/route ownership, admission policies, or scan gates in this PR; the existing UDS packaging and policy checks remain in the delivery path. Source approval only: Workflow acceptance, Repository security, and Library checks are pending at this SHA; their results, pinned UDS render/runtime behavior, and any real deployment remain separate acceptance gates. No merge or publication authorized.

CI at submission: pending. This is a source-review approval, not a scan verdict; required checks still block merge.

Independent source review of c0a406141d3deba421e6f43a9a573673cc3cdc00: publication combines and validates the checkout and selected-context mitigation policies before the source/image scans, retains their signed evidence inventory, and re-evaluates both decisions before registry publication; duplicate entries and conflicting/expired policies fail closed. The RKE2 contract restricts owned controller/kubectl repositories and binds each pin to a version/source declaration; the controller postflight and Plan Job checks select role-specific image paths and signed digests while legacy Rancher references remain supported. Reviewed the added positive/negative regression cases for policy loss/tamper, release metadata, registry rewrites, and wrong running digests. No changed deployment manifests, gateway/route ownership, admission policies, or scan gates in this PR; the existing UDS packaging and policy checks remain in the delivery path. Source approval only: Workflow acceptance, Repository security, and Library checks are pending at this SHA; their results, pinned UDS render/runtime behavior, and any real deployment remain separate acceptance gates. No merge or publication authorized. CI at submission: pending. This is a source-review approval, not a scan verdict; required checks still block merge.
gitchegumi deleted branch kiyi/rke2-owned-tool-images 2026-10-16 16:32:53 -05:00
Sign in to join this conversation.
No reviewers
No milestone
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
Homelab/workflows!111
No description provided.