在 Kubernetes 集群上安装/升级 Rancher

博主： xinyu_he
发布时间：2025 年 04 月 08 日
68 次浏览
暂无评论
4105字数
分类： kubernetes

# 什么是 Rancher？

参考：[官方文档教程](https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster)

> Rancher 是一个 Kubernetes 管理工具，让你能在任何地方和任何提供商上部署和运行集群。

> Rancher 可以创建来自 Kubernetes 托管服务提供商的集群，创建节点并安装 Kubernetes，或者导入在任何地方运行的现有 Kubernetes 集群。

> Rancher 基于 Kubernetes 添加了新的功能，包括统一所有集群的身份验证和 RBAC，让系统管理员从一个位置控制全部集群的访问。

> 此外，Rancher 可以为集群和资源提供更精细的监控和告警，将日志发送到外部提供商，并通过应用商店（Application Catalog）直接集成 Helm。如果你拥有外部 CI/CD 系统，你可以将其与 Rancher 对接。没有的话，你也可以使用 Rancher 提供的 Fleet 自动部署和升级工作负载。

> Rancher 是一个 *全栈式* 的 Kubernetes 容器管理平台，为你提供在任何地方都能成功运行 Kubernetes 的工具。

## 在 Kubernetes 集群上安装/升级 Rancher

- 备注
- 本安装指南假定你使用的是 Helm 3。
- 要设置 Rancher：

1. [添加 Helm Chart 仓库](https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster#1-%E6%B7%BB%E5%8A%A0-helm-chart-%E4%BB%93%E5%BA%93)
2. [为 Rancher 创建命名空间](https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster#2-%E4%B8%BA-rancher-%E5%88%9B%E5%BB%BA%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4)
3. [选择 SSL 配置](https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster#3-%E9%80%89%E6%8B%A9-ssl-%E9%85%8D%E7%BD%AE)
4. [安装 cert-manager](https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster#4-%E5%AE%89%E8%A3%85-cert-manager)（除非你自带证书，否则 TLS 将在负载均衡器上终止）
5. [使用 Helm 和你选择的证书选项安装 Rancher](https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster#5-%E6%A0%B9%E6%8D%AE%E4%BD%A0%E9%80%89%E6%8B%A9%E7%9A%84%E8%AF%81%E4%B9%A6%E9%80%89%E9%A1%B9%E9%80%9A%E8%BF%87-helm-%E5%AE%89%E8%A3%85-rancher)
6. [验证 Rancher Server 是否部署成功](https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster#6-%E9%AA%8C%E8%AF%81-rancher-server-%E6%98%AF%E5%90%A6%E9%83%A8%E7%BD%B2%E6%88%90%E5%8A%9F)
7. [保存选项](https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster#7-%E4%BF%9D%E5%AD%98%E9%80%89%E9%A1%B9)

### 1. 添加 Helm Chart 仓库[](https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster#1-%E6%B7%BB%E5%8A%A0-helm-chart-%E4%BB%93%E5%BA%93 "标题的直接链接")

执行 `helm repo add` 命令，以添加包含安装 Rancher 的 Chart 的 Helm Chart 仓库。有关如何选择仓库，以及哪个仓库最适合你的用例，请参见[选择 Rancher 版本](https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/resources/choose-a-rancher-version)。

* Latest：建议用于试用最新功能

```text
  helm repo add rancher-latest https://releases.rancher.com/server-charts/latest
  ```
* Stable：建议用于生产环境

```text
  helm repo add rancher-stable https://releases.rancher.com/server-charts/stable
  ```
* Alpha：即将发布的实验性预览。

```text
  helm repo add rancher-alpha https://releases.rancher.com/server-charts/alpha
  ```

注意：不支持升级到 Alpha 版、从 Alpha 版升级或在 Alpha 版之间升级。

### 2. 为 Rancher 创建命名空间[](https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster#2-%E4%B8%BA-rancher-%E5%88%9B%E5%BB%BA%E5%91%BD%E5%90%8D%E7%A9%BA%E9%97%B4 "标题的直接链接")

你需要定义一个 Kubernetes 命名空间，用于安装由 Chart 创建的资源。这个命名空间的名称为 `cattle-system`：

```text
kubectl create namespace cattle-system
```

### 3.安装rancher

使用以下命令安装 Rancher：

```shell
# 创建一个命名空间
kubectl create namespace cattle-system
 
# 安装 Rancher
helm install rancher rancher-stable/rancher --namespace cattle-system --set hostname=rancher.your-domain.com
```

**说明：**

* 首先创建一个名为 `cattle-system` 的命名空间，以便 Rancher 在这个命名空间下运行。
* 然后，通过 Helm 安装 Rancher，`hostname` 是你希望将 Rancher 绑定到的域名。

### 4.验证rancher安装

可以通过以下命令检查 Rancher 的状态：

```shell
# 检查 Rancher Pod 状态
kubectl -n cattle-system rollout status deploy/rancher

```

**说明：**

* 这个命令会显示 Rancher 的 Pod 是否已成功启动并运行。

### 5.访问rancher控制面板

如果 Rancher 已成功运行，你可以通过浏览器访问管理界面，输入你在步骤 3 中设置的域名

最后修改：2025 年 04 月 08 日

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱

地址

清鹤烟
出BUG第一时间不应该是甩锅嘛（╯‵□′）╯︵┴─┴
xinyu
是的，刷kpi
挺胸的大黄
大多HR都是来凑数的，哈哈
清鹤烟
我就遇到过好多水货面试官OωO
潜心学习的道士
打商了吗

jenkins-部署
浏览次数: 112
Ubuntu 24.04.1 LTS 安装docker
浏览次数: 56
Vmwore安装ubuntu系统
浏览次数: 80
微服务架构闲聊
浏览次数: 3265
k8s常用命令
浏览次数: 46

在 Kubernetes 集群上安装/升级 Rancher

xinyu_he • 2025 年 04 月 08 日

# 什么是 Rancher？

参考：[官方文档教程](https://ranchermanager.docs.rancher.com/zh/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster)

> Rancher 是一个 Kubernetes 管理工具，让你能在任何地方和任何提供商上部署和运行集群。

> Rancher 可以创建来自 Kubernetes 托管服务提供商的集群，创建节点并安装 Kubernetes，或者导入在任何地方运行的现有 Kubernetes 集群。

> Rancher 基于 Kubernetes 添加了新的功能，包括统一所有集群的身份验证和 RBAC，让系统管理员从一个位置控制全部集群的访问。

> Rancher 是一个 *全栈式* 的 Kubernetes 容器管理平台，为你提供在任何地方都能成功运行 Kubernetes 的工具。

## 在 Kubernetes 集群上安装/升级 Rancher

- 备注
- 本安装指南假定你使用的是 Helm 3。
- 要设置 Rancher：

* Latest：建议用于试用最新功能

```text
  helm repo add rancher-latest https://releases.rancher.com/server-charts/latest
  ```
* Stable：建议用于生产环境

```text
  helm repo add rancher-stable https://releases.rancher.com/server-charts/stable
  ```
* Alpha：即将发布的实验性预览。

```text
  helm repo add rancher-alpha https://releases.rancher.com/server-charts/alpha
  ```

注意：不支持升级到 Alpha 版、从 Alpha 版升级或在 Alpha 版之间升级。

你需要定义一个 Kubernetes 命名空间，用于安装由 Chart 创建的资源。这个命名空间的名称为 `cattle-system`：

```text
kubectl create namespace cattle-system
```

### 3.安装rancher

使用以下命令安装 Rancher：

**说明：**

### 4.验证rancher安装

可以通过以下命令检查 Rancher 的状态：

```shell
# 检查 Rancher Pod 状态
kubectl -n cattle-system rollout status deploy/rancher

```

**说明：**

* 这个命令会显示 Rancher 的 Pod 是否已成功启动并运行。

### 5.访问rancher控制面板

如果 Rancher 已成功运行，你可以通过浏览器访问管理界面，输入你在步骤 3 中设置的域名

在 Kubernetes 集群上安装/升级 Rancher

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

Kubernetes + Harbor + Ingress 部署 SpringBoot + Vue 前后端分离项目

微服务架构闲聊

如果运维面试遇到水货面试官，怎么办？

k8s pod 不断重启 java OutOfMemoryError

kubernetes-组件架构

jenkins-部署

Ubuntu 24.04.1 LTS 安装docker

Vmwore安装ubuntu系统

微服务架构闲聊

k8s常用命令

在 Kubernetes 集群上安装/升级 Rancher

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

在 Kubernetes 集群上安装/升级 Rancher

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款