Rancher 部署与使用指南

Rancher 部署与使用指南

目录

1. Rancher 简介
2. 部署方式选择
3. 单节点部署（Docker 版）
4. 高可用部署（Kubernetes 版）
5. 基本使用操作
6. 常见问题

---

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 访问控制台

1. 浏览器访问：https://<服务器IP>
2. 首次登录获取初始密码：

   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 添加集群

1. 进入 Cluster Management > Create Cluster
2. 选择集群类型（如导入现有集群、自定义集群等）
3. 复制命令到目标服务器执行

5.2 部署应用

# 通过 kubectl 部署示例应用
kubectl create deployment nginx --image=nginx
kubectl expose deployment nginx --port=80 --type=NodePort

5.3 使用应用商店

1. 导航到 Apps > Charts
2. 搜索应用（如 cert-manager）
3. 点击安装并配置参数

---

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

---

补充说明

1. 生产建议：高可用部署需至少 3 个节点，并配置外部数据库（如 MySQL/PostgreSQL）。
2. 安全配置：启用 TLS 证书（Let’s Encrypt 或自定义证书）。
3. 监控：集成 Prometheus 和 Grafana。

如需更详细的配置（如 LDAP 集成、持久化存储等），可参考 Rancher 官方文档。