Rancher 安装与配置文档

⚠️ 重要提示：

Rancher 部署完成后的初始化过程可能需要 30 分钟左右，期间相关的 Pod 可能会多次重启或处于未就绪状态，这是正常现象，请耐心等待。

本文档介绍如何在 Kubernetes 集群中使用 Helm 安装 Rancher 平台。

前置依赖

在安装 Rancher 之前，请确保您的集群已安装以下组件。如果您尚未安装，请参考以下链接进行安装：

安装 Kubernetes Nginx Ingress Controller
参考文档：点击访问
安装 Cert-Manager (用于自动签发证书)
参考文档：点击访问

1. 添加 Rancher Helm 仓库

首先，添加 Rancher 的官方 Helm 仓库并更新本地缓存：

bash 复制代码

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

可以搜索可用的 Rancher 版本：

bash 复制代码

helm search repo rancher-stable -l

2. 下载并配置 Rancher Chart 包

为了避免 Kubernetes 版本兼容性问题，我们建议先将 Chart 包下载到本地进行修改。

2.1 下载指定版本的 Chart 包

bash 复制代码

# 下载 2.14.1 版本
helm pull rancher-stable/rancher --version 2.14.1

# 解压下载的包
tar -zxvf rancher-*.tgz

2.2 修改 Kubernetes 版本限制 (可选)

如果您的 K8s 版本较新，可能会被 Rancher Chart 默认的 kubeVersion 限制拦截。我们需要修改 Chart.yaml：

bash 复制代码

vim rancher/Chart.yaml

在文件中找到 kubeVersion: '< 1.36.0-0' 这一行，将其修改为更大的版本范围，或者直接注释掉：

yaml 复制代码

# 注释掉原有的限制
# kubeVersion: '< 1.36.0-0' 

# 或者改大一点允许更高的 K8s 版本
kubeVersion: '< 1.37.0-0'

3. 安装 Rancher

进入解压后的目录，使用 Helm 进行本地安装：

bash 复制代码

cd rancher/

helm upgrade --install rancher . \
  --namespace cattle-system \
  --create-namespace \
  --version 2.14.1 \
  --set hostname=rancher.aioil.top \
  --set bootstrapPassword=admin1234567 \
  --set ingress.includeDefaultExtraAnnotations=true \
  --set ingress.ingressClassName="nginx"

(注：如果您不需要修改 Chart.yaml，也可以直接通过在线仓库安装：)

bash 复制代码

helm upgrade --install rancher rancher-stable/rancher \
  --namespace cattle-system \
  --create-namespace \
  --set hostname=rancher.aioil.top \
  --set bootstrapPassword=admin1234567 \
  --set ingress.includeDefaultExtraAnnotations=true \
  --set ingress.ingressClassName="nginx"

4. 验证安装

安装过程可能需要几分钟时间，请耐心等待。使用以下命令检查安装状态：

bash 复制代码

# 查看 Pod 状态，等待所有 Pod 变为 Running 状态
kubectl get pods -n cattle-system -w

# 检查 Deployment 的滚动更新状态
kubectl -n cattle-system rollout status deploy/rancher

# 查看 Ingress 和 Service 是否正常创建
kubectl get ingress,svc -n cattle-system

# 查看命名空间下的所有相关资源
kubectl get all -n cattle-system

5. 访问 Rancher

5.1 访问方式

当所有 Pod 处于 Running 状态，且 Ingress 配置生效后，您可以通过浏览器访问 Rancher 的 Web 界面：

访问地址 ：https://rancher.aioil.top (请确保该域名已解析到您的 Ingress 控制器节点 IP)

5.2 默认登录凭据

首次登录时，请使用您在安装时通过 --set bootstrapPassword 设置的密码：

用户名 ：admin
密码：admin1234567

6. 卸载 Rancher

如果您需要卸载 Rancher，可以执行以下命令清理资源：

bash 复制代码

helm uninstall rancher -n cattle-system