Web UI (控制面板)
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.
访问控制面板
在浏览器中输入以下网址:
https://<kubernetes-master>/ui
它会重定向到以下网址:
https://<kubernetes-master>/api/v1/proxy/namespaces/kube-system/services/kubernetes-dashboard
控制面板在kube-system namespace之下，但是它会显示你的环境下的所有 namespaces 的资源。
如果不能访问控制面板，你可以运行一下命令来安装最新稳定版：
kubectl create -f https://rawgit.com/kubernetes/dashboard/master/src/deploy/kubernetes-dashboard.yaml
然后打开
https://<kubernetes-master>/ui
如果需要密码的话，可以使用下面的命令来找到它：
kubectl config view
欢迎页面
当第一次访问一个空的群集上的控制面板，它会显示欢迎页面。此页面包含这个文档的链接，以及一个首次部署应用的按钮。此外，还可以查看在kube-system namespace中 默认 运行的应用。 例如类似 Heapster 的监控应用。
部署容器化应用
Dashboard（控制面板）可以让你创建和部署容器化应用作为一个 Replication Controller 和 相应 Service的简单向导。你可以手动指定应用程序的设置，或者上传一个包含所需信息的 YAML 或者 JSON 文件
要访问欢迎页面上的部署向导，点击相应的按钮。以后在任何页面点击右上角的 DEPLOY APP 或者 UPLOAD YAML 链接，来访问该向导。
指定应用的详细配置
部署向导需要你提供一下信息：
-
App name (mandatory): Name for your application. A label 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 and end with a lowercase character, and contain only lowercase letters, numbers and dashes (-). It is limited to 24 characters. Leading and trailing spaces are ignored.
-
Container image (mandatory): The URL of a public Docker container image on any registry, or a private image (commonly hosted on the Google Container Registry or Docker Hub). The container image specification must end with a colon.
-
Number of pods (mandatory): The target number of Pods you want your application to be deployed in. The value must be a positive integer.
A Replication Controller will be created to maintain the desired number of Pods across your cluster.
-
Service (optional): For some parts of your application (e.g. frontends) you may want to expose a Service onto an external, maybe public IP address outside of your cluster (external Service). For external Services, you may need to open up one or more ports to do so. Find more details here.
Other Services that are only visible from inside the cluster are called internal Services.
Irrespective of the Service type, if you choose to create a Service and your container listens on a port (incoming), you need to specify two ports. The Service will be created mapping the port (incoming) to the target port seen by the container. This Service will route to your deployed Pods. Supported protocols are TCP and UDP. The internal DNS name for this Service will be the value you specified as application name above.
If needed, you can expand the Advanced options section where you can specify more settings:
-
Description: The text you enter here will be added as an annotation to the Replication Controller and displayed in the application’s details.
-
Labels: Default labels to be used for your application are application name and version. You can specify additional labels to be applied to the Replication Controller, Service (if any), and Pods, such as release, environment, tier, partition, and release track.
Example:
release=1.0 tier=frontend environment=pod track=stable -
Namespace: Kubernetes supports multiple virtual clusters backed by the same physical cluster. These virtual clusters are called namespaces. They let you partition resources into logically named groups.
Dashboard offers all available namespaces in a dropdown list, and allows you to create a new namespace. The namespace name may contain a maximum of 63 alphanumeric characters and dashes (-).
In case the creation of the namespace is successful, it is selected by default. If the creation fails, the first namespace is selected.
-
Image Pull Secret: In case the specified Docker container image is private, it may require pull secret credentials.
Dashboard offers all available secrets in a dropdown list, and allows you to create a new secret. The secret name must follow the DNS domain name syntax, e.g.
new.image-pull.secret. The content of a secret must be base64-encoded and specified in a.dockercfgfile. The secret name may consist of a maximum of 253 characters.In case the creation of the image pull secret is successful, it is selected by default. If the creation fails, no secret is applied.
-
CPU requirement (cores) and Memory requirement (MiB): You can specify the minimum resource limits for the container. By default, Pods run with unbounded CPU and memory limits.
-
Run command and Run command arguments: By default, your containers run the specified Docker image’s default entrypoint command. You can use the command options and arguments to override the default.
-
Run as privileged: This setting determines whether processes in privileged containers are equivalent to processes running as root on the host. Privileged containers can make use of capabilities like manipulating the network stack and accessing devices.
-
Environment variables: Kubernetes exposes Services through environment variables. You can compose environment variable or pass arguments to your commands using the values of environment variables. They can be used in applications to find a Service. Values can reference other variables using the
$(VAR_NAME)syntax.
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:
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:
For every resource, the list view shows the following information:
- Name of the resource
- All labels assigned to the resource
- Number of pods assigned to the resource
- Age, i.e. amount of time passed since the resource has been created
- Docker container image
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:
Details view
When clicking a resource, the details view is opened, for example:
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:
- Daemon Sets which ensure that all or some of the nodes in your cluster run a copy of a Pod.
- Deployments which provide declarative updates for Pods and Replica Sets (the next-generation Replication Controller) The Details page for a Deployment lists resource details, as well as new and old Replica Sets. The resource details also include information on the RollingUpdate strategy, if any.
- Pet Sets (nominal Services, also known as load-balanced Services) for legacy application support.
- Replica Sets for using label selectors.
- Jobs for creating one or more Pods, ensuring that a specified number of them successfully terminate, and tracking the completions.
- Replication Controllers
- Pods
You can display the resources of a specific category in two ways:
- Click the category name, e.g. Deployments
-
Edit the Dashboard URL and add the name of a desired category. For example, to display the list of Replication Controllers, specify the following URL:
http://<your_host>:9090/#/replicationcontroller
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.
-
Edit
Opens a text editor so that you can instantly view or update the JSON or YAML file of the respective resource.
-
Delete
After confirmation, deletes the respective resource.
When deleting a Replication Controller, the Pods managed by it are also deleted. You have the option to also delete Services related to the Replication Controller.
-
View details
For Replication Controllers only. Takes you to the details page where you can view more information about the Pods that make up your application.
-
Scale
For Replication Controllers only. Changes the number of Pods your application runs in. The respective Replication Controller will be updated to reflect the newly specified number. Be aware that setting a high number of Pods may result in a decrease of performance of the cluster or Dashboard itself.
More information
For more information, see the Kubernetes Dashboard repository.