Skip to content

artifacthub: Move to folder based releases#568

Merged
illume merged 1 commit intoheadlamp-k8s:mainfrom
illume:arti-folders
Apr 2, 2026
Merged

artifacthub: Move to folder based releases#568
illume merged 1 commit intoheadlamp-k8s:mainfrom
illume:arti-folders

Conversation

@illume
Copy link
Copy Markdown
Contributor

@illume illume commented Mar 20, 2026

  • Converted 11 plugins (ai-assistant, cert-manager, example-change-logo, flux, keda, knative, kompose, minikube, opencost, radius) from flat structure to versioned folders
  • Created version folders for all historical releases by extracting artifacthub-pkg.yml and README.md from each release tag in git history
  • Added changes field to each artifacthub-pkg.yml parsed from GitHub release notes
  • Removed kubeflow artifacthub files because it causes an error

Just overwriting the file removes the old releases. The "proper" way is to do a folder for each release. It's documented here: https://artifacthub.io/docs/topics/repositories/headlamp-plugins/

Like how the karpenter plugin does it:
https://github.com/headlamp-k8s/plugins/tree/main/karpenter

Notice how there are versions on the Karpenter one?

https://artifacthub.io/packages/headlamp/headlamp-plugins/headlamp_karpenter

image

But not the flux plugin on artifacthub?

image

Without doing folder the previous release goes away for people.

The layout example from the artifacthub docs https://artifacthub.io/docs/topics/repositories/headlamp-plugins/

$ tree path/to/packages
path/to/packages
├── artifacthub-repo.yml
├── package1
│   ├── 1.0.0
│   │   ├── README.md
│   │   └── artifacthub-pkg.yml
│   └── 2.0.0
│       ├── README.md
│       └── artifacthub-pkg.yml
└── package2
    └── 1.0.0
        ├── README.md
        └── artifacthub-pkg.yml

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR restructures ArtifactHub package metadata for multiple Headlamp plugins to use folder/version-based release manifests, adding per-version artifacthub-pkg.yml files (with changes entries) and per-version README.md files, and removing the legacy top-level Flux ArtifactHub manifest.

Changes:

  • Add/extend changes: entries in multiple per-version artifacthub-pkg.yml manifests.
  • Add per-version README.md files across plugins to support folder-based ArtifactHub releases.
  • Remove the legacy flux/artifacthub-pkg.yml in favor of versioned manifests under flux/<version>/.

Reviewed changes

Copilot reviewed 49 out of 51 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
radius/0.1.1/artifacthub-pkg.yml Add ArtifactHub changelog entry for Radius 0.1.1.
radius/0.1.1/README.md Add versioned Radius README for ArtifactHub.
opencost/0.1.3/artifacthub-pkg.yml Add ArtifactHub changelog entry for OpenCost 0.1.3.
opencost/0.1.3/README.md Add versioned OpenCost README.
opencost/0.1.2/artifacthub-pkg.yml Add OpenCost 0.1.2 ArtifactHub manifest.
opencost/0.1.2/README.md Add versioned OpenCost README.
opencost/0.1.1/artifacthub-pkg.yml Add OpenCost 0.1.1 ArtifactHub manifest.
opencost/0.1.1/README.md Add versioned OpenCost README (template content).
opencost/0.1.0/artifacthub-pkg.yml Add OpenCost 0.1.0 ArtifactHub manifest.
opencost/0.1.0/README.md Add versioned OpenCost README (template content).
minikube/0.2.0/artifacthub-pkg.yml Add changelog entries for minikube 0.2.0.
minikube/0.2.0/README.md Add versioned minikube README.
minikube/0.1.0/artifacthub-pkg.yml Add minikube 0.1.0 ArtifactHub manifest.
minikube/0.1.0/README.md Add versioned minikube README.
minikube/0.1.0-alpha-1/artifacthub-pkg.yml Add minikube 0.1.0-alpha-1 ArtifactHub manifest.
minikube/0.1.0-alpha-1/README.md Add versioned minikube README (alpha).
kubeflow/0.1.0/artifacthub-pkg.yml Add Kubeflow 0.1.0 ArtifactHub manifest.
kubeflow/0.1.0/README.md Add versioned Kubeflow README.
kompose/0.1.1-beta/artifacthub-pkg.yml Add Kompose 0.1.1-beta ArtifactHub manifest + changelog list.
kompose/0.1.1-beta/README.md Add versioned Kompose README.
kompose/0.1.0-beta/artifacthub-pkg.yml Normalize Kompose version metadata and add changelog entries.
kompose/0.1.0-beta/README.md Add versioned Kompose README.
knative/0.1.0-alpha/artifacthub-pkg.yml Add Knative 0.1.0-alpha ArtifactHub manifest.
knative/0.1.0-alpha/README.md Add versioned Knative README.
keda/0.1.1-beta/artifacthub-pkg.yml Add changelog entry for KEDA 0.1.1-beta.
keda/0.1.1-beta/README.md Add versioned KEDA README (testing guide).
keda/0.1.0-beta/artifacthub-pkg.yml Add KEDA 0.1.0-beta ArtifactHub manifest.
keda/0.1.0-beta/README.md Add versioned KEDA README (testing guide).
karpenter/0.2.0/artifacthub-pkg.yml Add detailed changelog entries for Karpenter 0.2.0.
karpenter/0.1.0/artifacthub-pkg.yml Add detailed changelog entries for Karpenter 0.1.0.
flux/artifacthub-pkg.yml Remove legacy top-level Flux ArtifactHub manifest.
flux/0.6.0/artifacthub-pkg.yml Add Flux 0.6.0 ArtifactHub manifest + changelog entries.
flux/0.6.0/README.md Add versioned Flux README.
flux/0.5.0/artifacthub-pkg.yml Add Flux 0.5.0 ArtifactHub manifest + changelog entries.
flux/0.5.0/README.md Add versioned Flux README.
flux/0.4.0/artifacthub-pkg.yml Add Flux 0.4.0 ArtifactHub manifest + changelog entries.
flux/0.4.0/README.md Add versioned Flux README.
flux/0.3.0/artifacthub-pkg.yml Add Flux 0.3.0 ArtifactHub manifest + changelog entries.
flux/0.3.0/README.md Add versioned Flux README.
flux/0.2.0/artifacthub-pkg.yml Add Flux 0.2.0 ArtifactHub manifest.
flux/0.2.0/README.md Add versioned Flux README.
flux/0.1.0-beta-2/artifacthub-pkg.yml Add Flux 0.1.0-beta-2 ArtifactHub manifest.
flux/0.1.0-beta-2/README.md Add versioned Flux README.
flux/0.1.0-beta-1/artifacthub-pkg.yml Add Flux 0.1.0-beta-1 ArtifactHub manifest.
flux/0.1.0-beta-1/README.md Add versioned Flux README.
example-change-logo/0.0.1/artifacthub-pkg.yml Normalize version metadata and add changelog entry.
example-change-logo/0.0.1/README.md Add versioned example plugin README.
cert-manager/0.1.0/artifacthub-pkg.yml Add changelog entry for cert-manager 0.1.0.
cert-manager/0.1.0/README.md Add versioned cert-manager README.
ai-assistant/0.1.0-alpha/artifacthub-pkg.yml Add changelog entries for AI Assistant 0.1.0-alpha.
ai-assistant/0.1.0-alpha/README.md Add versioned AI Assistant README.
Comments suppressed due to low confidence (1)

radius/0.1.1/artifacthub-pkg.yml:11

  • There’s an extra space before the final period after the Radius link (...radapp.io/) .), which will render oddly in ArtifactHub’s changelog. Remove the stray space so the sentence reads cleanly.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread minikube/0.1.0-alpha-1/README.md
Comment thread flux/0.6.0/artifacthub-pkg.yml
Comment thread minikube/0.1.0/README.md
Comment thread minikube/0.1.0-alpha-1/README.md
Comment thread minikube/0.2.0/README.md
Comment thread minikube/0.1.0/README.md
@illume illume added the bug Something isn't working label Mar 20, 2026
@illume
Copy link
Copy Markdown
Contributor Author

illume commented Apr 2, 2026

Fixed the git conflicts and rebased against main.

@illume illume force-pushed the arti-folders branch 2 times, most recently from 1777d6e to a69e2a5 Compare April 2, 2026 08:41
Also remove Kubeflow files, since it was not released.

Signed-off-by: René Dudfield <renedudfield@microsoft.com>
Copy link
Copy Markdown
Member

@ashu8912 ashu8912 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!!

@illume illume merged commit a4daedd into headlamp-k8s:main Apr 2, 2026
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants