Merge pull request #223 from gertipoppel/master

Updated the dashboard documentation

_data/guides.yml

@@ -16,6 +16,8 @@ toc:
     path: /docs/user-guide/walkthrough/
   - title: Kubernetes 201
     path: /docs/user-guide/walkthrough/k8s201/
+  - title: Accessing the Kubernetes Web UI
+    path: /docs/user-guide/ui-access/
 
 - title: User Guide
   path: /docs/user-guide/
@@ -246,6 +248,8 @@ toc:
     path: /docs/user-guide/rolling-updates/
   - title: Launching, Exposing, and Killing Applications
     path: /docs/user-guide/quick-start/
+  - title: Web Interface
+    path: /docs/user-guide/ui/
 
 - title: Testing and Monitoring
   section:

_data/support.yml

@@ -8,8 +8,6 @@ toc:
   section:
   - title: Debugging Pods and Replication Controllers
     path: /docs/user-guide/debugging-pods-and-replication-controllers/
-  - title: Web Interface
-    path: /docs/user-guide/ui/
   - title: Application Introspection and Debugging
     path: /docs/user-guide/introspection-and-debugging/
   - title: Retrieving Logs

docs/hellonode.md

@@ -362,6 +362,17 @@ While this is happening, the users of the services should not see any interrupti
 
 Hopefully with these deployment, scaling and update features you’ll agree that once you’ve setup your environment (your GKE/Kubernetes cluster here), Kubernetes is here to help you focus on the application rather than the infrastructure.
 
+## Observe the Kubernetes Web UI (optional)
+
+With Kubernetes 1.2, a graphical web user interface (dashboard) has been introduced. It is enabled by default for 1.2 clusters.
+This user interface allows you to get started quickly and enables some of the functionality found in the CLI as a more approachable and discoverable way of interacting with the system.
+
+Enjoy the Kubernetes graphical dashboard and use it for deploying containerized applications, as well as for monitoring and managing your clusters!
+
+![image](/images/docs/ui-dashboard-cards-menu.png)
+
+Learn more about the web interface by taking the [Dashboard tour](/docs/user-guide/ui/).
+
 ## That's it! Time to tear it down
 
 That's it for the demo! So you don't leave this all running and incur charges, let's learn how to tear things down.

docs/user-guide/ui-access.md

@@ -0,0 +1,32 @@
+---
+---
+
+By default, the Kubernetes Dashboard is deployed as a cluster addon. For 1.2 clusters, it is enabled by default.
+
+If you want to manually install 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 as follows:
+
+```shell
+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`](http://releases.k8s.io/{{page.githubbranch}}/cluster/saltbase/salt/kube-addons/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.
+
+## Walkthrough
+
+For information on how to use the Dashboard, take the [Dashboard tour](/docs/user-guide/ui/).
+
+## More Information
+
+For more information, see the
+[Kubernetes Dashboard repository](https://github.com/kubernetes/dashboard).

docs/user-guide/ui.md

@@ -5,31 +5,13 @@
 Kubernetes has a web-based user interface that allows you to deploy containerized
 applications to a Kubernetes cluster, troubleshoot them, and manage the cluster itself.
 
-## Accessing the Dashboard
-
-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 as follows:
-
-```shell
-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`](http://releases.k8s.io/{{page.githubbranch}}/cluster/saltbase/salt/kube-addons/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.
+By default, the Kubernetes Dashboard is deployed as a cluster addon. It is enabled by default in Kubernetes 1.2 clusters. Click [here](/docs/user-guide/ui-access/) to learn more about the Dashboard access.
 
 ## Using the Dashboard
 
 The Dashboard can be used to get an overview of applications running on the cluster, and to provide information on any errors that have occurred. You can also inspect your replication controllers and corresponding services, change the number of replicated Pods, and deploy new applications using a deploy wizard.
 
-When accessing the 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.
+When accessing the 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](/docs/admin/namespaces/) of your cluster, for example monitoring applications such as Heapster.
 
 ![Kubernetes Dashboard welcome page](/images/docs/ui-dashboard-zerostate.png)
 
@@ -45,7 +27,7 @@ The wizard expects that you provide the following information:
 
 - **App name** (mandatory): Name for your application. A [label](/docs/user-guide/labels/) with the name will be added to the Replication Controller and Service, if any, that will be deployed.
 
-  The application name must be unique within the selected Kubernetes namespace. It must start with a lowercase character, and contain only lowercase letters, numbers and dashes (-). It is limited to 24 characters.
+  The application name must be unique within the selected Kubernetes [namespace](/docs/admin/namespaces/). It must start with a lowercase character, and contain only lowercase letters, numbers and dashes (-). It is limited to 24 characters.
 
 - **Container image** (mandatory): The URL of a public Docker [container image](/docs/user-guide/images/) on any registry, or a private image (commonly hosted on the Google Container Registry or Docker Hub).