introduction

2020-06-14 22:59:53 +08:00
parent 5746391700
commit f37731549a
5 changed files with 213 additions and 2 deletions
--- a/.vuepress/config-sidebar-guide.js
+++ b/.vuepress/config-sidebar-guide.js
@ -0,0 +1,20 @@
+module.exports = {
+  '/guide-v2/' : [
+    {
+      title: '概述',
+      collapsable: true,
+      children: [
+        ['', '快速搭建云原生平台']
+      ]
+    },
+    {
+      title: 'Example',
+      collapsable: true,
+      children: [
+        'example/busybox',
+        'example/import',
+        'example/monitor-v2',
+      ]
+    },
+  ]
+}
--- a/.vuepress/config-sidebar.js
+++ b/.vuepress/config-sidebar.js
@ -1,4 +1,4 @@
-module.exports = {
+let sidebar = {
  '/overview/': [
    {
      title: '简介',
@ -654,3 +654,11 @@ module.exports = {
  ],

 }
+
+if (process.env.NODE_ENV === 'development') {
+  let guideV2 = require('./config-sidebar-guide.js')
+  
+  sidebar = Object.assign(sidebar, guideV2)
+}
+
+module.exports = sidebar
--- a/guide-v2/README.md
+++ b/guide-v2/README.md
@ -7,7 +7,9 @@ description: 搭建一个基于Kubernetes的私有化云平台

 <AdSenseTitle/>

-# 安装 Kuboard
+大量的企业已经开始将应用向云原生迁移，本文描述了一种方案，可以帮助企业以最低的成本快速搭建基于 Kubernetes 的云原生应用环境，并展示了如何在其中部署、诊断、运维微服务应用。
+
+## 参考架构

 ## Kuboard 介绍

--- a/guide-v2/introduction.md
+++ b/guide-v2/introduction.md
@ -0,0 +1,150 @@
+---
+lessAds: true
+vssueId: 71
+description: 搭建一个基于Kubernetes的私有化云平台
+---
+
+# 比 Kubernetes Dashboard 更好用的管理工具 - Kuboard
+
+## Kuboard 介绍
+
+![Kuboard-HomePage](/images/preview.png)
+
+Kuboard 是一款免费的 Kubernetes 管理工具，提供了丰富的功能，结合代码仓库、镜像仓库、CI/CD工具等，可以便捷的搭建一个生产可用的 Kubernetes 容器云平台，轻松管理和运行云原生应用。Kuboard 提供的功能有：
+
+* Kubernetes 基本管理功能
+  * 节点管理
+  * 名称空间管理
+  * 存储类/存储卷管理
+  * 控制器（Deployment/StatefulSet/DaemonSet/CronJob/Job/ReplicaSet）管理
+  * Service/Ingress 管理
+  * ConfigMap/Secret 管理
+  * CustomerResourceDefinition 管理
+* Kubernetes 问题诊断
+  * Top Nodes / Top Pods
+  * 事件列表及通知
+  * 容器日志及终端
+  * KuboardProxy (kubectl proxy 的在线版本)
+  * PortForward (kubectl port-forward 的快捷版本)
+  * 复制文件 （kubectl cp 的在线版本）
+* 认证与授权
+  * Github/GitLab 单点登录
+  * KeyCloak 认证
+  * LDAP 认证
+  * 完整的 RBAC 权限管理
+* Kuboard 特色功能
+  * Kuboard 官方套件
+    * Grafana+Prometheus 资源监控
+    * Grafana+Loki+Promtail 日志聚合
+  * Kuboard 自定义名称空间布局
+  * Kuboard 中英文语言包
+
+## 活跃的社群
+
+自2019年8月发布以来，随着 Kuboard 功能的日益完善，Kuboard 已经获得 <StarCount></StarCount> 和 <StarCountDockerPulls></StarCountDockerPulls>。上百家公司正式将 Kuboard 用于生产环境，社群人数 5000 人，Kuboard 相关问题可以第一时间获得社群的帮助以及 Kuboard 开发团队的解答。
+
+Kuboard 开发团队平均一周发布一次版本更新，以最快的速度解决社群用户反馈的问题，并将用户的意见和建议加入到新的版本中。
+* [Kuboard 1.0.x 更新日志](/support/v1.0.x)
+* [Kuboard 2.0.x 更新日志](/support/v2.0.x)
+
+<div style="padding: 1rem 0 0 0;" data-aos="fade-up" data-aos-duration="1500">
+<grid :rwd="{compact: 'stack'}">
+<grid-item size="2/3" :rwd="{tablet: '1/1', compact: '1/1'}">
+<b-card style="height: calc(100% - 2rem); margin-top: 1rem;">
+  <a href="https://starchart.cc/eip-work/kuboard-press" target="_blank">
+    <img src="https://starchart.cc/eip-work/kuboard-press.svg" alt="Kubernetes教程_Kuboard_Github_Star" style="height: 320px;">
+  </a>
+
+</b-card>
+</grid-item>
+  <grid-item size="1/3" :rwd="{tablet: '1/1', compact: '1/1'}">
+    <b-card style="height: calc(100% - 2rem); color: #2c3e50; line-height: 1.7; margin-top: 1rem;">
+        <li>
+          Kuboard 于2019年8月初公开发布，当前：
+          <li style="margin-left: 40px;">
+            <StarCount></StarCount>
+          </li>
+          <li style="margin-left: 40px;">
+            <StarCountDockerPulls></StarCountDockerPulls>
+          </li>
+        </li>
+        <li>参考 kuboard.cn，通常一个月时间可以从 Kubernetes 入门到投产</li>
+      </b-card>
+  </grid-item>
+</grid>
+</div>
+
+## 安装前提
+
+Kuboard 只依赖于 Kubernetes API，您可以在多种情况下使用 Kuboard：
+* 使用 kubeadm 安装的 Kubernetes 集群
+* 使用二进制方式安装的 Kubernetes 集群
+* 阿里云/腾讯云等云供应商托管的 Kubernetes 集群
+
+Kuboard 对 Kubernetes 的版本兼容性，如下表所示：
+
+| Kubernetes 版本 | Kuboard 版本   | 兼容性 | 说明                                                         |
+| --------------- | -------------- | ------ | ------------------------------------------------------------ |
+| v1.18           | v1.0.x， v2.0.x | <span style="font-size: 24px;">😄</span>      | 已验证                            |
+| v1.17           | v1.0.x， v2.0.x | <span style="font-size: 24px;">😄</span>      | 已验证                            |
+| v1.16           | v1.0.x， v2.0.x | <span style="font-size: 24px;">😄</span>      | 已验证                            |
+| v1.15           | v1.0.x， v2.0.x | <span style="font-size: 24px;">😄</span>      | 已验证                            |
+| v1.14           | v1.0.x， v2.0.x | <span style="font-size: 24px;">😄</span>      | 已验证                            |
+| v1.13           | v1.0.x， v2.0.x | <span style="font-size: 24px;">😄</span>      | 已验证                       |
+| v1.12           | v1.0.x， v2.0.x | <span style="font-size: 24px;">😐</span>      | Kubernetes Api v1.12 不支持 dryRun，<br />Kuboard 不支持 Kubernetes v1.12 |
+| v1.11           | v1.0.x， v2.0.x | <span style="font-size: 24px;">😐</span>      | Kuboard 不支持 Kubernetes v1.11                                                         |
+
+
+## 安装
+
+### 安装 Kuboard。
+
+``` sh
+kubectl apply -f https://kuboard.cn/install-script/kuboard.yaml
+kubectl apply -f https://addons.kuboard.cn/metrics-server/0.3.6/metrics-server.yaml
+```
+
+### 卸载 Kuboard
+
+``` sh
+kubectl delete -f https://kuboard.cn/install-script/kuboard.yaml
+kubectl delete -f https://addons.kuboard.cn/metrics-server/0.3.6/metrics-server.yaml
+```
+
+## 获取 Token
+
+您可以获得管理员用户、只读用户的Token
+
+### 管理员用户
+
+**拥有的权限**
+
+* 此Token拥有 ClusterAdmin 的权限，可以执行所有操作
+
+**执行命令**
+
+```bash
+echo $(kubectl -n kube-system get secret $(kubectl -n kube-system get secret | grep kuboard-user | awk '{print $1}') -o go-template='{{.data.token}}' | base64 -d)  
+```
+
+**输出**
+
+取输出信息中 token 字段
+```{13}
+eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJrdWJlLXN5c3RlbSIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJhZG1pbi11c2VyLXRva2VuLWc4aHhiIiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQubmFtZSI6ImFkbWluLXVzZXIiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC51aWQiOiI5NDhiYjVlNi04Y2RjLTExZTktYjY3ZS1mYTE2M2U1ZjdhMGYiLCJzdWIiOiJzeXN0ZW06c2VydmljZWFjY291bnQ6a3ViZS1zeXN0ZW06YWRtaW4tdXNlciJ9.DZ6dMTr8GExo5IH_vCWdB_MDfQaNognjfZKl0E5VW8vUFMVvALwo0BS-6Qsqpfxrlz87oE9yGVCpBYV0D00811bLhHIg-IR_MiBneadcqdQ_TGm_a0Pz0RbIzqJlRPiyMSxk1eXhmayfPn01upPdVCQj6D3vAY77dpcGplu3p5wE6vsNWAvrQ2d_V1KhR03IB1jJZkYwrI8FHCq_5YuzkPfHsgZ9MBQgH-jqqNXs6r8aoUZIbLsYcMHkin2vzRsMy_tjMCI9yXGiOqI-E5efTb-_KbDVwV5cbdqEIegdtYZ2J3mlrFQlmPGYTwFI8Ba9LleSYbCi4o0k74568KcN_w
+```
+
+
+## 访问 Kuboard
+
+您可以通过NodePort、port-forward 两种方式当中的任意一种访问 Kuboard
+
+### 通过NodePort访问
+
+Kuboard Service 使用了 NodePort 的方式暴露服务，NodePort 为 32567；您可以按如下方式访问 Kuboard。
+
+`
+http://任意一个Worker节点的IP地址:32567/
+`
+
+输入前一步骤中获得的 token，可进入 **Kubernetes 集群概览**
--- a/support/index.md
+++ b/support/index.md
@ -48,6 +48,37 @@ export default {

 <!-- <KuboardLiscense></KuboardLiscense> -->

+## Kuboard 介绍
+
+Kuboard 是一款免费的 Kubernetes 管理工具，提供了丰富的功能，结合已有或新建的代码仓库、镜像仓库、CI/CD工具等，可以便捷的搭建一个生产可用的 Kubernetes 容器云平台，轻松管理和运行云原生应用。您也可以直接将 Kuboard 安装到现有的 Kubernetes 集群，通过 Kuboard 提供的 Kubernetes RBAC 管理界面，将 Kubernetes 提供的能力开放给您的开发团队。Kuboard 提供的功能有：
+
+* Kubernetes 基本管理功能
+  * 节点管理
+  * 名称空间管理
+  * 存储类/存储卷管理
+  * 控制器（Deployment/StatefulSet/DaemonSet/CronJob/Job/ReplicaSet）管理
+  * Service/Ingress 管理
+  * ConfigMap/Secret 管理
+  * CustomerResourceDefinition 管理
+* Kubernetes 问题诊断
+  * Top Nodes / Top Pods
+  * 事件列表及通知
+  * 容器日志及终端
+  * KuboardProxy (kubectl proxy 的在线版本)
+  * PortForward (kubectl port-forward 的快捷版本)
+  * 复制文件 （kubectl cp 的在线版本）
+* 认证与授权
+  * Github/GitLab 单点登录
+  * KeyCloak 认证
+  * LDAP 认证
+  * 完整的 RBAC 权限管理
+* Kuboard 特色功能
+  * Kuboard 官方套件
+    * Grafana+Prometheus 资源监控
+    * Grafana+Loki+Promtail 日志聚合
+  * Kuboard 自定义名称空间布局
+  * Kuboard 中英文语言包
+
 ## Github Star

 <div style="padding: 1rem 0 0 0;" data-aos="fade-up" data-aos-duration="1500">