Merge pull request #2266 from nicdesousa/dashboard

Dashboard Quick-Start

content/k3s/latest/en/installation/kube-dashboard/_index.md

@@ -0,0 +1,88 @@
+---
+title: "Kubernetes Dashboard"
+weight: 60
+---
+
+This installation guide will help you to deploy and configure the [Kubernetes Dashboard](https://kubernetes.io/docs/tasks/access-application-cluster/web-ui-dashboard/) on K3s.
+
+### Deploying the Kubernetes Dashboard
+
+```bash
+sudo k3s kubectl create -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.0.0-rc5/aio/deploy/recommended.yaml
+```
+
+### Dashboard RBAC Configuration
+
+> **Important:** The `admin-user` created in this guide will have administrative privileges in the Dashboard.
+
+Create the following resource manifest files:
+
+`dashboard.admin-user.yml`
+```yaml
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: admin-user
+  namespace: kubernetes-dashboard
+```
+
+`dashboard.admin-user-role.yml`
+```yaml
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRoleBinding
+metadata:
+  name: admin-user
+roleRef:
+  apiGroup: rbac.authorization.k8s.io
+  kind: ClusterRole
+  name: cluster-admin
+subjects:
+- kind: ServiceAccount
+  name: admin-user
+  namespace: kubernetes-dashboard
+```
+
+Deploy the `admin-user` configuration:
+
+```bash
+sudo k3s kubectl create -f dashboard.admin-user.yml -f dashboard.admin-user-role.yml
+```
+
+### Obtain the Bearer Token
+
+```bash
+sudo k3s kubectl -n kubernetes-dashboard describe secret admin-user-token | grep ^token
+```
+
+### Local Access to the Dashboard
+
+To access the Dashboard you must create a secure channel to your K3s cluster:
+
+```bash
+sudo k3s kubectl proxy
+```
+
+The Dashboard is now accessible at:
+
+* http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/
+* `Sign In` with the `admin-user` Bearer Token
+
+#### Advanced: Remote Access to the Dashboard
+
+Please see: Using [Port Forwarding](https://kubernetes.io/docs/tasks/access-application-cluster/port-forward-access-application-cluster/) to Access Applications in a Cluster.
+
+### Upgrading the Dashboard
+
+The latest Dashboard releases are available from: https://github.com/kubernetes/dashboard/releases/latest
+
+```bash
+sudo k3s kubectl delete ns kubernetes-dashboard
+sudo k3s kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/[...]
+```
+
+### Deleting the Dashboard and admin-user configuration
+
+```bash
+sudo k3s kubectl delete -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.0.0-rc5/aio/deploy/recommended.yaml
+sudo k3s kubectl delete -f dashboard.admin-user.yml -f dashboard.admin-user-role.yml
+```