在 Rancher 上快速安装和使用 KDP 云原生数据平台

金津，智领云高级研发经理。

华中科技大学计算机系硕士。加入智领云 7 余年，长期从事云原生、容器化编排领域研发工作，主导了智领云自研的 BDOS 应用云平台、云原生大数据平台 KDP 等产品的开发，并在多个大规模项目中成功实施落地，在大规模容器化编排系统方向有丰富的实践经验。

GitHub 地址：https://github.com/linktimecloud/kubernetes-data-platform/blob/main/docs/zh/user-tutorials/install-kdp-on-rancher-101.md    

Rancher 简介

什么是 Rancher

Rancher [1]是一个 Kubernetes 管理工具，让您能在任何地方和任何提供商上部署和运行集群。

Rancher 可以创建来自 Kubernetes 托管服务提供商的集群，创建节点并安装 Kubernetes，或者导入在任何地方运行的现有 Kubernetes 集群。

Rancher 是一个全栈式的 Kubernetes 容器管理平台，为您提供在任何地方都能成功运行 Kubernetes 的工具。

Rancher架构

Rancher 的架构包括 Rancher 管理服务器和 Rancher 管理的下游集群：

集成的 Kubernetes 发行版

Rancher 集成了这些 Kubernetes 发行版[2]：

• K3s[3]: K3s 是轻量级的 Kubernetes。K3s 易于安装，仅需要 Kubernetes 内存的一半，所有组件都在一个小于 100 MB 的二进制文件中。

• RKE2[4]: RKE2，也称为 RKE Government，是 Rancher 的下一代 Kubernetes 发行版。 

在 Rancher 上创建自定义下游集群时，您会看到这两个发行版作为选项： 

先决条件

• 已在 Kubernetes 集群[5]上安装 Rancher 管理服务器，或通过其他方法[6]安装。

• 已在 Rancher 管理服务器上创建了下游集群[7]，例如 K3s 集群、RKE2 集群或来自其他提供商[8]的K8s集群。

在 Rancher 管理的集群上安装KDP

假设您已经在 Rancher 上安装了一个下游的 K3s 或 RKE2 集群(K8s v1.26.x)，并已在下游集群上安装了监控套件：

  

安装KDP CLI

• 可选使用本地终端工具或 KubeSphere 网页终端进行操作：

• 通过本地Shell：打开您计算机上的Bash或Zsh终端。

• 通过'Kubectl Shell'：如下所示在 Rancher 控制台中打开'Kubectl Shell(Ctrl+`)'，您将连接到一个网页终端：

• 在网页或本地终端中，请执行以下命令以安装 KDP 命令行工具（注：若使用网页终端，因其无状态特性，每次新建立会话都需要重新安装 KDP 命令行工具）：

# 下载 KDP CLI（设置环境变量'VERSION'为所需版本号）
export VERSION=v1.1.0
wget https://github.com/linktimecloud/kubernetes-data-platform/releases/download/${VERSION}/kdp-${VERSION}-linux-amd64.tar.gz
tar xzf kdp-${VERSION}-linux-amd64.tar.gz
mkdir -p ~/.local/bin
install -v ./linux-amd64/kdp ~/.local/bin
export PATH=$PATH:$HOME/.local/bin
kdp version

安装 KDP 基础平台

对于K3s集群

执行以下命令以在启用了监控套件的 K3s 集群上安装 KDP ：

# 注：请关注以下参数：
# - `dnsService.name=kube-dns`：指定 K3s 集群的默认 DNS 服务名称。
# - `kong.enabled=false` && `ingress.class=traefik`：跳过 KDP 内置的 Kong Ingress Controller 组件安装，改用 K3s 内置的 Traefik 。
# - `prometheus*`：跳过 KDP 内置的监控套件安装，改用 K3s 内置的监控套件。


kdp install \
--force-reinstall \
--set dnsService.name=kube-dns \
--set kong.enabled=false \
--set ingress.class=traefik \
--set prometheusCRD.enabled=false \
--set prometheus.enabled=false \
--set prometheus.externalUrl=http://rancher-monitoring-prometheus.cattle-monitoring-system.svc:9090

对于RKE2集群

执行以下命令以在启用了监控套件的 RKE2 集群上安装 KDP ：

# 注：请关注以下参数：
# - `dnsService.name=rke2-coredns-rke2-coredns`：指定 RKE2 集群的默认 DNS 服务名称。
# - `kong.enabled=false` && `ingress.class=nginx`：跳过 KDP 内置的 Kong Ingress Controller 组件安装，改用 RKE2 内置的 Nginx 。
# - `prometheus*`：跳过 KDP 内置的监控套件安装，改用 RKE2 内置的监控套件。


kdp install \
--force-reinstall \
--set dnsService.name=rke2-coredns-rke2-coredns \
--set kong.enabled=false \
--set ingress.class=nginx \
--set prometheusCRD.enabled=false \
--set prometheus.enabled=false \
--set prometheus.externalUrl=http://rancher-monitoring-prometheus.cattle-monitoring-system.svc:9090

访问KDP UX

• 等待安装完成：

• 转到 Rancher 控制台菜单'Service Discovery' - 'Ingresses'，找到 Ingress 对象'kdp-ux'，然后点击'Target'列中的链接，KDP UX 将在新标签页中打开： 

• 您现在可以使用 KDP Web 控制台来建设自己的数据平台。有关使用数据组件的更多教程，请参考教程目录[9]：

演示视频：如何在 Rancher 上快速部署和使用 KDP ：

附录

[1] Rancher：https://ranchermanager.docs.rancher.com/zh/

[2] Kubernetes 发行版：https://ranchermanager.docs.rancher.com/zh/integrations-in-rancher/kubernetes-distributions

[3] K3s：https://docs.k3s.io/zh/

[4] RKE2：https://docs.rke2.io/zh/

[5] Kubernetes 集群：https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster

[6] 其他方法：https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/other-installation-methods

[7] 创建了下游集群：https://ranchermanager.docs.rancher.com/zh/how-to-guides/new-user-guides/launch-kubernetes-with-rancher

[8] 其他提供商：https://ranchermanager.docs.rancher.com/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup

[9] 教程目录：https://github.com/linktimecloud/kubernetes-data-platform/blob/main/docs/zh/user-tutorials/tutorials.md

 - FIN -       

更多精彩推荐

• 开源 KDP  v1.1.0 版本正式发布，新增数据集成开发应用场景

• 我们开源啦！一键部署免费使用！Kubernetes上直接运行大数据平台

• 在 KubeSphere 上快速安装和使用 KDP 云原生数据平台