Skip to content

Commit

Permalink
Add documenation to support helm3 migration
Browse files Browse the repository at this point in the history
Signed-off-by: faizanahmad055 <faizan.ahmad55@outlook.com>
  • Loading branch information
faizanahmad055 committed Oct 25, 2020
1 parent 284ca59 commit 63fd3c2
Showing 1 changed file with 60 additions and 0 deletions.
60 changes: 60 additions & 0 deletions docs/Helm2-to-Helm3.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
# Helm2 to Helm3 Migration

Follow below mentioned instructions to migrate reloader from Helm2 to Helm3

## Instrcutions:

There are 3 steps involved in migrating the reloader from Helm2 to Helm3.

### Step 1:
Install the helm-2to3 plugin

```bash
helm3 plugin install https://github.com/helm/helm-2to3

helm3 2to3 convert <release-name>

helm3 2to3 cleanup --release-cleanup --skip-confirmation
```

### Step 2:
Add the following Helm3 labels and annotations on reloader resources.
Label:
´´ýaml
app.kubernetes.io/managed-by=Helm
´´´
Annotations:
´´ýaml
meta.helm.sh/release-name=<release-name>
meta.helm.sh/release-namespace=<namespace>
´´´

For example, to label and annotate the ClusterRoleBinding and ClusterRole:

```bash
KIND=ClusterRoleBinding
NAME=reloader-reloader-role-binding
RELEASE=reloader
NAMESPACE=kube-system
kubectl annotate $KIND $NAME meta.helm.sh/release-name=$RELEASE
kubectl annotate $KIND $NAME meta.helm.sh/release-namespace=$NAMESPACE
kubectl label $KIND $NAME app.kubernetes.io/managed-by=Helm

KIND=ClusterRole
NAME=reloader-reloader-role
RELEASE=reloader
NAMESPACE=kube-system
kubectl annotate $KIND $NAME meta.helm.sh/release-name=$RELEASE
kubectl annotate $KIND $NAME meta.helm.sh/release-namespace=$NAMESPACE
kubectl label $KIND $NAME app.kubernetes.io/managed-by=Helm
```

### Step 3:
Upgrade to desired version
```bash
helm3 repo add stakater https://stakater.github.io/stakater-charts

helm3 repo update

helm3 upgrade <release-name> stakater/reloader --version=v0.0.72
```

0 comments on commit 63fd3c2

Please sign in to comment.