From 46a234b1f3c2e157058d541ca27b078153335e88 Mon Sep 17 00:00:00 2001
From: Przemek <przemek.nowak.pl@gmail.com>
Date: Sat, 13 Jun 2020 12:47:48 +0200
Subject: [PATCH] docs: Add docs how to use ArgoCD with helm plugins

#2558 Based on discussions from:

https://github.com/argoproj/argo-cd/issues/2558
https://github.com/argoproj/argo-cd/issues/2789
https://github.com/argoproj/argo-cd/issues/1105
https://github.com/argoproj/argo-cd/issues/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.
---
 docs/user-guide/helm.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/docs/user-guide/helm.md b/docs/user-guide/helm.md
index 7b71ef14290c5..bcf41e4497e10 100644
--- a/docs/user-guide/helm.md
+++ b/docs/user-guide/helm.md
@@ -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.