Rancher Kubernetes 管理平台部署

Rancher 是一款企业级的 Kubernetes 管理平台，提供直观的 Web 界面来管理多个 Kubernetes 集群。通过 Rancher，你可以轻松创建、导入和管理 K8S/K3S 集群，部署应用，配置监控和告警。本文将介绍如何在搬瓦工 VPS 上部署 Rancher。

一、环境要求

Kubernetes 集群：建议先搭建 K3S 集群来运行 Rancher。
内存：Rancher 需要至少 4GB 内存。
Helm：需要安装 Helm 包管理器。

搬瓦工 VPS 购买地址：bwh81.net，使用优惠码 NODESEEK2026 享受 6.77% 折扣。

二、方式一：Docker 快速部署

适合快速体验和测试环境：

docker run -d \
  --name rancher \
  --restart=unless-stopped \
  -p 80:80 \
  -p 443:443 \
  --privileged \
  -v rancher_data:/var/lib/rancher \
  rancher/rancher:latest

等待约 2 分钟后访问 https://你的IP。

2.1 获取初始密码

docker logs rancher 2>&1 | grep "Bootstrap Password:"

使用该密码登录后设置管理员密码和 Server URL。

三、方式二：Helm 部署到 K3S（推荐）

3.1 安装 cert-manager

kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.14.0/cert-manager.crds.yaml

helm repo add jetstack https://charts.jetstack.io
helm repo update

helm install cert-manager jetstack/cert-manager \
  --namespace cert-manager \
  --create-namespace \
  --version v1.14.0

等待 cert-manager Pod 就绪：

kubectl get pods -n cert-manager -w

3.2 安装 Rancher

helm repo add rancher-stable https://releases.rancher.com/server-charts/stable
helm repo update

helm install rancher rancher-stable/rancher \
  --namespace cattle-system \
  --create-namespace \
  --set hostname=rancher.yourdomain.com \
  --set bootstrapPassword=admin \
  --set replicas=1

3.3 等待部署完成

kubectl -n cattle-system rollout status deploy/rancher
kubectl get pods -n cattle-system

四、导入已有集群

输入集群名称。
选择"Generic"类型。
复制生成的 kubectl 命令，在目标集群上执行即可。

# 在目标集群上执行（示例）
kubectl apply -f https://rancher.yourdomain.com/v3/import/xxxxx.yaml

五、使用应用商店

Rancher 内置了应用商店（Apps & Marketplace），可以一键部署常用应用：

Monitoring：基于 Prometheus + Grafana 的监控方案。
Logging：集中式日志收集（EFK/Loki）。
Istio：服务网格。
Longhorn：云原生分布式存储。

在集群页面点击"Apps"→"Charts"，搜索并安装所需应用。

六、项目与命名空间管理

Rancher 引入了"项目（Project）"的概念，将命名空间分组管理：

创建项目并分配命名空间。
为项目设置资源配额限制。
将团队成员添加到特定项目，实现权限隔离。

七、用户认证配置

Rancher 支持多种认证方式：

Local：本地账户管理。
GitHub：通过 GitHub OAuth 登录。
LDAP/AD：企业目录服务集成。
SAML：与 Okta、OneLogin 等集成。

在 Global Settings → Authentication 中配置。

八、监控与告警

通过应用商店安装 Monitoring 组件后：

自动部署 Prometheus 和 Grafana。
内置常用的 Dashboard 模板。
可以配置告警规则，通过邮件、Slack、钉钉等方式发送通知。

# 查看 Monitoring 组件状态
kubectl get pods -n cattle-monitoring-system

九、常见问题

Rancher 启动缓慢

首次启动需要拉取多个镜像，可能需要 5-10 分钟。查看日志：

# Docker 部署方式
docker logs -f rancher

# Helm 部署方式
kubectl logs -f -n cattle-system -l app=rancher

导入集群失败

确保目标集群可以访问 Rancher Server 的地址，检查网络连通性和 DNS 解析。

证书问题

如果使用自签名证书，导入集群时需要添加 --insecure 参数：

curl --insecure -sfL https://rancher.yourdomain.com/v3/import/xxxxx.yaml | kubectl apply -f -

总结

Rancher 为 Kubernetes 集群管理提供了企业级的解决方案，特别适合需要管理多个集群的场景。搭配 K3S 和 Helm 使用可以快速搭建完整的容器管理平台。选购搬瓦工 VPS 请参考全部方案，使用优惠码 NODESEEK2026 享受 6.77% 折扣。