当前位置：首页 > news >正文

Rancher 安装与配置文档

news 2026/5/25 6:19:45

Rancher 安装与配置文档

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

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

前置依赖

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

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

1. 添加 Rancher Helm 仓库

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

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

可以搜索可用的 Rancher 版本：

helm search repo rancher-stable-l

2. 下载并配置 Rancher Chart 包

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

2.1 下载指定版本的 Chart 包

# 下载 2.14.1 版本helm pull rancher-stable/rancher--version2.14.1# 解压下载的包tar-zxvfrancher-*.tgz

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

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

vimrancher/Chart.yaml

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

# 注释掉原有的限制# kubeVersion: '< 1.36.0-0'# 或者改大一点允许更高的 K8s 版本kubeVersion:'< 1.37.0-0'

3. 安装 Rancher

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

cdrancher/ helm upgrade--installrancher.\--namespacecattle-system\--create-namespace\--version2.14.1\--sethostname=rancher.aioil.top\--setbootstrapPassword=admin1234567\--setingress.includeDefaultExtraAnnotations=true\--setingress.ingressClassName="nginx"

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

helm upgrade--installrancher rancher-stable/rancher\--namespacecattle-system\--create-namespace\--sethostname=rancher.aioil.top\--setbootstrapPassword=admin1234567\--setingress.includeDefaultExtraAnnotations=true\--setingress.ingressClassName="nginx"

4. 验证安装

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

# 查看 Pod 状态，等待所有 Pod 变为 Running 状态kubectl get pods-ncattle-system-w# 检查 Deployment 的滚动更新状态kubectl-ncattle-system rollout status deploy/rancher# 查看 Ingress 和 Service 是否正常创建kubectl get ingress,svc-ncattle-system# 查看命名空间下的所有相关资源kubectl get all-ncattle-system