From f37731549a9a71948ca2660cb306bf4cc69a5755 Mon Sep 17 00:00:00 2001 From: "huanqing.shao" Date: Sun, 14 Jun 2020 22:59:53 +0800 Subject: [PATCH] introduction --- .vuepress/config-sidebar-guide.js | 20 ++++ .vuepress/config-sidebar.js | 10 +- guide-v2/README.md | 4 +- guide-v2/introduction.md | 150 ++++++++++++++++++++++++++++++ support/index.md | 31 ++++++ 5 files changed, 213 insertions(+), 2 deletions(-) create mode 100644 .vuepress/config-sidebar-guide.js create mode 100644 guide-v2/introduction.md diff --git a/.vuepress/config-sidebar-guide.js b/.vuepress/config-sidebar-guide.js new file mode 100644 index 0000000..be47dd5 --- /dev/null +++ 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', + ] + }, + ] +} diff --git a/.vuepress/config-sidebar.js b/.vuepress/config-sidebar.js index e284b91..b0af673 100644 --- 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 diff --git a/guide-v2/README.md b/guide-v2/README.md index 8649c70..dcc9ffe 100644 --- a/guide-v2/README.md +++ b/guide-v2/README.md @@ -7,7 +7,9 @@ description: 搭建一个基于Kubernetes的私有化云平台 -# 安装 Kuboard +大量的企业已经开始将应用向云原生迁移，本文描述了一种方案，可以帮助企业以最低的成本快速搭建基于 Kubernetes 的云原生应用环境，并展示了如何在其中部署、诊断、运维微服务应用。 + +## 参考架构 ## Kuboard 介绍 diff --git a/guide-v2/introduction.md b/guide-v2/introduction.md new file mode 100644 index 0000000..2fcfc9f --- /dev/null +++ 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 已经获得 和 。上百家公司正式将 Kuboard 用于生产环境，社群人数 5000 人，Kuboard 相关问题可以第一时间获得社群的帮助以及 Kuboard 开发团队的解答。 + +Kuboard 开发团队平均一周发布一次版本更新，以最快的速度解决社群用户反馈的问题，并将用户的意见和建议加入到新的版本中。 +* [Kuboard 1.0.x 更新日志](/support/v1.0.x) +* [Kuboard 2.0.x 更新日志](/support/v2.0.x) + +
+ + + + + Kubernetes教程_Kuboard_Github_Star + + + + + + +
  • + Kuboard 于2019年8月初公开发布，当前： +
  • + +
    • +
  • + +
    • + +
  • 参考 kuboard.cn，通常一个月时间可以从 Kubernetes 入门到投产
    • +     +     +     +
    + +## 安装前提 + +Kuboard 只依赖于 Kubernetes API，您可以在多种情况下使用 Kuboard： +* 使用 kubeadm 安装的 Kubernetes 集群 +* 使用二进制方式安装的 Kubernetes 集群 +* 阿里云/腾讯云等云供应商托管的 Kubernetes 集群 + +Kuboard 对 Kubernetes 的版本兼容性，如下表所示： + +| Kubernetes 版本 | Kuboard 版本 | 兼容性 | 说明 | +| --------------- | -------------- | ------ | ------------------------------------------------------------ | +| v1.18 | v1.0.x， v2.0.x | 😄 | 已验证 | +| v1.17 | v1.0.x， v2.0.x | 😄 | 已验证 | +| v1.16 | v1.0.x， v2.0.x | 😄 | 已验证 | +| v1.15 | v1.0.x， v2.0.x | 😄 | 已验证 | +| v1.14 | v1.0.x， v2.0.x | 😄 | 已验证 | +| v1.13 | v1.0.x， v2.0.x | 😄 | 已验证 | +| v1.12 | v1.0.x， v2.0.x | 😐 | Kubernetes Api v1.12 不支持 dryRun，
    Kuboard 不支持 Kubernetes v1.12 | +| v1.11 | v1.0.x， v2.0.x | 😐 | 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 集群概览** diff --git a/support/index.md b/support/index.md index 155bc50..107082b 100644 --- a/support/index.md +++ b/support/index.md @@ -48,6 +48,37 @@ export default { +## 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