Skip to content

fix(bridge): use Azure Linux distroless shipping runtimes - #569

Merged
Pal Lakatos-Toth (pallakatos) merged 3 commits into
kars-bridgefrom
fix/bridge-azurelinux-distroless
Sep 16, 2026
Merged

Pal Lakatos-Toth (pallakatos) merged 3 commits into
kars-bridgefrom
fix/bridge-azurelinux-distroless

Conversation

@pallakatos

@pallakatos Pal Lakatos-Toth (pallakatos) commented Sep 16, 2026

Copy link
Copy Markdown
Collaborator

Summary

Correct the imported Bridge shipping images to follow Kars core's Microsoft Azure Linux 3 distroless runtime policy. The previous BFF native lane used a separate distroless test image while the shipping BFF remained Debian, and source/config scanning did not qualify the final application images.

  • BFF now ships on core's Azure Linux distroless base; native acceptance builds the actual shipping Dockerfile.
  • Web and Teams retain Node 22, application locks and native sharp support. Only the official Node executable/license is copied from the Node build stage. Microsoft libstdc++ comes from its verified complete RPM-owned payload, with original package inventories preserved and extended.
  • Shipping images contain no shell, package manager or global npm tree. Actual final-image distribution, numeric UID/GID, CA trust, read-only startup, web sharp and both gateway listeners are checked.
  • Existing required component jobs scan the actual BFF/web/gateway images, failing on HIGH/CRITICAL findings including unfixed findings and retaining JSON evidence.
  • Document the actual Helm 4 fresh Namespace ownership conflict and create-only bootstrap; do not adopt existing namespaces.

Qualification

  • 16 Node packaging contracts and 8 image-contract/orchestration tests passed locally.
  • Existing source audit, LOC, copyright, crypto and no-stubs gates passed.
  • Workflow YAML and the documented namespace render/metadata flow checked offline.
  • Real digest-verified Microsoft base filesystem/CA checks passed. The Node implementation owner inspected native library/version closure; this is not runtime execution.
  • Two bounded independent AI review contexts reported no significant source issues. The new audit transparently cites the maintainer's existing delegated-review authority.

The first public head, a8d4585c842e5a7e584c3c9b0c8295ece777eba1, subsequently passed:

  • Actual BFF and web shipping-image builds, runtime contracts and HIGH/CRITICAL scans, including unfixed findings: zero findings. Web native sharp execution passed.
  • Native qualification: 18/18 runtime cases plus all three cold API/admission lanes; active-SRE combined qualification is not claimed.
  • Complete core CI, including E2E and benchmark regression.

The component workflow nevertheless failed its old packaging assertion requiring literal USER 10001. Current head 10943389e5b74b22b129b782838ca7377125d774 corrects that test to require the intended USER 10001:10001, explicit Microsoft distroless base and no runtime shell instructions, and records the outcome. All shipping/production bytes remain unchanged. The prior failed result remains failed; the gateway image steps were not reached.

Fresh current-head qualification, including actual execution of the corrected test and gateway image checks, remains required. This draft is not merge, release or deployment approval.

Preserved limits

No main changes, cluster mutations, controller-template changes, new credential authority, Node-major upgrade, dependency-lock changes or security-gate waivers. Earlier failed image scans remain failed. Optional witness image remediation and full qualified-root migration (#567) are separate; neither is claimed complete here.

Preserve Node 22 and Microsoft native-library inventory, qualify actual shipping images, and document the proven Helm 4 namespace bootstrap.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: eb3654cd-f1e0-445a-8734-430800af1903
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: eb3654cd-f1e0-445a-8734-430800af1903
@github-actions

Copy link
Copy Markdown

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

Retain the failed legacy fixture result and the actual clean BFF/web image scans. Shipping image contents are unchanged.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: eb3654cd-f1e0-445a-8734-430800af1903
@pallakatos
Pal Lakatos-Toth (pallakatos) marked this pull request as ready for review September 16, 2026 13:31
@pallakatos
Pal Lakatos-Toth (pallakatos) merged commit b413f34 into kars-bridge Sep 16, 2026
53 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant