docs: revised Helm install to create namespace and install on dedicated namespace (#11440)

* docs: revised Helm install to create namespace and install on dedicated Consul namespace

* Update website/content/docs/k8s/installation/install.mdx

Co-authored-by: mrspanishviking <kcardenas@hashicorp.com>

* Update install.mdx

* changing to Helm 3.2+ as a pre-req to make it easier to follow
* might as well bump to latest version

Co-authored-by: mrspanishviking <kcardenas@hashicorp.com>
This commit is contained in:
David Yu 2021-10-28 12:27:00 -07:00 committed by GitHub
parent 503dee2d80
commit c3a1895f2e
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -54,7 +54,7 @@ manual configuration.
### Prerequisites
The Consul Helm only supports Helm 3. Install the latest version of the Helm CLI here:
The Consul Helm only supports Helm 3.2+. Install the latest version of the Helm CLI here:
[Installing Helm](https://helm.sh/docs/intro/install/).
### Installing Consul
@ -71,13 +71,26 @@ The Consul Helm only supports Helm 3. Install the latest version of the Helm CLI
```shell-session
$ helm search repo hashicorp/consul
NAME CHART VERSION APP VERSION DESCRIPTION
hashicorp/consul 0.32.0 1.10.0 Official HashiCorp Consul Chart
hashicorp/consul 0.35.0 1.10.3 Official HashiCorp Consul Chart
```
1. Issue the following command to install Consul with the default configuration using Helm 3:
1. Prior to installing via Helm, ensure that the `consul` Kubernetes namespace does not exist, as installing on a dedicated namespace
is recommended.
```shell-session
$ kubectl get namespace
NAME STATUS AGE
default Active 18h
kube-node-lease Active 18h
kube-public Active 18h
kube-system Active 18h
```
1. Issue the following command to install Consul with the default configuration using Helm. You could also install Consul on a dedicated
namespace of your choosing by modifying the value of the `-n` flag for the Helm install.
```shell-session
$ helm install consul hashicorp/consul --set global.name=consul
$ helm install consul hashicorp/consul --set global.name=consul --create-namespace -n consul
NAME: consul
...
```