This project is no longer supported

It's been a long time since I don't have time to work on this project and I don't even work with artifactory anymore.

Feel free to fork the repository and continue with the development :)

Helm push artifactory plugin

A Helm plugin to push helm charts to artifactory: * A version for artifactory of helm-push: https://github.com/chartmuseum/helm-push * Using a couple of things from Jfrog-cli-go: https://github.com/jfrog/jfrog-cli-go * And a bit of makefile magic from: https://github.com/helm/helm

Install

IMPORTANT: by default helm plugin install will install the version from the master branch, and that version is for Helm v2, if you are using Helm v3 please add --version 1.0.1 (or the version you want to use) to your helm plugin install command. Also please always use the flag --version in your CI/CD system to avoid surprises when new changes are merged to master!

Based on the version in plugin.yaml, release binary will be downloaded from GitHub:

$ helm plugin install https://github.com/belitre/helm-push-artifactory-plugin
Downloading and installing helm-push-artifactory v0.4.2 ...
https://github.com/belitre/helm-push-artifactory-plugin/releases/download/v0.4.2/helm-push-artifactoryv0.4.2darwin_amd64.tar.gz
Installed plugin: push-artifactory

You can specify an specific version:

$ helm plugin install https://github.com/belitre/helm-push-artifactory-plugin --version v0.3.0 Downloading and installing helm-push-artifactory v0.3.0 ... https://github.com/belitre/helm-push-artifactory-plugin/releases/download/v0.3.0/helm-push-artifactoryv0.3.0darwin_amd64.tar.gz Installed plugin: push-artifactory

You can also download on one of the compressed files from here and just extract it in your $HELMHOME/plugins/

Important for windows users: I really don't know how to make the helm plugin install command work on Windows :D so please just download the zip and extract it on your $HELM_HOME/plugins/ folder :)


Uninstall
<pre><code class="lang-">helm plugin remove push-artifactory Removed plugin: push-artifactory</code></pre>
Local and virtual repositories
Artifactory has two types of repositories: local and virtual. Local repositories are the ones where you push the charts, but to get a chart you'll need to use a virtual repository!
This plugin works with local repositories, you can add them through the Helm CLI like a virtual repository and use it later instead of the URL. But remember: you won't be able to get charts from a local repository
Example:
We can add our local repository with helm CLI:

    <pre><code class="lang-bash">$ helm repo add --username myuser --password mypass my-local-repo https://artifactoryhost/my-local-repo
    &quot;my-local-repo&quot; has been added to your repositories</code></pre>
We can use this repository later to push charts:

    <pre><code class="lang-bash">$ helm push-artifactory mychart-0.3.2.tgz my-local-repo 
    Pushing mychart-0.3.2.tgz to https://artifactoryhost/my-local-repo/mychart/mychart-0.3.2.tgz...
    Done.
    Reindex helm repository my-local-repo...
    Reindex of helm repo my-local-repo was scheduled to run.</code></pre>
We can't get the helm chart from a local repo:

    <pre><code class="lang-bash">$ helm fetch my-local-repo/mychart
    Error: Get local://mychart/mychart-0.3.2.tgz: unsupported protocol scheme &quot;local&quot;</code></pre>
We can add the virtual repo and get the chart:

    <pre><code class="lang-bash">$ helm repo add --username myuser --password mypass my-virtual-repo https://artifactoryhost/my-virtual-repo
    &quot;my-virtual-repo&quot; has been added to your repositories
    $ helm repo update
    Hang tight while we grab the latest from your chart repositories...
    ...Skip local chart repository
    ...Successfully got an update from the &quot;my-local-repo&quot; chart repository
    ...Successfully got an update from the &quot;my-virtual-repo&quot; chart repository
    Update Complete. ⎈ Happy Helming!⎈ 
    $ helm fetch my-virtual-repo/mychart
    $ ls
    mychart-0.3.2.tgz</code></pre>
Usage
Example using URL:
<pre><code class="lang-bash">$ helm push-artifactory /my/chart/folder https://my-artifactory/my-local-repo --username username --password password</code></pre>
Example using helm repo added through CLI: <pre><code class="lang-bash">$ helm push-artifactory /my/chart/folder my-local-repo</code></pre>
For all available plugin options, please run: <pre><code class="lang-bash">$ helm push-artifactory --help</code></pre>
Pushing a directory
Point to a directory containing a valid

Chart.yaml

 and the chart will be packaged and uploaded:
<pre><code class="lang-bash">$ cat mychart/Chart.yaml
name: mychart
version: 0.3.2</code></pre>
<pre><code class="lang-bash">$ helm push-artifactory mychart/ https://my-artifactory/my-local-repo
Pushing mychart-0.3.2.tgz to https://my-artifactory/my-local-repo/mychart/mychart-0.3.2.tgz...
Done.
Reindex helm repository my-local-repo...
Reindex of helm repo my-local-repo was scheduled to run.</code></pre>
Pushing with a custom version
The

--version or -v

 flag can be provided, which will push the package with a custom version.
Here is an example using the last git commit id as the version: <pre><code class="lang-bash">$ helm push-artifactory mychart/ --version=&quot;$(git log -1 --pretty=format:%h)&quot; https://my-artifactory/my-local-repo Pushing mychart-5abbbf28.tgz to https://my-artifactory/my-local-repo/mychart/mychart-5abbbf28.tgz... Done. Reindex helm repository my-local-repo... Reindex of helm repo my-local-repo was scheduled to run.</code></pre>
Pushing overriding values
The

--set or -s

 flag can be provided, which will push the package overriding values in the values.yaml file.
Here is an example using a custom version and default image tag: <pre><code class="lang-bash">$ helm push-artifactory mychart/ -v=&quot;0.5.1&quot; -s image.tag=&quot;0.5.1&quot; https://my-artifactory/my-local-repo Pushing mychart-0.5.1.tgz to https://my-artifactory/my-local-repo/mychart/mychart-0.5.1.tgz... Done. Reindex helm repository my-local-repo... Reindex of helm repo my-local-repo was scheduled to run.</code></pre>
If we check the values.yaml of the chart we'll find: <pre><code class="lang-">image:   tag: 0.5.1</code></pre>
We can override multiple values: <pre><code class="lang-bash">$ helm push-artifactory mychart/ -v=&quot;0.5.1&quot; -s image.tag=&quot;0.5.1&quot; -s service.name=&quot;my-custom-name&quot; https://my-artifactory/my-local-repo Pushing mychart-0.5.1.tgz to https://my-artifactory/my-local-repo/mychart/mychart-0.5.1.tgz... Done. Reindex helm repository my-local-repo... Reindex of helm repo my-local-repo was scheduled to run.</code></pre>
This will set in values.yaml: <pre><code class="lang-">image:   tag: 0.5.1 service:   name: my-custom-name</code></pre>
Push .tgz package
This workflow does not require the use of

helm package

, but pushing .tgz is still supported:
<pre><code class="lang-bash">$ helm push-artifactory mychart-0.3.2.tgz https://my-artifactory/my-local-repo
Pushing mychart-0.3.2.tgz to https://my-artifactory/my-local-repo/mychart/mychart-0.3.2.tgz...
Done.
Reindex helm repository my-local-repo...
Reindex of helm repo my-local-repo was scheduled to run.</code></pre>
Push with path
You can set a path to push your chart in your Artifactory local repository:
<pre><code class="lang-bash">$ helm push-artifactory mychart/ https://my-artifactory/my-local-repo --path organization
Pushing mychart-0.3.2.tgz to https://my-artifactory/my-local-repo/organization/mychart/mychart-0.3.2.tgz...
Done.
Reindex helm repository my-local-repo...
Reindex of helm repo my-local-repo was scheduled to run.</code></pre>
Skip repository reindex
You can skip triggering the repository reindex:
<pre><code class="lang-bash">$ helm push-artifactory mychart/ https://my-artifactory/my-local-repo --skip-reindex
Pushing mychart-0.3.2.tgz to https://my-artifactory/my-local-repo/mychart/mychart-0.3.2.tgz...
Done.</code></pre>
Authentication
Basic Auth
The plugin will not use the auth info located in

~/.helm/repository/repositories.yaml in order to authenticate.

You can provide username and password through commmand line with --username username --password password or use the following environment variables for basic auth on push operations: <pre><code class="lang-bash">$ export HELMREPOUSERNAME="myuser" $ export HELMREPOPASSWORD="mypass"</code></pre>


Access Token
You can provide an access token through command line with

--access-token my-token

 or use the following env var:
<pre><code class="lang-bash">$ export HELMREPOACCESS_TOKEN=&quot;&lt;token&gt;&quot;</code></pre>
If only the access token is supplied without any username, the plugin will send the token in the header: <pre><code class="lang-">Authorization: Bearer &lt;token&gt;</code></pre>
If a username is supplied with an access token, the plugin will use basic authentication, using the access token as password for the user.
Api Key
You can provide an api key through command line with

--api-key my-key` or use the following env var:

$ export HELMREPOAPI_KEY="<api-key>"

If only the api key is supplied without any username, the plugin will send the api key in the header:

X-JFrog-Art-Api: <api-key>

If a username is supplied with an api key, the plugin will use basic authentication, using the api key as password for the user.

TLS Client Cert Auth

If you need to setup your TLS cert authentication, the following options are available:

--ca-file string    Verify certificates of HTTPS-enabled servers using this CA bundle [$HELMREPOCA_FILE]
--cert-file string  Identify HTTPS client using this SSL certificate file [$HELMREPOCERT_FILE]
--key-file string   Identify HTTPS client using this SSL key file [$HELMREPOKEY_FILE]
--insecure          Connect to server with an insecure way by skipping certificate verification [$HELMREPOINSECURE]

🔗 More in this category