diff --git a/articles/201908/kuboard-view-of-k8s.md b/articles/201908/kuboard-view-of-k8s.md
index 2ad4964..a56f4e2 100644
--- a/articles/201908/kuboard-view-of-k8s.md
+++ b/articles/201908/kuboard-view-of-k8s.md
@@ -1,3 +1,7 @@
+---
+description: 本文描述了一个经典微服务参考架构，并且通过三个视图（集群概览、名称空间、工作负载）理解微服务与 Kubernetes 的映射关系。
+---
+
# 从微服务视角看 Kubernetes
## 微服务
diff --git a/devops/README.md b/devops/README.md
index 53f8945..1fcab71 100644
--- a/devops/README.md
+++ b/devops/README.md
@@ -1,3 +1,7 @@
+---
+description: Kubernetes + DevOps 文档
+---
+
# Kubernetes + DevOps
如何继承 DevOps ？
@@ -6,4 +10,4 @@
-
\ No newline at end of file
+
diff --git a/glossary/cidr.md b/glossary/cidr.md
index 08103d5..4c44dfe 100644
--- a/glossary/cidr.md
+++ b/glossary/cidr.md
@@ -1,3 +1,7 @@
+---
+description: CIDR Classless Inter-Domain Routing 概念解析
+---
+
# CIDR
CIDR（无类别域间路由，Classless Inter-Domain Routing）是一个在Internet上创建附加地址的方法，这些地址提供给服务提供商（ISP），再由ISP分配给客户。CIDR将路由集中起来，使一个IP地址代表主要骨干提供商服务的几千个IP地址，从而减轻Internet路由器的负担。
@@ -11,4 +15,4 @@ CIDR 地址中包含标准的32位IP地址和有关网络前缀位数的信息
## 参考文档
* [CIDR 计算](https://cloud.tencent.com/developer/article/1151790)
-* [CIDR to IPv4 Conversion](https://www.ipaddressguide.com/cidr)
\ No newline at end of file
+* [CIDR to IPv4 Conversion](https://www.ipaddressguide.com/cidr)
diff --git a/guide/README.md b/guide/README.md
index 9d43e12..ac2342d 100644
--- a/guide/README.md
+++ b/guide/README.md
@@ -1,3 +1,7 @@
+---
+description: 熟悉 Kuboard on Kubernetes 的最佳途径。
+---
+
# 使用手册
**Kuboard 的设计目标**
diff --git a/guide/cluster/computing.md b/guide/cluster/computing.md
index 652427c..5f22ecf 100644
--- a/guide/cluster/computing.md
+++ b/guide/cluster/computing.md
@@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 管理 Kubernetes 计算节点
+---
+
# 计算资源管理
## 前提
@@ -45,4 +49,4 @@
> kubadm reset
> ```
>
->
\ No newline at end of file
+>
diff --git a/guide/cluster/namespace.md b/guide/cluster/namespace.md
index a718b70..d0d767b 100644
--- a/guide/cluster/namespace.md
+++ b/guide/cluster/namespace.md
@@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 管理 Kubernetes 名称空间。
+---
+
# 名称空间管理
## 创建名称空间
@@ -48,4 +52,4 @@
点击 *example* 名称空间后，可进入该名称空间的页面。刚刚初始化的名称空间的界面布局如下图所示：
-
\ No newline at end of file
+
diff --git a/guide/cluster/storage.md b/guide/cluster/storage.md
index af7f727..8ec9c76 100644
--- a/guide/cluster/storage.md
+++ b/guide/cluster/storage.md
@@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 管理 Kubernetes 存储类 Storage Class
+---
+
# 存储空间管理
## 创建存储类
@@ -137,4 +141,4 @@
此时可在存储资源列表中查看到刚创建的存储类
-
\ No newline at end of file
+
diff --git a/guide/diagonize/events.md b/guide/diagonize/events.md
index 1c88d6a..e6fc312 100644
--- a/guide/diagonize/events.md
+++ b/guide/diagonize/events.md
@@ -1,6 +1,10 @@
+---
+description: 使用 Kuboard 监听 Kubernetes 集群的最新事件，并通过这些事件对 Kubernetes 运行时的问题进行诊断。
+---
+
# 集群事件
-通过观察 KUberetes 集群事件，可以快速诊断部署时发生的问题。
+通过观察 Kuberetes 集群事件，可以快速诊断部署时发生的问题。
Kuboard 建立了与 kubernetes apiserver 的长连接，可以在第一时间将集群中的事件更新以通知的形式显示在 dashboad 上。
@@ -43,4 +47,3 @@ Kuboard 建立了与 kubernetes apiserver 的长连接，可以在第一时间
容器组信息中包含了与该容器组相关的所有集群事件。
-
diff --git a/guide/diagonize/logs.md b/guide/diagonize/logs.md
index 461d61c..dac3232 100644
--- a/guide/diagonize/logs.md
+++ b/guide/diagonize/logs.md
@@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 打开并跟踪容器组的最新日志，以便对 Kubernetes 上容器组的最新运行情况进行了解和诊断问题。
+---
+
# 日志及终端
@@ -32,4 +36,3 @@
> * vi 命令，临时修改容器内应用程序的配置，并在容器内重启应用程序，以临时性的尝试修复问题，如果有效再将修改更新到应用程序代码或者 Dockerfile
-
diff --git a/guide/diagonize/port-forward.md b/guide/diagonize/port-forward.md
index a3938f4..430acd5 100644
--- a/guide/diagonize/port-forward.md
+++ b/guide/diagonize/port-forward.md
@@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 对 Kubernetes 上容器组的端口进行转发。
+---
+
# 端口转发
微服务环境中，各个服务都通过 TCP / UDP 端口的形式提供访问。按调用者所在位置、通信协议的形式来划分，大致有如下几种情况：
@@ -24,4 +28,3 @@
Kuboard 计划实现类似 kubectl port-forward 的功能，提高问题诊断过程中的便利性。
-
diff --git a/guide/example/busybox.md b/guide/example/busybox.md
index 83e77da..52baecd 100644
--- a/guide/example/busybox.md
+++ b/guide/example/busybox.md
@@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 向 Kubernetes 部署一个最简单的 Deployment
+---
+
# 部署 busybox
## 前提
@@ -100,4 +104,3 @@ Busybox 是一个非常小巧（不到5M）的容器，此处用它来展示如
输入 *export* 并回车后，可查看该容器当前的环境变量。您也可以在终端中执行任何容器内部的命令。在您完成容器的部署之后，终端界面是非常有效的问题诊断工具之一。
-
diff --git a/guide/example/import.md b/guide/example/import.md
index b88dc85..b1527f0 100644
--- a/guide/example/import.md
+++ b/guide/example/import.md
@@ -1,3 +1,7 @@
+---
+description: 通过 Kuboard 将一个预先定义好的 Spring Cloud 微服务样例程序导入到 Kubernetes 中。
+---
+
# 导入 example 微服务
## 前提
@@ -148,4 +152,3 @@ example中用到了存储卷声明，请在 Kuboard 中 [创建存储类](/guide
> ```
>
>
-
diff --git a/guide/example/monitor.md b/guide/example/monitor.md
index 0971807..04ca7d7 100644
--- a/guide/example/monitor.md
+++ b/guide/example/monitor.md
@@ -1,4 +1,6 @@
-
+---
+description: 使用 Kuboard 在 Kubernetes 上安装监控套件，并对 example 微服务实现资源层监控、中间件层监控、链路追踪和 APM 监控
+---
# 监控 example
@@ -212,4 +214,4 @@ kubectl -n kube-system create secret generic etcd-certs --from-file=/etc/kuberne
-
\ No newline at end of file
+
diff --git a/guide/monitor/README.md b/guide/monitor/README.md
index 26f92d2..dbc9073 100644
--- a/guide/monitor/README.md
+++ b/guide/monitor/README.md
@@ -1,6 +1,10 @@
+---
+description: Kubernetes 监控套件
+---
+
# 监控套件
文档建设中...
> * 请参考 [监控 example](/guide/example/monitor.html) 体验 Kuboard 在监控套件方面的设想
-> * 监控套件以插件的形式整合到 Kuboard，在不使用监控套件的情况下，Kuboard 的所有功能都可正常工作
\ No newline at end of file
+> * 监控套件以插件的形式整合到 Kuboard，在不使用监控套件的情况下，Kuboard 的所有功能都可正常工作
diff --git a/guide/monitor/apis.md b/guide/monitor/apis.md
index 7215929..39bb381 100644
--- a/guide/monitor/apis.md
+++ b/guide/monitor/apis.md
@@ -1,6 +1,10 @@
+---
+description: 如何基于 Kuboard API 实现自定义的 Kubernetes 监控套件
+---
+
# 自定义监控套件
文档建设中...
> * 请参考 [监控 example](/guide/example/monitor.html) 体验 Kuboard 在监控套件方面的设想
-> * 监控套件以插件的形式整合到 Kuboard，在不使用监控套件的情况下，Kuboard 的所有功能都可正常工作
\ No newline at end of file
+> * 监控套件以插件的形式整合到 Kuboard，在不使用监控套件的情况下，Kuboard 的所有功能都可正常工作
diff --git a/guide/namespace/adjustion.md b/guide/namespace/adjustion.md
index a045ec3..9fc1e2b 100644
--- a/guide/namespace/adjustion.md
+++ b/guide/namespace/adjustion.md
@@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 对 Kubernetes 进行日常调整，包括：批量删除容器组、批量调整镜像版本、批量调整工作负载数
+---
+
# 日常调整
@@ -117,4 +121,3 @@
***调整容器镜像版本*** 的功能界面中，也可以用来调整工作负载的副本数，如下图所示：
-
diff --git a/guide/namespace/configMap.md b/guide/namespace/configMap.md
index 72e75e3..2ef557d 100644
--- a/guide/namespace/configMap.md
+++ b/guide/namespace/configMap.md
@@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 配置 Kubernetes ConfigMap
+---
+
# 配置
配置： Kubernetes ConfigMap
@@ -44,4 +48,4 @@
-编辑、删除操作可直接按照提示完成
\ No newline at end of file
+编辑、删除操作可直接按照提示完成
diff --git a/guide/namespace/multi-env.md b/guide/namespace/multi-env.md
index 55915c6..0f7b3f8 100644
--- a/guide/namespace/multi-env.md
+++ b/guide/namespace/multi-env.md
@@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 将 Kubernetes 名称空间中安装的应用程序配置导出成 YAML 文件，并在一个新的环境中导入。
+---
+
# 多环境
在实际开发项目的过程中，我们必然会碰到如下场景：
@@ -108,5 +112,3 @@ Kuboard 针对这种场景，提供了导出配置、导入配置的功能，以
### 操作步骤
请参考 [导入 example 微服务](/guide/example/import)
-
-
diff --git a/guide/namespace/pvc.md b/guide/namespace/pvc.md
index cc36af0..112da67 100644
--- a/guide/namespace/pvc.md
+++ b/guide/namespace/pvc.md
@@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 配置 Kubernetes 的存储卷声明 Persistent Volume Claim
+---
+
# 存储卷声明
存储卷声明： Kubernetes Persistent Volume Claim
@@ -48,4 +52,4 @@
-编辑、删除操作可直接按照提示完成
\ No newline at end of file
+编辑、删除操作可直接按照提示完成
diff --git a/guide/namespace/secrets.md b/guide/namespace/secrets.md
index 31d2c82..5d59403 100644
--- a/guide/namespace/secrets.md
+++ b/guide/namespace/secrets.md
@@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 配置 Kubernetes Secrets
+---
+
# Secrets
@@ -53,4 +57,4 @@ Secrets 列表位于图中左上角，点击 ***放大*** 按钮，可以将列
-编辑、删除操作可直接按照提示完成
\ No newline at end of file
+编辑、删除操作可直接按照提示完成
diff --git a/guide/namespace/workload.md b/guide/namespace/workload.md
index a50625d..613c47f 100644
--- a/guide/namespace/workload.md
+++ b/guide/namespace/workload.md
@@ -1,3 +1,7 @@
+---
+description: Kuboard on Kubernetes 工作负载编辑器，无需编写 YAML 文件即可完成 Kubernetes 配置和管理。
+---
+
# 工作负载
@@ -128,4 +132,3 @@
* 通过 ls / cat / vi 等命令，查看该容器是否包含了最新的代码变更
* 通过 vi 等命令，临时对容器中的配置文件进行修改，并在验证这种修改有效之后，才将其正式更新到代码库
-
diff --git a/install/faq/timeout.md b/install/faq/timeout.md
index 812e232..a1c42b0 100644
--- a/install/faq/timeout.md
+++ b/install/faq/timeout.md
@@ -1,3 +1,7 @@
+---
+description: Kuboard 相关常见问题的诊断及解决。
+---
+
# 输入 Token 后提示 timeout
## 错误描述
@@ -63,4 +67,3 @@ sysctl -p
* 在每一个节点上（包括Master、Worker）补充执行上述步骤，然后重新启动节点机器。
* 或者按照 [安装 Kubernetes 单Master节点](install) 的描述重新安装集群
-
diff --git a/install/history-k8s/install-k8s-1.15.1.md b/install/history-k8s/install-k8s-1.15.1.md
index 302a125..bcbed69 100644
--- a/install/history-k8s/install-k8s-1.15.1.md
+++ b/install/history-k8s/install-k8s-1.15.1.md
@@ -1,3 +1,7 @@
+---
+description: 使用 kubeadm 安装 Kubernetes v1.15.1 的集群，单Master节点。
+---
+
# 最值得参考的 Kubernetes 安装文档在这里
## 文档特点
diff --git a/install/install-dashboard-upgrade.md b/install/install-dashboard-upgrade.md
index c931747..f2b92e3 100644
--- a/install/install-dashboard-upgrade.md
+++ b/install/install-dashboard-upgrade.md
@@ -1,12 +1,16 @@
+---
+description: 详细介绍如何将 Kuboard 升级到最新版本。
+---
+
# 升级 Kuboard
## 最新版本
-稳定版： latest, v1.0.0
-发布日期： 2019-08-11
+稳定版： latest, v1.0.1
+发布日期： 2019-08-20
-测试版： v1.0.1-beta.3
-发布日期： 2019-08-18
+测试版： v1.0.2-beta.2
+发布日期： 2019-08-24
[查看更新日志](/overview/change-log.html)
diff --git a/install/install-dashboard.md b/install/install-dashboard.md
index 6d9a28a..3aa0fae 100644
--- a/install/install-dashboard.md
+++ b/install/install-dashboard.md
@@ -1,3 +1,7 @@
+---
+description: Kuboard 的安装手册，包括安装 Kuboard 的前提条件、与 Kubernetes 的版本兼容性、安装步骤、以及完成安装后如何访问 Kuboard 界面。
+---
+
# 安装 Kuboard
## 前提
diff --git a/install/install-k8s.md b/install/install-k8s.md
index 2e43df7..075875f 100644
--- a/install/install-k8s.md
+++ b/install/install-k8s.md
@@ -1,4 +1,8 @@
-# 使用 kubeadm 安装 Kubernetes v1.15.2
+---
+description: Kubernetes 最新稳定版 v1.15.2 的快速安装文档。该文档由众多网友验证并在线提出修改意见、持续不断地更新和完善、并且通过 QQ 群提供免费在线答疑的服务。
+---
+
+# 最值得参考的 Kubernetes 安装文档在这里
## 文档特点
diff --git a/install/install-kubectl.md b/install/install-kubectl.md
index 42995a9..9bb5780 100644
--- a/install/install-kubectl.md
+++ b/install/install-kubectl.md
@@ -1,6 +1,10 @@
+---
+description: 日常工作中，您可能需要在自己的笔记本电脑上执行 kubectl 命令以管理远程 Linux 服务器上的 Kubernetes 集群。本文档介绍了如何在您的笔记本电脑上安装和配置 kubectl 工具。
+---
+
# 从客户端电脑远程管理 Kubernetes
-日常工作中，您可能需要在自己的笔记本电脑上执行 kubectl 命令管理远程 Linux 服务器上的 Kubernetes 集群。
+日常工作中，您可能需要在自己的笔记本电脑上执行 kubectl 命令以管理远程 Linux 服务器上的 Kubernetes 集群。
::: tip
从客户端电脑使用 kubectl 远程管理 Kubernetes，这个步骤并不是使用 Kuboard 的必要步骤。可以忽略
@@ -135,4 +139,4 @@ kubectl get pods -n kube-system
## kubectl 参考文档推荐
-[https://kubernetes.io/docs/reference/kubectl/overview/](https://kubernetes.io/docs/reference/kubectl/overview/)
\ No newline at end of file
+[https://kubernetes.io/docs/reference/kubectl/overview/](https://kubernetes.io/docs/reference/kubectl/overview/)
diff --git a/install/install-kubernetes.md b/install/install-kubernetes.md
index bc60b4f..b42861a 100644
--- a/install/install-kubernetes.md
+++ b/install/install-kubernetes.md
@@ -1,3 +1,7 @@
+---
+description: 使用 kubeadm 安装高可用的 Kubernetes v1.15.2 集群
+---
+
# 安装 Kubernetes 高可用
::: tip
diff --git a/micro-service/spring-cloud/README.md b/micro-service/spring-cloud/README.md
index 5891e5b..3a8488a 100644
--- a/micro-service/spring-cloud/README.md
+++ b/micro-service/spring-cloud/README.md
@@ -1,3 +1,7 @@
+---
+description: 微服务参考架构：包含微服务运行时、构建及测试、部署及运维、监控及评估。设计和研发 Kuboard 的初心便源于此 Spring Cloud 微服务参考架构。
+---
+
# Spring Cloud on Kubernetes
下图是作者在落地 Spring Cloud 微架构的过程中，设计了如下图所示的微服务参考架构，设计和研发 Kuboard 的初心便源于此图。历时两年时间，Kuboard终于发布，也标志着该参考架构的成熟可用。该参考架构主要包括四个重要组成部分：
@@ -41,4 +45,4 @@ Spring Cloud on Kubernetes 并不对 Spring Cloud 架构、组件等做过多解
-
\ No newline at end of file
+
diff --git a/micro-service/spring-cloud/cloud-eureka.md b/micro-service/spring-cloud/cloud-eureka.md
index 6dd90e2..2aaf06e 100644
--- a/micro-service/spring-cloud/cloud-eureka.md
+++ b/micro-service/spring-cloud/cloud-eureka.md
@@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 在 Kubernetes 上部署 spring cloud 服务注册发现组件 eureka。
+---
+
# 部署 cloud-eureka
本文所使用的代码请参考 [cloud-eureka](https://github.com/eip-work/kuboard-example/tree/master/cloud-eureka)
@@ -129,6 +133,3 @@ Eureka 运行在 9200 端口。Spring Cloud 的微服务组件通过 CLOUD_EUREK
## 检查部署结果
**查看 Eureka 界面**
-
-
-
diff --git a/micro-service/spring-cloud/db-example.md b/micro-service/spring-cloud/db-example.md
index 001976a..cf05625 100644
--- a/micro-service/spring-cloud/db-example.md
+++ b/micro-service/spring-cloud/db-example.md
@@ -1,3 +1,7 @@
+---
+description: 在 Kubernetes 上部署测试数据库 mysql 的详细介绍。
+---
+
# 部署 db-example
本文所使用的代码请参考 [db-example](https://github.com/eip-work/kuboard-example/tree/master/db-example)
@@ -84,8 +88,3 @@ Dockerfile 中定义了环境变量 ENABLE_EUREKA_CLIENT=TRUE，这个环境变
## 检查部署结果
-
-
-
-
-
diff --git a/overview/README.md b/overview/README.md
index af59e1d..e57a7d0 100644
--- a/overview/README.md
+++ b/overview/README.md
@@ -1,3 +1,7 @@
+---
+description: 介绍 Kuboard - Kubernetes 微服务管理界面，并为 Kubernetes 初学者提供快速的学习路线（含 Kubernetes v1.15.2 安装文档）
+---
+
## Kuboard 简介
A cool Kubernetes dashboard.
diff --git a/overview/change-log.md b/overview/change-log.md
index 1e3d9fd..b3db436 100644
--- a/overview/change-log.md
+++ b/overview/change-log.md
@@ -1,3 +1,7 @@
+---
+description: Kuboard 更新日志的详细信息
+---
+
# 更新日志
## v1.0.2-beta.2
diff --git a/overview/concepts.md b/overview/concepts.md
index 3ade7f6..0664917 100644
--- a/overview/concepts.md
+++ b/overview/concepts.md
@@ -1,3 +1,7 @@
+---
+description: Kuboard 通过图形化操作界面以及无YAML操作，帮助降低 Kubernetes 学习门槛。
+---
+
# 如何降低 Kubernetes 学习门槛
## Kubernetes 学习门槛在哪儿
@@ -197,4 +201,3 @@ Kuborad中，定义容器的界面如下图所示：
-
diff --git a/overview/k8s-core-concepts.md b/overview/k8s-core-concepts.md
index 3efb764..011109a 100644
--- a/overview/k8s-core-concepts.md
+++ b/overview/k8s-core-concepts.md
@@ -1,3 +1,7 @@
+---
+description: 以 gif 动图的形式形象的描述 Kubernetes 核心概念。本文将会简单介绍Kubernetes的核心概念。因为这些定义可以在Kubernetes的文档中找到，所以文章也会避免用大段的枯燥的文字介绍。相反，我们会使用一些图表（其中一些是动画）和示例来解释这些概念。我们发现一些概念（比如Service）如果没有图表的辅助就很难全面地理解。在合适的地方我们也会提供Kubernetes文档的链接以便读者深入学习。
+---
+
# 十分钟带你理解Kubernetes核心概念
> 转载信息：
@@ -101,5 +105,3 @@ Replication Controller确保任意时间都有指定数量的Pod“副本”在
### Kubernetes Master
集群拥有一个Kubernetes Master（紫色方框）。Kubernetes Master提供集群的独特视角，并且拥有一系列组件，比如Kubernetes API Server。API Server提供可以用来和集群交互的REST端点。master节点包括用来创建和复制Pod的Replication Controller。
-
-
diff --git a/overview/quick-win.md b/overview/quick-win.md
index 3f14362..0ab6fea 100644
--- a/overview/quick-win.md
+++ b/overview/quick-win.md
@@ -1,3 +1,7 @@
+---
+description: Kuboard 提供 Kubernetes 图形化管理界面、Kubernetes最新版本安装手册、Spring Cloud 微服务部署实战案例、免费自助无需商务谈判，帮助用户快速落地 Kubernetes。
+---
+
# 最快速的 Kubernetes+微服务 落地方案
## Kubernetes 落地难
@@ -59,4 +63,4 @@ Kuboard 团队的盈利方式是为企业提供业务、IT咨询和定制化开
商务联系请表明您的意图：
-
\ No newline at end of file
+
diff --git a/overview/support.md b/overview/support.md
index bd61311..d98fbfa 100644
--- a/overview/support.md
+++ b/overview/support.md
@@ -1,3 +1,7 @@
+---
+description: 如何获得 Kuboard 相关的支持和帮助？
+---
+
# 支持
diff --git a/overview/why-kuboard.md b/overview/why-kuboard.md
index d3f6a4e..0636497 100644
--- a/overview/why-kuboard.md
+++ b/overview/why-kuboard.md
@@ -1,3 +1,7 @@
+---
+description: Kubernetes 已然是当下容器编排领域事实上的标准，各大云服务商都急于推出 Kubernetes 服务，互联网公司也纷纷跟进，将自己的应用容器化，并使用 Kubernetes 编排。在 Kubernetes 图形化工具方面，我们已经获得了极大的可选择空间。什么场景下更适合选择 Kuboard 呢？
+---
+
## 为什么选择 Kuboard
Kubernetes 已然是当下容器编排领域事实上的标准，各大云服务商都急于推出 Kubernetes 服务，互联网公司也纷纷跟进，将自己的应用容器化，并使用 Kubernetes 编排。
@@ -93,4 +97,4 @@ Kuboard 官网 http://kuboard.cn
Kuboard QQ 群
-
\ No newline at end of file
+