Documentation for Kubernetes v1.4 is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.

Edit This Page

Dashboard (the web-based user interface of Kubernetes) allows you to deploy containerized applications to a Kubernetes cluster, troubleshoot them, and manage the cluster and its resources itself. You can use it for getting an overview of applications running on the cluster, as well as for creating or modifying individual Kubernetes resources and workloads, such as Daemon sets, Pet sets, Replica sets, Jobs, Replication controllers and corresponding Services, or Pods.

Dashboard also provides information on the state of Pods, Replication controllers, etc. and on any errors that might have occurred. You can inspect and manage the Kubernetes resources, as well as your deployed containerized applications. You can also change the number of replicated Pods, delete Pods, and deploy new applications using a deploy wizard.

By default, Dashboard is installed as a cluster addon. It is enabled by default as of Kubernetes 1.2 clusters.

Dashboard access

Navigate in your Browser to the following URL: https://<kubernetes-master>/ui This redirects to the following URL: https://<kubernetes-master>/api/v1/proxy/namespaces/kube-system/services/kubernetes-dashboard The Dashboard UI lives in the kube-system namespace, but shows all resources from all namespaces in your environment.

If you find that you are not able to access Dashboard, you can install and open the latest stable release by running the following command:

kubectl create -f https://rawgit.com/kubernetes/dashboard/master/src/deploy/kubernetes-dashboard.yaml

Then, navigate to

https://<kubernetes-master>/ui

In case you have to provide a password, use the following command to find it out:

kubectl config view

Welcome page

When accessing Dashboard on an empty cluster for the first time, the Welcome page is displayed. This page contains a link to this document as well as a button to deploy your first application. In addition, you can view which system applications are running by default in the kube-system namespace of your cluster, for example monitoring applications such as Heapster.

Kubernetes Dashboard welcome page

Deploying containerized applications

Dashboard lets you create and deploy a containerized application as a Replication Controller and corresponding Service with a simple wizard. You can either manually specify application details, or upload a YAML or JSON file containing the required information.

To access the deploy wizard from the Welcome page, click the respective button. To access the wizard at a later point in time, click the DEPLOY APP or UPLOAD YAML link in the upper right corner of any page listing workloads.

Deploy wizard

Specifying application details

The deploy wizard expects that you provide the following information:

If needed, you can expand the Advanced options section where you can specify more settings:

Deploy wizard advanced options

Uploading a YAML or JSON file

Kubernetes supports declarative configuration. In this style, all configuration is stored in YAML or JSON configuration files using the Kubernetes’ API resource schemas as the configuration schemas.

As an alternative to specifying application details in the deploy wizard, you can define your Replication Controllers and Services in YAML or JSON files, and upload the files to your Pods:

Deploy wizard file upload

Managing resources

List view

As soon as applications are running on your cluster, Dashboard’s initial view defaults to showing all resources available in all namespaces in a list view, for example:

Workloads view

For every resource, the list view shows the following information:

To filter the resources and only show those of a specific namespace, select it from the dropdown list in the right corner of the title bar:

Namespace selector

Details view

When clicking a resource, the details view is opened, for example:

Details view

The OVERVIEW tab shows the actual resource details as well as the Pods the resource is running in.

The EVENTS tab can be useful for debugging applications.

To go back to the workloads overview, click the Kubernetes logo.

Workload categories

Workloads are categorized as follows:

You can display the resources of a specific category in two ways:

Actions

Every list view offers an action menu to the right of the listed resources. The related details view provides the same actions as buttons in the upper right corner of the page.

More information

For more information, see the Kubernetes Dashboard repository.

Analytics

Create an Issue Edit this Page