Skip to content

Commit

Permalink
docs: Add docs how to use ArgoCD with helm plugins
Browse files Browse the repository at this point in the history
argoproj#2558 Based on discussions from:

argoproj#2558
argoproj#2789
argoproj#1105
argoproj#1153

I've spent a lot of time to put everything together to get integration with GCS working. I think it's worth to have documentation for it.
  • Loading branch information
pnowy authored Jun 13, 2020
1 parent 1aeba18 commit 46a234b
Showing 1 changed file with 36 additions and 0 deletions.
36 changes: 36 additions & 0 deletions docs/user-guide/helm.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,3 +137,39 @@ Or via declarative syntax:
- name: app
value: $ARGOCD_APP_NAME
```

## Helm plugins

> v1.5

Argo CD is un-opinionated on what cloud provider you use and what kind of Helm plugins you are using that's why there is no any plugins delivered with ArgoCD image.

But sometimes it happens you would like to use custom plugin. One of the cases is that you would like to use Google Cloud Storage or Amazon S3 storage to save the Helm charts, for example: https://github.com/hayorov/helm-gcs where you can use `gs://` protocol for Helm chart repository access.

In order to do that you have to prepare your own ArgoCD image with installed plugins.

Example `Dockerfile`:

```
FROM argoproj/argocd:v1.5.7
USER root
RUN apt-get update && \
apt-get install -y \
curl && \
apt-get clean && \
rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
USER argocd
ARG GCS_PLUGIN_VERSION="0.3.5"
ARG GCS_PLUGIN_REPO="https://github.com/hayorov/helm-gcs.git"
RUN helm plugin install ${GCS_PLUGIN_REPO} --version ${GCS_PLUGIN_VERSION}
ENV HELM_PLUGINS="/home/argocd/.local/share/helm/plugins/"
```

You have to remember about `HELM_PLUGINS` environment property - this is required to works plugins correctly.

After that you have to use your custom image for ArgoCD installation.

1 comment on commit 46a234b

@lodotek
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

46a234b#diff-064c81205e23472df9cae72b43f42b7bR170. Shouldn't this be ENV HELM_PLUGINS="/home/argocd/.helm/share/helm/plugins/" ?

Please sign in to comment.