description

2019-08-26 07:53:41 +08:00
parent df984a97a2
commit 0e40713451
38 changed files with 173 additions and 44 deletions
--- a/articles/201908/kuboard-view-of-k8s.md
+++ b/articles/201908/kuboard-view-of-k8s.md
@ -1,3 +1,7 @@
+---
+description: 本文描述了一个经典微服务参考架构，并且通过三个视图（集群概览、名称空间、工作负载）理解微服务与 Kubernetes 的映射关系。
+---
+
 # 从微服务视角看 Kubernetes

 ## 微服务
--- a/devops/README.md
+++ b/devops/README.md
@ -1,3 +1,7 @@
+---
+description: Kubernetes + DevOps 文档
+---
+
 # Kubernetes + DevOps

 如何继承 DevOps ？
@ -6,4 +10,4 @@

 <div>
 <script type='text/javascript' src='https://www.wjx.top/handler/jqemed.ashx?activity=43453748&width=760&source=iframe'></script>
-</div>
+</div>
--- 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)
+* [CIDR to IPv4 Conversion](https://www.ipaddressguide.com/cidr)
--- a/guide/README.md
+++ b/guide/README.md
@ -1,3 +1,7 @@
+---
+description: 熟悉 Kuboard on Kubernetes 的最佳途径。
+---
+
 # 使用手册

 **Kuboard 的设计目标**
--- a/guide/cluster/computing.md
+++ b/guide/cluster/computing.md
@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 管理 Kubernetes 计算节点
+---
+
 # 计算资源管理

 ## 前提
@ -45,4 +49,4 @@
 >   kubadm reset
 >   ```
 >
->   
+>   
--- a/guide/cluster/namespace.md
+++ b/guide/cluster/namespace.md
@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 管理 Kubernetes 名称空间。
+---
+
 # 名称空间管理

 ## 创建名称空间
@ -48,4 +52,4 @@

  点击 *example* 名称空间后，可进入该名称空间的页面。刚刚初始化的名称空间的界面布局如下图所示：

-![image-20190723105830318](./namespace-create.assets/image-20190723105830318.png)
+![image-20190723105830318](./namespace-create.assets/image-20190723105830318.png)
--- a/guide/cluster/storage.md
+++ b/guide/cluster/storage.md
@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 管理 Kubernetes 存储类 Storage Class
+---
+
 # 存储空间管理

 ## 创建存储类
@ -137,4 +141,4 @@

  此时可在存储资源列表中查看到刚创建的存储类

-![image-20190723113312360](./storage-create.assets/image-20190723113312360.png)
+![image-20190723113312360](./storage-create.assets/image-20190723113312360.png)
--- 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 的长连接，可以在第一时间
 容器组信息中包含了与该容器组相关的所有集群事件。

 ![image-20190721103324863](./events.assets/image-20190721103324863.png)
-
--- a/guide/diagonize/logs.md
+++ b/guide/diagonize/logs.md
@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 打开并跟踪容器组的最新日志，以便对 Kubernetes 上容器组的最新运行情况进行了解和诊断问题。
+---
+
 # 日志及终端


@ -32,4 +36,3 @@
  >   * vi 命令，临时修改容器内应用程序的配置，并在容器内重启应用程序，以临时性的尝试修复问题，如果有效再将修改更新到应用程序代码或者 Dockerfile

 ![image-20190721104522870](./logs.assets/image-20190721104522870.png)
-
--- 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 的功能，提高问题诊断过程中的便利性。
-
--- 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* 并回车后，可查看该容器当前的环境变量。您也可以在终端中执行任何容器内部的命令。在您完成容器的部署之后，终端界面是非常有效的问题诊断工具之一。

 ![image-20190723120125425](./busybox.assets/image-20190723120125425.png)
-
--- 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
 > ```
 >
 > 
-
--- a/guide/example/monitor.md
+++ b/guide/example/monitor.md
@ -1,4 +1,6 @@
-
+---
+description: 使用 Kuboard 在 Kubernetes 上安装监控套件，并对 example 微服务实现资源层监控、中间件层监控、链路追踪和 APM 监控
+---

 # 监控 example <Badge text="alpha" type="warn"/>

@ -212,4 +214,4 @@ kubectl -n kube-system create secret generic etcd-certs --from-file=/etc/kuberne



-![image-20190718121133160](./monitor.assets/image-20190718121133160.png)
+![image-20190718121133160](./monitor.assets/image-20190718121133160.png)
--- a/guide/monitor/README.md
+++ b/guide/monitor/README.md
@ -1,6 +1,10 @@
+---
+description: Kubernetes 监控套件
+---
+
 # 监控套件 <Badge text="alpha" type="warn"/>

 文档建设中...

 > * 请参考 [监控 example](/guide/example/monitor.html) <Badge text="alpha" type="warn"/> 体验 Kuboard 在监控套件方面的设想
-> * 监控套件以插件的形式整合到 Kuboard，在不使用监控套件的情况下，Kuboard 的所有功能都可正常工作
+> * 监控套件以插件的形式整合到 Kuboard，在不使用监控套件的情况下，Kuboard 的所有功能都可正常工作
--- a/guide/monitor/apis.md
+++ b/guide/monitor/apis.md
@ -1,6 +1,10 @@
+---
+description: 如何基于 Kuboard API 实现自定义的 Kubernetes 监控套件
+---
+
 # 自定义监控套件 <Badge text="alpha" type="warn"/>

 文档建设中...

 > * 请参考 [监控 example](/guide/example/monitor.html) <Badge text="alpha" type="warn"/> 体验 Kuboard 在监控套件方面的设想
-> * 监控套件以插件的形式整合到 Kuboard，在不使用监控套件的情况下，Kuboard 的所有功能都可正常工作
+> * 监控套件以插件的形式整合到 Kuboard，在不使用监控套件的情况下，Kuboard 的所有功能都可正常工作
--- a/guide/namespace/adjustion.md
+++ b/guide/namespace/adjustion.md
@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 对 Kubernetes 进行日常调整，包括：批量删除容器组、批量调整镜像版本、批量调整工作负载数
+---
+
 # 日常调整


@ -117,4 +121,3 @@
 ***调整容器镜像版本*** 的功能界面中，也可以用来调整工作负载的副本数，如下图所示：

 ![image-20190721100715898](./adjustion.assets/image-20190721100715898.png)
-
--- a/guide/namespace/configMap.md
+++ b/guide/namespace/configMap.md
@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 配置 Kubernetes ConfigMap
+---
+
 # 配置

 配置： Kubernetes ConfigMap
@ -44,4 +48,4 @@

 ![image-20190721113155991](./configMap.assets/image-20190721113155991.png)

-编辑、删除操作可直接按照提示完成
+编辑、删除操作可直接按照提示完成
--- 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)
-
-
--- 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 @@



-编辑、删除操作可直接按照提示完成
+编辑、删除操作可直接按照提示完成
--- a/guide/namespace/secrets.md
+++ b/guide/namespace/secrets.md
@ -1,3 +1,7 @@
+---
+description: 使用 Kuboard 配置 Kubernetes Secrets
+---
+
 # Secrets


@ -53,4 +57,4 @@ Secrets 列表位于图中左上角，点击 ***放大*** 按钮，可以将列



-编辑、删除操作可直接按照提示完成
+编辑、删除操作可直接按照提示完成
--- 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 等命令，临时对容器中的配置文件进行修改，并在验证这种修改有效之后，才将其正式更新到代码库
-
--- 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) 的描述重新安装集群
-
--- 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 安装文档在这里

 ## 文档特点
--- 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)

--- a/install/install-dashboard.md
+++ b/install/install-dashboard.md
@ -1,3 +1,7 @@
+---
+description: Kuboard 的安装手册，包括安装 Kuboard 的前提条件、与 Kubernetes 的版本兼容性、安装步骤、以及完成安装后如何访问 Kuboard 界面。
+---
+
 # 安装 Kuboard

 ## 前提
--- 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 安装文档在这里

 ## 文档特点

--- 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 的必要步骤。<span style="color: red; font-weight: 500;">可以忽略</span>
@ -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/)
+[https://kubernetes.io/docs/reference/kubectl/overview/](https://kubernetes.io/docs/reference/kubectl/overview/)
--- a/install/install-kubernetes.md
+++ b/install/install-kubernetes.md
@ -1,3 +1,7 @@
+---
+description: 使用 kubeadm 安装高可用的 Kubernetes v1.15.2 集群
+---
+
 # 安装 Kubernetes 高可用

 ::: tip
--- 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 架构、组件等做过多解

 <div>
 <script type='text/javascript' src='https://www.wjx.top/handler/jqemed.ashx?activity=43409534&width=760&source=iframe'></script>
-</div>
+</div>
--- 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 界面**
-
-
-
--- 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，这个环境变


 ## 检查部署结果
-
-
-
-
-
--- 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.
--- a/overview/change-log.md
+++ b/overview/change-log.md
@ -1,3 +1,7 @@
+---
+description: Kuboard 更新日志的详细信息
+---
+
 # 更新日志

 ## v1.0.2-beta.2
--- a/overview/concepts.md
+++ b/overview/concepts.md
@ -1,3 +1,7 @@
+---
+description: Kuboard 通过图形化操作界面以及无YAML操作，帮助降低 Kubernetes 学习门槛。
+---
+
 # 如何降低 Kubernetes 学习门槛

 ## Kubernetes 学习门槛在哪儿
@ -197,4 +201,3 @@ Kuborad中，定义容器的界面如下图所示：


 ![image-20190722185113938](./concepts.assets/image-20190722185113938.png)
-
--- 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。
-
-
--- 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咨询和定制化开

 商务联系请表明您的意图：

-![kuboard_qq.png](./quick-win.assets/image-20190731225235232.png)
+![kuboard_qq.png](./quick-win.assets/image-20190731225235232.png)
--- a/overview/support.md
+++ b/overview/support.md
@ -1,3 +1,7 @@
+---
+description: 如何获得 Kuboard 相关的支持和帮助？
+---
+
 # 支持


--- 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 群

-![Kuboard QQ 群](./README.assets/kuboard_qq.png)
+![Kuboard QQ 群](./README.assets/kuboard_qq.png)