Rancher 部署与使用指南
目录
1. Rancher 简介
Rancher 是一个开源的容器管理平台，支持：
- 多集群 Kubernetes 管理
- 应用商店（Helm Chart 部署）
- 监控、日志、告警集成
- CI/CD 流水线
2. 部署方式选择
| 部署方式 | 适用场景 | 复杂度 |
|---|---|---|
| Docker 单节点 | 测试/开发环境 | 低 |
| K3s 高可用 | 中小规模生产环境 | 中 |
| RKE/Kubernetes | 大规模生产环境 | 高 |
3. 单节点部署（Docker 版）
3.1 环境要求
- Linux 主机（推荐 Ubuntu/CentOS）
- Docker 已安装（版本 20.10+）
- 开放端口：
80、443、6443
3.2 安装步骤
# 拉取最新 Rancher 镜像
docker pull rancher/rancher:latest
# 启动 Rancher 容器
docker run -d \
--name=rancher \
--restart=unless-stopped \
-p 80:80 -p 443:443 \
-v /opt/rancher:/var/lib/rancher \
rancher/rancher:latest
# 查看日志（等待启动完成）
docker logs -f rancher
3.3 访问控制台
- 浏览器访问：
https://<服务器IP> - 首次登录获取初始密码：
docker exec -it rancher cat /var/lib/rancher/bootstrap_password.txt
4. 高可用部署（Kubernetes 版）
4.1 使用 K3s 部署
# 在所有节点安装 K3s（Server 节点）
curl -sfL https://get.k3s.io | sh -s - server --cluster-init
# 添加 Worker 节点
curl -sfL https://get.k3s.io | K3S_URL=https://<主节点IP>:6443 K3S_TOKEN=<主节点token> sh -
# 安装 Helm
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
4.2 安装 Rancher
# 添加 Helm 仓库
helm repo add rancher-stable https://releases.rancher.com/server-charts/stable
# 安装 Rancher
helm install rancher rancher-stable/rancher \
--namespace cattle-system \
--create-namespace \
--set hostname=rancher.example.com \
--set bootstrapPassword=admin123
5. 基本使用操作
5.1 添加集群
- 进入
Cluster Management>Create Cluster - 选择集群类型（如导入现有集群、自定义集群等）
- 复制命令到目标服务器执行
5.2 部署应用
# 通过 kubectl 部署示例应用
kubectl create deployment nginx --image=nginx
kubectl expose deployment nginx --port=80 --type=NodePort
5.3 使用应用商店
- 导航到
Apps>Charts - 搜索应用（如
cert-manager） - 点击安装并配置参数
6. 常见问题
Q1: 无法访问 Rancher UI
- 检查防火墙规则：
sudo ufw allow 443/tcp - 查看容器状态：
docker ps -a
Q2: 如何备份数据？
# Docker 版备份
docker stop rancher
tar -czvf rancher_backup.tar.gz /opt/rancher
docker start rancher
# Kubernetes 版备份
kubectl get all -n cattle-system -o yaml > rancher_resources.yaml
Q3: 如何升级 Rancher？
# Docker 版
docker stop rancher
docker pull rancher/rancher:latest
docker run ... (使用原有参数)
# Helm 版
helm upgrade rancher rancher-stable/rancher -n cattle-system
补充说明
- 生产建议：高可用部署需至少 3 个节点，并配置外部数据库（如 MySQL/PostgreSQL）。
- 安全配置：启用 TLS 证书（Let’s Encrypt 或自定义证书）。
- 监控：集成 Prometheus 和 Grafana。
如需更详细的配置（如 LDAP 集成、持久化存储等），可参考 Rancher 官方文档。