From 7e0b17f18715c51392728fcbf594a739070bdedb Mon Sep 17 00:00:00 2001 From: Ciaran Roche Date: Fri, 14 Aug 2026 13:37:47 +0100 Subject: [PATCH] HYPERFLEET-1218 - docs: update helm-git references to reflect OCI migration Update documentation to reflect completed OCI migration: - glossary.md: Mark helm-git as deprecated/replaced by OCI, note it remains in use for the dev-only Maestro umbrella chart until Maestro is decommissioned - helm-oci-distribution-design.md: Update tense (current -> previous state) HyperFleet charts now distributed exclusively via OCI (HYPERFLEET-831). helm-git plugin no longer required for HyperFleet chart consumption. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01RKPYoiHdwCDTcwJptity8B --- hyperfleet/docs/release/glossary.md | 2 +- .../docs/release/helm-oci-distribution-design.md | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/hyperfleet/docs/release/glossary.md b/hyperfleet/docs/release/glossary.md index e25685b6..0b159af3 100644 --- a/hyperfleet/docs/release/glossary.md +++ b/hyperfleet/docs/release/glossary.md @@ -62,7 +62,7 @@ Key terms used across the release docs. Written for someone encountering these s | **kflux-prd-rh02** | Konflux production cluster hosted by Red Hat. Runs the PaC controller, Tekton Chains, and release pipelines for HyperFleet. | | **Quay** | Red Hat's container registry. HyperFleet images are published to `quay.io/redhat-services-prod/hyperfleet-tenant/hyperfleet/`. | | **OCI** (Open Container Initiative) | Standard for container and artifact distribution. Helm charts are published as OCI artifacts to the same registries as container images. | -| **helm-git** | Helm plugin that pulls charts from Git repos. Legacy distribution method being replaced by OCI. Requires plugin installation on every consumer. | +| **helm-git** | Deprecated Helm plugin for pulling charts from Git repos. Replaced by OCI distribution (HYPERFLEET-831). No longer required for HyperFleet chart consumption. Still used by the dev-only Maestro umbrella chart in hyperfleet-infra until Maestro is decommissioned. | | **Pyxis** | Red Hat's container metadata catalog. Images registered here are automatically scanned for CVEs. | | **ArgoCD** | GitOps-based deployment tool. Partner teams use ArgoCD to consume HyperFleet images from Quay. | | **konflux-release-data** | GitLab repo containing RPA, constraint, and tenant configuration for Konflux releases. Source of truth for release pipeline config. | diff --git a/hyperfleet/docs/release/helm-oci-distribution-design.md b/hyperfleet/docs/release/helm-oci-distribution-design.md index 01863013..081a3486 100644 --- a/hyperfleet/docs/release/helm-oci-distribution-design.md +++ b/hyperfleet/docs/release/helm-oci-distribution-design.md @@ -17,7 +17,7 @@ Last Updated: 2026-05-11 ## 1. Overview -HyperFleet publishes Helm charts as OCI artifacts to Quay.io via the Konflux release pipeline, replacing the current `helm-git` plugin-based distribution. Charts are built, signed, and released through the same Konflux infrastructure used for container images. +HyperFleet publishes Helm charts as OCI artifacts to Quay.io via the Konflux release pipeline. This has replaced the former `helm-git` plugin-based distribution. Charts are built, signed, and released through the same Konflux infrastructure used for container images. **Key decisions:** @@ -32,17 +32,17 @@ HyperFleet publishes Helm charts as OCI artifacts to Quay.io via the Konflux rel ## 2. Background -### Current State (helm-git) +### Previous State (helm-git) -HyperFleet Helm charts are consumed via the `helm-git` plugin, pulling directly from Git repositories: +Prior to HYPERFLEET-831, HyperFleet Helm charts were consumed via the `helm-git` plugin, pulling directly from Git repositories: ```text git+https://github.com/openshift-hyperfleet/hyperfleet-api@charts?ref=main ``` -This requires every consumer to install the `helm-git` plugin. Git references are mutable, there is no content-addressable storage, no signing, and no provenance. +This required every consumer to install the `helm-git` plugin. Git references were mutable, with no content-addressable storage, no signing, and no provenance. -### Target State (OCI on Quay.io) +### Current State (OCI on Quay.io) ```text oci://quay.io/redhat-services-prod/hyperfleet-tenant/hyperfleet-api-chart:1.5.0