Skip to content

Helm

Entrepot serves classic index.yaml chart repositories and a ChartMuseum-compatible API, so helm repo add, helm cm-push and plain curl all work. OCI charts (helm push oci://…) go to Docker repositories instead.

Kind Behaviour
hosted Stores charts at charts/<name>-<version>.tgz and generates index.yaml from them. Accepts PUT, the ChartMuseum API and provenance (.prov) files.
proxy Caches an upstream chart repository, rewriting the chart URLs in its index.yaml so downloads are cached too. Charts blocked by a routing rule are filtered out of the index.
group Merges the members’ indexes and prefers hosted charts (preferHosted).
Terminal window
api -X POST $E/api/v1/repositories -d '{"name":"helm-internal","format":"helm","kind":"hosted","blobStore":"default"}'
api -X POST $E/api/v1/repositories -d '{"name":"helm-bitnami","format":"helm","kind":"proxy","blobStore":"default","proxy":{"remoteUrl":"https://charts.bitnami.com/bitnami"}}'
api -X POST $E/api/v1/repositories -d '{"name":"helm","format":"helm","kind":"group","blobStore":"default","group":{"members":["helm-internal","helm-bitnami"]}}'
Terminal window
helm repo add internal https://entrepot.example.com/repository/helm/ \
--username token --password "$ENTREPOT_TOKEN"
helm repo update
helm search repo internal/
helm install my-release internal/mychart

Chart URLs in index.yaml are relative (charts/<name>-<version>.tgz), so Helm reuses the repository’s credentials for downloads.

Terminal window
helm package ./mychart
curl -f --data-binary @mychart-0.1.0.tgz \
-H "Authorization: Bearer $ENTREPOT_TOKEN" \
https://entrepot.example.com/repository/helm-internal/api/charts

The API also accepts multipart uploads with the fields chart and, optionally, prov.

Method and path (below /repository/<repo>/) Purpose
POST api/charts Upload a chart (raw body, or multipart chart + prov)
POST api/prov Upload a provenance file
GET api/charts All charts (JSON)
GET api/charts/<name> Versions of a chart
GET api/charts/<name>/<version> One version (latest allowed)
DELETE api/charts/<name>/<version> Delete a version

Uploading an existing version returns 409 unless hosted.allowRedeploy is enabled.

publish-chart:
image: alpine/helm:3
id_tokens:
ENTREPOT_ID_TOKEN:
aud: https://entrepot.example.com
script:
- helm package ./chart --version "$CI_COMMIT_TAG"
- 'curl -f --data-binary @$(ls *.tgz) -H "Authorization: Bearer $ENTREPOT_ID_TOKEN" https://entrepot.example.com/repository/helm-internal/api/charts'
rules:
- if: $CI_COMMIT_TAG
  • Error: looks like "…" is not a valid chart repository — the URL must end at the repository (…/repository/<name>/); Helm appends index.yaml.
  • 401 on helm repo add — pass --username/--password, or enable anonymousRead.
  • Charts from the proxy are missing — a routing rule may filter them out of the proxied index, or the index is still cached (proxy.metadataTtlSeconds).
  • helm cm-push posts to the wrong URL — pass --context-path /repository/<name> if your plugin version doesn’t use the multi-tenant layout.