Fix K8s dashboard install command

Correct helm command for install of Kubernetes dashboard.

Editorial cleanup (change tabs to spaces, wrap lines @79, fix typos).

Closes-Bug: 1887653

Change-Id: I572a309e0fe0351effa73cc66c5c0487b527833f
Signed-off-by: MCamp859 <maryx.camp@intel.com>
This commit is contained in:
MCamp859 2020-07-17 11:50:11 -04:00
parent 965e7aebe6
commit fe994e7322

View File

@ -2,8 +2,8 @@
Access StarlingX Kubernetes R4.0
================================
Use local/remote CLIs, GUIs, and/or REST APIs to access and manage StarlingX
Kubernetes and hosted containerized applications.
This section describes how to use local/remote CLIs, GUIs, and/or REST APIs to
access and manage StarlingX Kubernetes and hosted containerized applications.
.. contents::
:local:
@ -13,16 +13,17 @@ Kubernetes and hosted containerized applications.
Local CLIs
----------
In order to access the StarlingX and Kubernetes commands on controller-O, first
follow these steps:
To access the StarlingX and Kubernetes commands on controller-0, follow these
steps:
#. Log in to controller-0 via the console or SSH with a sysadmin/<sysadmin-password>.
#. Log in to controller-0 via the console or SSH with a
sysadmin/<sysadmin-password>.
#. Acquire Keystone admin and Kubernetes admin credentials:
::
source /etc/platform/openrc
source /etc/platform/openrc
*********************************************
StarlingX system and host management commands
@ -33,13 +34,13 @@ command. For example:
::
system host-list
system host-list
+----+--------------+-------------+----------------+-------------+--------------+
| id | hostname | personality | administrative | operational | availability |
+----+--------------+-------------+----------------+-------------+--------------+
| 1 | controller-0 | controller | unlocked | enabled | available |
+----+--------------+-------------+----------------+-------------+--------------+
+----+--------------+-------------+----------------+-------------+--------------+
| id | hostname | personality | administrative | operational | availability |
+----+--------------+-------------+----------------+-------------+--------------+
| 1 | controller-0 | controller | unlocked | enabled | available |
+----+--------------+-------------+----------------+-------------+--------------+
Use the :command:`system help` command for the full list of options.
@ -47,11 +48,12 @@ Use the :command:`system help` command for the full list of options.
StarlingX fault management commands
***********************************
Access StarlingX fault management commands using the :command:`fm` command, for example:
Access StarlingX fault management commands using the :command:`fm` command, for
example:
::
fm alarm-list
fm alarm-list
*******************
Kubernetes commands
@ -61,10 +63,10 @@ Access Kubernetes commands using the :command:`kubectl` command, for example:
::
kubectl get nodes
kubectl get nodes
NAME STATUS ROLES AGE VERSION
controller-0 Ready master 5d19h v1.13.5
NAME STATUS ROLES AGE VERSION
controller-0 Ready master 5d19h v1.13.5
See https://kubernetes.io/docs/reference/kubectl/overview/ for details.
@ -89,9 +91,10 @@ StarlingX Horizon GUI
Access the StarlingX Horizon GUI with the following steps:
#. Enter the OAM floating IP address in your browser:
`\http://<oam-floating-ip-address>:8080`
``\http://<oam-floating-ip-address>:8080``.
Discover your OAM floating IP address with the :command:`system oam-show` command.
Discover your OAM floating IP address with the :command:`system oam-show`
command.
#. Log in to Horizon with an admin/<sysadmin-password>.
@ -101,68 +104,72 @@ Kubernetes dashboard
The Kubernetes dashboard is not installed by default.
To install the Kubernetes dashboard, execute the following steps on controller-0:
To install the Kubernetes dashboard, execute the following steps on
controller-0:
#. Use the kubernetes-dashboard helm chart from the stable helm repository with
the override values shown below:
::
cat <<EOF > dashboard-values.yaml
service:
type: NodePort
nodePort: 30000
cat <<EOF > dashboard-values.yaml
service:
type: NodePort
nodePort: 30000
rbac:
create: true
clusterAdminRole: true
rbac:
create: true
clusterAdminRole: true
serviceAccount:
create: true
name: kubernetes-dashboard
EOF
serviceAccount:
create: true
name: kubernetes-dashboard
EOF
helm repo update
helm repo update
helm install stable/kubernetes-dashboard --name dashboard -f dashboard-values.yaml
helm repo add kubernetes-dashboard https://kubernetes.github.io/dashboard/
#. Create an ``admin-user`` service account with ``cluster-admin`` privileges, and
display its token for logging into the Kubernetes dashboard.
helm install dashboard kubernetes-dashboard/kubernetes-dashboard -f dashboard-values.yaml
#. Create an ``admin-user`` service account with ``cluster-admin`` privileges,
and display its token for logging into the Kubernetes dashboard.
::
cat <<EOF > admin-login.yaml
apiVersion: v1
kind: ServiceAccount
metadata:
name: admin-user
namespace: kube-system
---
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: kube-system
EOF
cat <<EOF > admin-login.yaml
apiVersion: v1
kind: ServiceAccount
metadata:
name: admin-user
namespace: kube-system
---
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: kube-system
EOF
kubectl apply -f admin-login.yaml
kubectl apply -f admin-login.yaml
kubectl -n kube-system describe secret $(kubectl -n kube-system get secret | grep admin-user | awk '{print $1}')
kubectl -n kube-system describe secret $(kubectl -n kube-system get secret | grep admin-user | awk '{print $1}')
Access the Kubernetes dashboard GUI with the following steps:
#. Enter the OAM floating IP address in your browser:
`\https://<oam-floating-ip-address>:30000`.
``\https://<oam-floating-ip-address>:30000``.
Discover your OAM floating IP address with the :command:`system oam-show` command.
Discover your OAM floating IP address with the :command:`system oam-show`
command.
#. Log in to the Kubernetes dashboard using the ``admin-user`` token.
@ -175,7 +182,7 @@ following command:
::
openstack endpoint list | grep public
openstack endpoint list | grep public
Use these URLs as the prefix for the URL target of StarlingX Platform Services'
REST API messages.