ankra helm addon-catalog in the CLI. Behind that one list are three kinds of source.
The three sources
Ankra’s catalogue lives in the public ankraio/ankra-global-resources repository, and anyone can propose a registry or an add-on for it by pull request (Publishing add-ons). The registries you add belong to your organisation, or to one of its projects when pinned to it, and no other organisation sees them.
The two kinds you add live on two pages because Ankra does more with an OCI registry. Connecting one checks its login and lists its projects, and for Harbor and Google Artifact Registry it can make the robot accounts your clusters pull with. An HTTP repository is only read. Once connected, both kinds appear side by side under Helm registries, where Ankra reads them on a schedule and you sync or remove them.
Which to use
- A public chart that Ankra’s catalogue already has (cert-manager, Grafana and the like): use it as it is. There is nothing to add.
- A public chart from a project’s own Helm repository: add that repository as an HTTP chart repository, with no credential.
- A public chart published as an OCI artifact (Envoy Gateway on Docker Hub, for example): connect the registry as an OCI registry, with no credential.
- Your own charts: push them to a registry you control, usually the OCI registry that already holds your images, and connect it with a read-only login. Host your own Helm charts walks through GHCR.
- A registry that holds many charts you never install: list the ones to skip in Charts to leave out when you add it (
--exclude-chartson the CLI), so Ankra does not index them.
How a Stack refers to a chart
When you add a chart to a Stack, the add-on stores the chart’s name, its pinned version and the registry it came from. A Stack never holds the registry’s login. When the cluster deploys, it is given the login: the agent signs in with it on the native engine, and on an Argo CD cluster the login is kept as a repository Secret in Argo CD’s namespace, and Argo CD pulls the chart with it. In a GitOps repository the same add-on reads:Credentials
A private registry signs in with a registry credential: a username and a password or token. You store it once, under Registry credentials on Helm registries, under Integrations & alerts → Credentials as a Helm registry, or withankra helm credentials create, and pick it when you add the registry. The portal says Ankra keeps the login encrypted and never shows it again. Give it the least access that works: a token that can read charts, not one that can push.
Where to go next
- Connect a Helm registry - add an HTTP repository or an OCI registry, step by step.
- Charts and the add-on catalogue - browse charts, read their values and licence, curate add-ons.
- Create and change a stack - add a chart to a Stack and deploy it.
- Helm registry CLI reference - every
ankra helmcommand.