Registries
Adding your own registry to Ankra enables you and your team to distribbute helm-charts as add-on components that can be deployed onto a cluster as part of a stack.
🔗 How to add a registry to Ankra
The contents of the registry you add is available to your account only by default.
- Go to the Add-ons section in your Ankra Platform
- Click “Manage Sources”
- Add your registry URL, for example:
- GHCR:
oci://ghcr.io/YOUR_USERNAME/helm-charts
- Harbor:
https://your-harbor.example.com/chartrepo/your-project
- Google Artifact Registry:
oci://LOCATION-docker.pkg.dev/PROJECT_ID/REPOSITORY/helm-charts
- Other OCI registries:
oci://registry.example.com/helm-charts
- GHCR:
Once added: All Helm charts in your registry are available as add-ons in the UI or CLI, ready to be configured, deployed and managed on your clusters.
🏗️ Create Your Own Registry with GHCR
Use any OCI Helm registry (GHCR, Harbor, JFrog Artifactory, AWS ECR, Google Artifact Registry, etc.) with Ankra. This guide focuses on GitHub Container Registry (GHCR) as a free and accessible example.
GitHub Container Registry (GHCR) provides a free and reliable way to host your own Helm charts.
Prerequisites
Before you begin, ensure you have:
- A GitHub account
- Git installed on your machine
- Helm CLI installed (Installation guide)
- A GitHub Personal Access Token with
write:packages
permission
To create a Personal Access Token: Go to GitHub Settings > Developer settings > Personal access tokens > Generate new token, and select the write:packages
scope.
Step 1: Set Up Your Repository
Create a new GitHub repository to host your Helm charts:
- Go to GitHub and create a new repository (e.g.,
my-helm-charts
) - Clone the repository locally:
Step 2: Create Your Helm Chart
Generate a new Helm chart or prepare an existing one:
This creates a basic chart structure:
Step 3: Configure Your Chart
Step 4: Package Your Chart
Package your Helm chart into a .tgz
file:
This creates a file like my-sparkly-app-1.0.0.tgz
.
Step 5: Login to GHCR
Authenticate with GitHub Container Registry using your Personal Access Token:
Replace $GITHUB_TOKEN
with your actual token and YOUR_USERNAME
with your GitHub username.
Step 6: Push Your Chart
Push your packaged chart to GHCR:
Step 7: Verify Your Registry
After pushing, your chart will be available at:
You can verify the upload by checking your GitHub repository’s “Packages” tab.
Step 8: Add Your Registry to Ankra
Now that your chart is published, add your GHCR registry to Ankra:
- Go to the Add-ons section in your Ankra Platform
- Click “Manage Sources”
- Add your GHCR registry URL:
oci://ghcr.io/YOUR_USERNAME/helm-charts
- Provide authentication if needed (your GitHub username and Personal Access Token)
Once added, your my-sparkly-app
chart will automatically appear as an available add-on in your organization’s Ankra Platform, ready to be installed on any of your clusters.
With your own registry, custom Helm charts can be distributed to your team and integrated with Ankra’s add-on management workflow engine.