From c3a1895f2ec5fb949097156eb70c94ac9c5d68ed Mon Sep 17 00:00:00 2001 From: David Yu Date: Thu, 28 Oct 2021 12:27:00 -0700 Subject: [PATCH] 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 * 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 --- .../content/docs/k8s/installation/install.mdx | 21 +++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) diff --git a/website/content/docs/k8s/installation/install.mdx b/website/content/docs/k8s/installation/install.mdx index bcc729f8e..11bb78029 100644 --- a/website/content/docs/k8s/installation/install.mdx +++ b/website/content/docs/k8s/installation/install.mdx @@ -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 ... ```