对于生产环境,我们建议以高可用配置安装 Rancher,以便您的用户始终可以访问 Rancher Server。当 Rancher 安装在 Kubernetes 集群中时,Rancher 将与集群的 etcd 数据库集成,并利用 Kubernetes 调度来实现高可用。

本节介绍如何使用 RKE 或 K3s 创建和管理集群,然后将 Rancher 安装到该集群上。对于这种类型的架构,您将需要在基础设施提供商中创建节点(通常为虚拟机)。您还需要配置负载均衡器,将前端流量定向到这些节点中。当节点运行起来并满足节点要求时,可以使用 RKE 或 K3s 将 Kubernetes 部署到这些节点上,然后使用 Helm 软件包管理器将 Rancher 部署到 Kubernetes 上。

可选:在单节点 Kubernetes 集群上安装 Rancher

如果您只有一个节点,但您想在将来的生产中使用 Rancher Server,则最好将 Rancher 安装在单节点 Kubernetes 集群上,而不是使用 Docker 安装它。

要创建单节点 RKE 集群,只需在cluster.yml中配置一个节点。这个节点应该具有所有三个角色:etcd,controlplaneworker

要创建单节点 K3s 集群,只需在一个节点上运行安装命令即可,并不需要像高可用集群一样在两个节点上安装。

配置完单节点的 Kubernetes 集群后,就可以像在其他高可用集群上安装一样,使用 Helm 安装 Rancher。

通过 RKE 安装

通过为 RKE 配置 Kubernetes 集群时,可以通过在cluster.yml中只描述一个节点就可以实现单节点 Kubernetes 的安装。这个节点将具有所有三个角色:etcdcontrolplaneworker

通过 K3s 安装

通过 K3s 安装 Kubernetes 集群时,可以将这个节点同时作为 Server 和 Agent 节点

然后,就像在其他任何集群上安装一样,使用 Helm 将 Rancher 安装在集群上。

关于架构的重要说明

Rancher Server 只能在使用 RKE 或 K3s 安装的 Kubernetes 集群中运行。不支持在托管的 Kubernetes 集群(例如 EKS)上使用 Rancher。

为了获得最佳性能和安全性,我们建议为 Rancher Server 使用专用的 Kubernetes 集群。不建议在此集群上运行用户的其他工作负载。部署完 Rancher 之后,您可以创建或导入用于运行用户工作负载的集群。

有关 Rancher 是如何工作的(与安装方法无关),请参阅产品架构

需要的 CLI 工具

此安装需要以下 CLI 工具。请确保这些工具已经安装并在$PATH中可用

  • kubectl - Kubernetes 命令行工具.
  • rke - Rancher Kubernetes Engine,用于构建 Kubernetes 集群的 cli。
  • k3s - Rancher K3s。
  • helm - Kubernetes 的软件包管理工具。请参阅Helm 版本要求选择 Helm 的版本来安装 Rancher。

:::note 提示 国内用户,可以导航到 http://mirror.cnrancher.com 下载所需资源 :::

安装摘要

其他安装选项

已经弃用的安装方法

RKE add-on 安装

重要说明:RKE ADD-ON 安装仅在 RANCHER v2.0.8 之前到版本中支持

请使用 Rancher Helm Chart 在 Kubernetes 集群上安装 Rancher 高可用。更多信息请参阅Rancher 高可用安装

如果您当前正在使用 RKE add-on 安装方式,请参阅从 RKE Add-on 安装的 Rancher 高可用迁移到 Helm 安装以获取有关如何使用 Helm Chart 的详细信息。