kuboard-v2.0.0-beta.3

guide/example/import.md

@@ -11,7 +11,7 @@ description: 通过Kuboard将一个预先定义好的SpringCloud微服务样例
 
 必须具备如下条件：
 
-* Kubernetes 集群 （安装在阿里云，本文将使用阿里云的 NFS 服务作为存储资源，Kuboard 也可以运行在其他云环境或者私有环境中。）
+* Kubernetes 集群
 * 导入 example 微服务时，要求 Kubernetes 集群版本不低于 1.14.0 <Badge type="error">重要</Badge>
 * 已在集群中安装 Kuboard
 

guide/example/monitor-v2.md

@@ -0,0 +1,129 @@
+---
+vssueId: 77
+description: 使用Kuboard在Kubernetes上安装监控套件，并对example微服务实现资源层监控、中间件层监控、链路追踪和APM监控
+---
+
+# 监控 example
+
+<AdSenseTitle/>
+
+## 前提
+
+必须具备如下条件：
+
+* 已完成 [导入 example 微服务](/guide/example/import.html)
+* 已配置了 NFS [StorageClass](/learning/k8s-intermediate/persistent/storage-class.html)
+* 使用 kuboard-user 这个 ServiceAccount 登录 Kuboard 界面，[kuboard-user](/install/install-dashboard.html#获取token)
+
+## 安装监控套件
+
+* 进入 Kuboard 界面后，点击右上角的 **设置** 按钮（圆形图标），然后在左侧菜单中导航到 **Kuboard** --> **套件**，如下图所示：
+
+  ![image-20200531101355671](./monitor-v2.assets/image-20200531101355671.png)
+
+* 点击图中的 **查找并安装** 按钮；
+
+  可以查询到当前套件仓库中的可选套件，如下图所示：
+
+  > 当前只提供了全局资源层监控套件，后续将逐渐提供更丰富的套件功能。
+
+  ![image-20200531101454954](./monitor-v2.assets/image-20200531101454954.png)
+
+* 点击所选择套件对应的 **安装** 按钮，可将套件所需资源从仓库中加载到您自己的 Kubernetes 集群，并进入该套件的详情页面，如下图所示：
+
+  * 点击下图中的 **开始安装之前，请点我，阅读此套件的文档** 可以了解该套件提供的文档描述；
+
+  ![image-20200531101804604](./monitor-v2.assets/image-20200531101804604.png)
+
+* 点击 **套件参数** Tab 页
+
+  * 在 **套件参数** Tab 页中，调整参数；
+  * 按照 **额外步骤** 的提示，执行安装前的必须动作，并勾选 **确认已完成** 按钮
+  * 点击 **保存** 按钮
+
+  如下图所示：
+
+  ![image-20200531102323613](./monitor-v2.assets/image-20200531102323613.png)
+
+* 在 **套件参数** 页完成保存后，将自动进入 **安装脚本** 页，如下图所示：
+
+  ![image-20200531102446321](./monitor-v2.assets/image-20200531102446321.png)
+
+* 点击 **安装** 按钮，进入 **工作负载导入** 界面，将套件所需的 Deployment/Service/ClusterRole 等对象导入到您的 Kubernetes 集群中，如下图所示：
+
+  ![image-20200531102647083](./monitor-v2.assets/image-20200531102647083.png)
+
+* 请按向导提示，完成套件所依赖对象的导入；
+
+  > * 本文不详细描述此导入过程，请在向导的引导下完成。
+  > * 关于第五步，调整存储卷参数，特别说明如下：
+  >   * 建议为 monitor-grafana / monitor-prometheus 分别创建新的存储卷声明，需要您事先已经创建好了 [StorageClass](/guide/cluster/storage.html) ；
+  >   * 如果您当前没有合适的存储类，为了测试套件的功能，也可以先选择 **emptyDir**，之后再设置合适的存储卷（此时，容器组被删除后，所有的监控数据将丢失）；
+
+  ![image-20200531103006378](./monitor-v2.assets/image-20200531103006378.png)
+
+* 完成工作负载导入后，Kuboard 将自动进入套件的 **初始化** 页面，如下图所示：
+
+  * **初始化** 页面将检测所依赖工作负载的就绪情况，如下图所示：
+
+    ![image-20200531114349178](./monitor-v2.assets/image-20200531114349178.png)
+
+  * 所有被依赖的工作负载就绪之后，将展示初始化时所引用的资源，如下图所示：
+
+    ![image-20200531114628628](./monitor-v2.assets/image-20200531114628628.png)
+
+* 点击 **初始化** 页面中的 **执行初始化** 按钮，Kuboard 将完成对 Grafana 的初始化动作，如下图所示：
+
+  ![image-20200531114818385](./monitor-v2.assets/image-20200531114818385.png)
+
+* 点击 **确定** 后，套件详情页将展示该套件支持的 **扩展** 信息，如下图所示：
+
+  ![image-20200531115010561](./monitor-v2.assets/image-20200531115010561.png)
+
+## 查看监控信息
+
+完成此套件安装后，将在 Kuboard 的节点详情页、工作负载详情页显示对应的监控界面入口；
+
+- 节点详情页
+
+  节点详情页增加如下两个监控界面入口：
+
+  - 节点资源监控
+  - 节点监控（含节点上的容器组）
+
+  ![image-20200531115257331](./monitor-v2.assets/image-20200531115257331.png)
+
+- 工作负载详情页
+
+  工作负载详情页增加如下三个监控界面入口：
+
+  - 容器组监控
+  - 所在节点监控
+  - 所在节点监控（含节点上的容器组）
+
+  ![image-20200531115308199](./monitor-v2.assets/image-20200531115308199.png)
+
+## 直接访问 Grafana 界面
+
+您可能想要自己定义 Grafana 的规则，比如告警通知、授权管理等，如果需要以管理员用户登录到 Grafana 界面，请以 kuboard-user 身份登录 Kuboard，并导航到名称空间 kube-system 下的 deployment / monitor-grafana 页面，点击其中的 **代理** 按钮，就可以用管理员身份登录 Grafana 界面，如下图所示：
+
+![image-20200531115904561](./monitor-v2.assets/image-20200531115904561.png)
+
+
+
+关于如何通过 KuboardProxy 访问 Grafana 界面，以及如何实现 Grafana 与 Kuboard 的单点认证，请参考 [KuboardProxy - Auth Proxy](/guide/proxy/auth-proxy.html)
+
+## 开发者模式
+
+在 Kuboard 套件的详情页面，可以点击 **开发者模式** 按钮，此时，您可以修改 Kuboard 套件安装过程的各种脚本，如：
+
+* 增加套件参数
+* 修改 YAML 安装脚本
+* 修改初始化脚本、添加初始化所需资源
+* 添加扩展，修改扩展脚本，实现自定义逻辑
+
+如下图所示：
+
+![image-20200531120441813](./monitor-v2.assets/image-20200531120441813.png)
+
+您还可以将自己的套件提交到套件仓库。

guide/monitor/README.md

@@ -2,32 +2,16 @@
 description: Kuboard中的Kubernetes监控套件
 ---
 
-# 监控套件 <Badge text="alpha" type="warn"/>
+# 监控套件
 
 <AdSenseTitle/>
 
-作者已经在自己的多个项目中使用了监控套件，但是由于在使用时，需要针对具体的项目做少量的定制，因此，监控套件目前还处于 alpha 状态。
-
 监控套件分全局监控套件和局部监控套件两种类型：
 * 全局监控套件
-  * Prometheus + Graphana，可以对 节点、节点上的容器组进行资源层监控：CPU、内存、磁盘、网络等
+  * Prometheus + Graphana，可以对 节点、节点上的容器组进行资源层监控：CPU、内存、磁盘、网络等，请参考 [监控 Example](/guide/example/monitor.html)
 * 局部监控套件
-  * Prometheus监控套件（mysql/nginx/jvm）
+  * Prometheus监控套件（mysql/nginx/jvm）<Badge type="warn">后续提供</Badge>
     * 监控 mysql/nginx/jvm 等
     * 使用 eureka 做服务发现（需要优化，改成使用 kubernetes api object 进行服务发现）
-    * 代码地址： [eip-monitor-prometheus](https://github.com/eip-work/eip-monitor-prometheus.git)
-  * 熔断及限流 Sentinel
-    * 用于 Spring Cloud 的熔断及限流
-    * 代码地址： [eip-monitor-sentinel](https://github.com/eip-work/eip-monitor-sentinel.git)
-  * Pinpoint 监控套件
+  * Pinpoint 监控套件 <Badge type="warn">后续提供</Badge>
     * 用于链路追踪及APM
-    * 代码地址： [eip-monitor-pinpoint](https://github.com/eip-work/eip-monitor-pinpoint.git)
-
-监控套件都使用开源监控软件，作者做监控套件的出发点主要有两个：
-* 简化监控套件的安装和配置
-* 将监控套件的入口嵌入到 Node、Pod、Container 的上下文当中，以便快速的定位到监控信息
-
-如果有同学对这两个设想感兴趣，请加群 808894550 并联系群主。
-
-> * 请参考 [监控 example](/guide/example/monitor.html) <Badge text="alpha" type="warn"/> 体验 Kuboard 在监控套件方面的设想
-> * 监控套件以插件的形式整合到 Kuboard，在不使用监控套件的情况下，Kuboard 的所有功能都可正常工作

guide/port-forward/index.md

@@ -0,0 +1 @@
+# 端口转发