diff --git a/CHANGELOG.md b/CHANGELOG.md index 45e10d5825..a8d6a889d2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -43,13 +43,18 @@ If you are running v0.4 of the chart, you should upgrade to v0.5 first before upgrading to v0.6. You can find out what version you are using by running `helm list`. -#### Troubleshooting +### Helm Version recommendation -If your helm upgrade fails due to the error `no Ingress with the name "jupyterhub-internal" found`, -you may be experiencing a [helm bug](https://github.com/kubernetes/helm/issues/3275). To work -around this, run `kubectl --namespace= delete ingress jupyterhub-internal` and -re-run the `helm upgrade` command. Note that this will cause a short unavailability of your hub -over HTTPS, which will resume normal availability once the deployment upgrade completes. +Due to a [severe bug](https://github.com/kubernetes/helm/issues/3275) in helm v2.7 and 2.8, +we currently recommend users stick to helm version 2.6 if possible. +If you run into an error along the lines of `no Ingress with the name "jupyterhub-internal" found`, +then you have run into this bug. You can downgrade helm by: + +```bash +curl https://raw.githubusercontent.com/kubernetes/helm/master/scripts/get > install-helm.bash +bash install-helm.bash --version v2.6.2 +helm init --upgrade +``` ### New Features diff --git a/doc/source/setup-helm.rst b/doc/source/setup-helm.rst index 4265bbc78f..f33be7c486 100644 --- a/doc/source/setup-helm.rst +++ b/doc/source/setup-helm.rst @@ -15,11 +15,16 @@ terminal: .. code:: bash - curl https://raw.githubusercontent.com/kubernetes/helm/master/scripts/get | bash + curl https://raw.githubusercontent.com/kubernetes/helm/master/scripts/get > install-helm.bash + bash install-helm.bash --version v2.6.2 + `Alternative methods for helm installation `_ exist if you prefer to install without using the script. +We highly recommend sticking to version 2.6.2 of helm until this severe +`bug `_ is fixed. + .. _helm-rbac: Initialization @@ -72,10 +77,11 @@ It should provide output like: .. code-block:: bash - Client: &version.Version{SemVer:"v2.4.1", GitCommit:"46d9ea82e2c925186e1fc620a8320ce1314cbb02", GitTreeState:"clean"} - Server: &version.Version{SemVer:"v2.4.1", GitCommit:"46d9ea82e2c925186e1fc620a8320ce1314cbb02", GitTreeState:"clean"} + Client: &version.Version{SemVer:"v2.6.2", GitCommit:"46d9ea82e2c925186e1fc620a8320ce1314cbb02", GitTreeState:"clean"} + Server: &version.Version{SemVer:"v2.6.2", GitCommit:"46d9ea82e2c925186e1fc620a8320ce1314cbb02", GitTreeState:"clean"} -Make sure you have at least version 2.4.1! +Make sure you have at least version 2.6.2, but not newer (until +`this bug `_ is fixed) If you receive an error that the Server is unreachable, do another `helm version` in 15-30 seconds, and it should display the Server version.