If you are using a released version of Kubernetes, you should refer to the docs that go with that version.
The latest release of this document can be found [here](http://releases.k8s.io/release-1.1/docs/user-guide/ui.md).Documentation for other releases can be found at releases.k8s.io.
Kubernetes has a web-based user interface that allows users to manage applications running in the cluster and troubleshoot them, as well as manage the cluster itself.
By default, the Kubernetes Dashboard is deployed as a cluster addon. To access it, visit
https://<kubernetes-master>/ui
, which redirects to
https://<kubernetes-master>/api/v1/proxy/namespaces/kube-system/services/kubernetes-dashboard
.
If you find that you're not able to access the Dashboard, it may be because the kubernetes-dashboard service has not been started on your cluster. In that case, you can start it manually with:
kubectl create -f cluster/addons/dashboard/dashboard-controller.yaml --namespace=kube-system
kubectl create -f cluster/addons/dashboard/dashboard-service.yaml --namespace=kube-system
Normally, this should be taken care of automatically by the
kube-addons.sh
script that runs on the master. Release notes and development versions of the Dashboard can be
found at https://github.com/kubernetes/dashboard/releases.
The Dashboard can be used to provide an overview of applications running on the cluster and provide information on any errors that have occurred. You can also inspect your replication controllers and corresponding services, change the number of replicas and deploy new applications using a wizard.
When first accessing the dashboard on an empty cluster, you should see the welcome page.
This contains some useful links to the documentation, and a big button to deploy your first
application.
The Kubernetes Dashboard lets you create and deploy a Replication Controller with a simple wizard. You can simply provide the name for your application, the name of a Docker container (commonly hosted on the Google Container Registry or Docker Hub) and the target number of Pods you want deployed. Optionally, if your container listens on a port, you can also provide a port and target port. The wizard will create a corresponding Kubernetes Service which will route to your deployed Pods.
If needed, you can expand the "more options" section where you can change more advanced settings, such as the Kubernetes namespace that the resulting Pods run in, image pull secrets for private registries, resource limits, container entrypoint and privileged status.
If some applications are running on your cluster, the Dashboard will default to showing an overview. Individual applications are shown as cards - where an application is defined as a Replication Controller and its corresponding services. Each card shows the current number of replicas running and desired, along with any errors reported by Kubernetes. You can also view logs, make quick changes to the number of replicas or delete the application directly from the menu in the cards' corner.
Clicking "View details" from the card menu will take you to the following screen, where you can view more information about the Pods that make up your application. The events tab can be useful in debugging flapping applications.
For more information, see the Kubernetes Dashboard repository.