Skip to content

HYPERFLEET-1218 - docs: update helm-git references to reflect OCI migration #201

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ciaranRoche merged 1 commit into from
Aug 18, 2026
+6 −6
Merged

HYPERFLEET-1218 - docs: update helm-git references to reflect OCI migration #201

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion hyperfleet/docs/release/glossary.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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. |
10 changes: 5 additions & 5 deletions hyperfleet/docs/release/helm-oci-distribution-design.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:**

Expand All @@ -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)
Comment thread
coderabbitai[bot] marked this conversation as resolved.

```text
oci://quay.io/redhat-services-prod/hyperfleet-tenant/hyperfleet-api-chart:1.5.0
Expand Down