From af95a595012433ba40ec6a708805cc6e26435901 Mon Sep 17 00:00:00 2001 From: "huanqing.shao" Date: Sun, 3 Jan 2021 11:50:58 +0800 Subject: [PATCH] =?UTF-8?q?=E5=8F=AF=E4=BB=A5=E9=83=A8=E7=BD=B2=E5=88=B0?= =?UTF-8?q?=20Kubernetes=20=E9=9B=86=E7=BE=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .vuepress/config-sidebar.js | 2 + install/v3/install-built-in.md | 13 ------- install/v3/install-in-k8s.md | 70 ++++++++++++++++++++++++++++++++++ install/v3/install.md | 28 ++++++++++++++ 4 files changed, 100 insertions(+), 13 deletions(-) create mode 100644 install/v3/install-in-k8s.md create mode 100644 install/v3/install.md diff --git a/.vuepress/config-sidebar.js b/.vuepress/config-sidebar.js index 98fed7b..454617f 100644 --- a/.vuepress/config-sidebar.js +++ b/.vuepress/config-sidebar.js @@ -50,10 +50,12 @@ let sidebar = { title: '安装 Kuboard v3', collapsable: true, children: [ + 'v3/install', 'v3/install-built-in', 'v3/install-gitlab', 'v3/install-github', 'v3/install-ldap', + 'v3/install-in-k8s' ] }, { diff --git a/install/v3/install-built-in.md b/install/v3/install-built-in.md index 238ec89..9e5b7c6 100644 --- a/install/v3/install-built-in.md +++ b/install/v3/install-built-in.md @@ -10,19 +10,6 @@ meta: -## beta 版本说明 - -Kuboard v3.0 支持 Kubernetes 多集群管理。当前为 beta 版本，已经验证了大部分 v2 版本中的功能，有如下功能尚未验证： -* Kuboard PortForward - -Kuboard v3.0 正式发布时间预计在 2021 年元旦节前后。 - -如果您从 Kuboard v1.0.x 或者 Kuboard v2.0.x 升级到 Kuboard，请注意： -* 您可以同时使用 Kuboard v3.0.x 和 Kuboard v2.0.x； -* Kuboard v3.0.x 在正式发布时，考虑将 Kuboard 相关的所有组件从 kube-system 名称空间迁移到 kuboard 名称空间； - -beta 版本为早期内测版本，预计 Kuboard v3.0.0 的正式发布时间在 2021 年元旦前后 - ## 部署计划 在正式安装 kuboard v3 之前，需做好一个简单的部署计划的设计，在本例中，各组件之间的连接方式，如下图所示： diff --git a/install/v3/install-in-k8s.md b/install/v3/install-in-k8s.md new file mode 100644 index 0000000..add7496 --- /dev/null +++ b/install/v3/install-in-k8s.md @@ -0,0 +1,70 @@ +--- +lessAds: false +description: 在 Kubernetes 集群中安装 Kuboard_V3 +meta: + - name: keywords + content: Kubernetes Dashboard安装,Kuboard安装,K8S Dashboard安装 +--- + +# 在 K8S 中安装 Kuboard v3 + + + +## 安装步骤 + +* 获取部署 Kuboard 所需的 YAML 文件： + + ```sh + curl -o kuboard-v3.yaml https://addons.kuboard.cn/kuboard/kuboard-v3.yaml + ``` + +* 编辑 `kuboard-v3.yaml` 文件中的配置，该部署文件中，有两处配置必须修改： + + * KUBOARD_ENDPOINT + + ```yaml {10} + --- + apiVersion: v1 + kind: ConfigMap + metadata: + name: kuboard-v3-config + namespace: kuboard + data: + # 关于如下参数的解释，请参考文档 https://kuboard.cn/install/v3/install-built-in.html + # [common] + KUBOARD_ENDPOINT: 'http://your-node-ip-address:30080' + KUBOARD_AGENT_SERVER_UDP_PORT: '30081' + KUBOARD_AGENT_SERVER_TCP_PORT: '30081' + ``` + * storageClassName + + ``` yaml {6} + volumeClaimTemplates: + - metadata: + name: data + spec: + # 请填写一个有效的 StorageClass name + storageClassName: please-provide-a-valid-StorageClass-name-here + accessModes: [ "ReadWriteMany" ] + resources: + requests: + storage: 5Gi + ``` + +* 部署到 Kubernetes 集群 + + ```sh + kubectl create -f kuboard-v3.yaml + ``` + +## 访问 Kuboard + +* 在浏览器中打开链接 `http://your-node-ip-address:30080` +* 输入初始用户名和密码，并登录 + + * 用户名： `admin` + * 密码： `Kuboard123` + +## 备注 + +此 YAML 文件向 Kubernetes 中部署了一个三副本的 StatefulSet `kuboard-etcd` 和一个单副本的 Deployment `kuboard-v3`；其中 Deployment `kuboard-v3` 暂时不支持多副本，请保持其 replicas 字段为 1，将在后续的版本升级中解决 `kuboard-v3` 多副本部署的问题。 diff --git a/install/v3/install.md b/install/v3/install.md new file mode 100644 index 0000000..f70af39 --- /dev/null +++ b/install/v3/install.md @@ -0,0 +1,28 @@ +--- +lessAds: false +description: 一行命令开启Kubernetes多集群管理之路_Kuboard_V3安装 +meta: + - name: keywords + content: Kubernetes Dashboard安装,Kuboard安装,K8S Dashboard安装 +--- + +# 安装 Kubernetes 多集群管理工具 - Kuboard v3 + + + +## Kuboard v3.0 版本说明 + +Kuboard v3.0 支持 Kubernetes 多集群管理。如果您从 Kuboard v1.0.x 或者 Kuboard v2.0.x 升级到 Kuboard，请注意： +* 您可以同时使用 Kuboard v3.0.x 和 Kuboard v2.0.x； +* Kuboard v3.0.x 在正式发布时，考虑将 Kuboard 相关的所有组件从 kube-system 名称空间迁移到 kuboard 名称空间； + +## 安装方式 + +在安装 Kuboard 之前，您需要确定登录 Kuboard 时的认证方式，Kuboard 当前提供如下几种认证方式： + +* [内建用户库认证](./install-built-in.html) +* [GitLab 单点登录](./install-gitlab.html) +* [GitHub 单点登录](./install-github.html) +* [LDAP 认证](./install-ldap.html) + +Kuboard 作为一个管理界面，通常单节点部署就可以满足可用性方面的要求，如果您期望您安装的 Kuboard 获得更高的可用性，请考虑：[将 Kuboard 安装到 Kubernetes 集群中](./install-in-k8s.html)