add first step

Author: alexei-led

stable/helm/NOTES.md

@@ -0,0 +1,9 @@
+## Kubernetes Configuration
+
+Currently, you need to pass a Kubernetes configuration file as a single line string, using `KUBE_CONFIG` environment variable. Please, make sure to use a valid [Kubernetes configuration file](https://kubernetes.io/docs/tasks/access-application-cluster/configure-access-multiple-clusters/) with at least one context and `current-context` set to one you want to use.
+
+Use following command to generate single line, base 64 encoded string:
+
+```sh
+$ KUBE_CONFIG=$(cat ~/.kube/my_cluster_config | base64 -e | tr -d '\r\n')
+```

stable/helm/README.md

@@ -0,0 +1,36 @@
+# Codefresh Helm Plugin
+
+Use Codefresh [Helm](https://helm.sh) plugin to deploy a Helm chart into specified (by context) Kubernetes cluster. 
+
+## Usage
+
+Set required and optional environment variable and add the following step to your Codefresh pipeline:
+
+```yaml
+---
+version: '1.0'
+
+steps:
+
+  ...
+
+  release_to_env:
+    image: codefresh/plugin-helm
+
+  ...
+
+```
+
+## Environment Variables
+
+- **required** `CHART_NAME` - Helm chart name
+- **required** `RELEASE_NAME` - Helm release name
+- **required** `KUBE_CONFIG` - Kubernetes configuration file (single line base64 encoded string)
+- `NAMESPACE` - target Kubernetes namespace
+- `CHART_VERSION` - application chart version to install
+- `CHART_REPO_URL` - Helm chart repository URL
+- `DRY_RUN` - do a "dry run" installation (do not install anything, useful for Debug)
+- `DEBUG` - print verbose install output
+- `WAIT` - block step execution till installation completed and all Kubernetes resources are ready
+- `TIMEOUT` - wait timeout (5min by default)
+

stable/helm/plugin.yaml

@@ -0,0 +1,39 @@
+image: codefresh/plugin-helm
+tag: master
+version: 1.0.0
+description: Release a Helm chart (update or install)
+keywords:
+  - helm
+  - kubernetes
+home: https://github.com/codefresh-io/cf-plugin-helm
+sources:
+  - https://github.com/codefresh-io/cf-plugin-helm
+maintainers: # (optional)
+  - name: Alexei Ledenev
+    email: alexei@codefresh.io
+icon: A URL to an SVG or PNG image to be used as an icon (optional)
+envs:
+  - name: CHART_NAME
+    type: required
+    description: Helm chart name to release
+  - name: RELEASE_NAME
+    type: required
+    description: Helm release name
+  - name: NAMESPACE
+    description: target Kubernetes namespace
+  - name: CHART_VERSION
+    description: application chart version to install
+  - name: CHART_REPO_URL
+    description: Helm chart repository URL
+  - name: DRY_RUN
+    description: do a "dry run" installation (do not install anything, useful for Debug)
+  - name: DEBUG
+    description: print verbose install output
+  - name: WAIT
+    description: block step execution till installation completed and all Kubernetes resources are ready
+  - name: TIMEOUT
+    description: wait timeout (5min by default)
+volumes:
+  - name: /root/.kube/config
+    required: true
+    description: Kubernetes configuration file (**TODO** need to be implemented)