Configuring the Helm Client
Download Helm client version 2.9.0 or above for authenticated access
To use all features of Artifactory Helm chart repositories, including resolution of Helm charts, you must use version 2.9.0 or above of the Helm client that supports basic authenticated access to Artifactory.
Before you can use your Helm client to resolve Helm charts from Artifactory, you need to configure it for authenticated access with your Artifactory user and password by adding the virtual Helm chart repository to be used for resolution as shown below:
Use an encrypted password
We recommend using an encrypted password instead of clear-text. For details, please refer to Centrally Secure Passwords.
Using the JFrog Helm Client
JFrog Helm Client
The JFrog Helm Client was necessary for authenticated access to Artifactory before the Helm client supported basic authentication (before version 2.9.0).
If you are using the JFrog Helm Client, you need to configure it for authenticated access with your Artifactory user and password by adding the virtual Helm chart repository to be used for resolution as shown below:
To enable calculation of Helm chart metadata, from the Administration module, select Repositories | Repositories | Local and set Helm to be the Package Type when you create your local repository.
Resolving Helm charts
Artifactory only supports resolution of Helm charts from virtual repositories.
You can create Helm remote repository to proxy and cache remote repositories or other Artifactory instances.
In order for Artifactory to properly cache Helm charts, resolve the charts only through a virtual repository.
A Virtual Repository defined in Artifactory aggregates packages from both local and remote repositories.
This allows you to access both locally hosted Helm charts and remote proxied Helm charts repositories from a single URL defined for the virtual repository.
To define a virtual Helm chart repository, create a virtual repository, set the Package Type to be Helm, and select the underlying local and remote Helm repositories to include in the Basic settings tab.
This repository will be configured in the Helm client.
Namespace Support for Helm Virtual Repositories
From Artifactory 7.24.1 (SaaS Version), you can explicitly state a specific aggregated local or remote repository to fetch from a virtual by assigning namespaces to local and remote repositories in Helm virtual repositories according to the following syntax.
By default, this feature is disabled but can be set when creating or updating a virtual Helm repository.
Setting Multiple External Dependencies Using List of URLs
To support downloading files from multiple internal Artifactory URLs, you can create a list of URLs that are trusted by the repository.
By default, this feature is disabled but can be set for each aggregated remote repository separately.
The following example shows how to add the following configuration as an external dependency.
As a result, all the external URLs located in the
index.yaml file starting with the following pattern.
Will be replaced with the following syntax,
Resolving Helm Charts
Virtual Repositories Only
Artifactory only supports resolution of Helm charts from virtual Helm chart repositories. To resolve Helm charts from other local or remote Helm chart repositories, you need to aggregate them in a virtual Helm chart repository.
To resolve a Helm chart through Artifactory, use the following command:
Deploying Helm Charts
Deploying Helm charts is done using cURL, Wget, JFrog CLI or any of the ways described in Deploying Artifacts.
Setting the Default Deployment Repository
To deploy Helm charts to a virtual Helm repository, make sure you have set the Default Deployment Repository.
Reindexing a Helm Chart repository
You can trigger an asynchronous reindexing of a local Helm chart repository either through the UI or using the REST API.
Through the UI, select your Helm chart repository in the Tree Browser and select Recalculate Index from the right-click menu, as shown below (requires Admin privileges).
To reindex a Helm chart repository through the REST API, please refer to Calculate Helm Chart Index.
Using the above REST API command or UI will reindex the
index.yaml from scratch. You may receive a partial
index.yaml if you attempt to resolve the package from the repository while the calculation is ongoing. Therefore, reindex should only be used if the
index.yaml is corrrupted.
Viewing Individual Helm Chart Information
In the Tree Browsing, select your virtual Helm chart repository and drill down to find and select the package you want to inspect. The metadata is displayed in the Chart Info tab.