选择 Rancher 版本
本节介绍如何选择 Rancher 版本。
在我们推荐用于生产环境的 Rancher 高可用安装中,Rancher Server 是通过 Kubernetes 集群上的 Helm Chart 安装的。请参见 Helm 版本要求选择 Helm 版本来安装 Rancher。
如果你在开发和测试中使用 Docker 来安装 Rancher,你需要把 Rancher 作为一个 Docker 镜像来安装。
- Helm Charts
- Docker 镜像
如果 Rancher Server 是安装在 Kubernetes 集群上的,Rancher Server 的安装,升级和回滚中,都是使用 Kubernetes 集群上的 Helm Chart 来安装 Rancher 的。因此,在准备安装或升级 Rancher 高可用时,必须添加包含用于安装 Rancher 的 Chart 的 Helm Chart 仓库。
请参见 Helm 版本要求选择 Helm 版本来安装 Rancher。
Helm Chart 仓库
Rancher 提供几个可选的 Helm Chart 仓库供你选择。最新版或稳定版的 Helm Chart 仓库与用于 Docker 安装中的 Docker 标签对应。因此,rancher-latest
仓库包含所有标记为 rancher/rancher:latest
的 Rancher 版本 Chart。当 Rancher 版本升级到 rancher/rancher:stable
,它会被添加到 rancher-stable
仓库中。
类型 | 添加仓库的命令 | 仓库描述 |
---|---|---|
rancher-latest | helm repo add rancher-latest https://releases.rancher.com/server-charts/latest | 添加最新版本的 Rancher 的 Helm Chart 仓库。建议使用此仓库来测试新版本的 Rancher。 |
rancher-stable | helm repo add rancher-stable https://releases.rancher.com/server-charts/stable | 添加较旧的,稳定的版本的 Rancher 的 Helm Chart 仓库。建议在生产环境中使用此仓库。 |
rancher-alpha | helm repo add rancher-alpha https://releases.rancher.com/server-charts/alpha | 添加 alpha 版本的 Rancher 的 Helm Chart 仓库,以预览即将发布的版本。不建议在生产环境中使用这些版本。无论是什么仓库,均不支持 升级 或 升级到 rancher-alpha 仓库中的任何 Chart。 |
了解何时选择这些仓库,请参见切换到不同 Helm Chart 仓库。
rancher-stable
仓库中的所有 Chart 都与 stable
标记的 Rancher 版本对应。
Helm Chart 版本
Rancher Helm Chart 版本与 Rancher 版本(即 appVersion
)对应。添加仓库后,你可以运行以下命令搜索可用版本:
helm search repo --versions
如果你有多个仓库,你可指定仓库名称,即:helm search repo rancher-stable/rancher --versions
详情请访问 https://helm.sh/docs/helm/helm_search_repo/
要获取所选仓库的指定版本,参见如下示例指定 --version
参数:
helm fetch rancher-stable/rancher --version=2.4.8
切换到不同 Helm Chart 仓库
安装 Rancher 后,如果想修改安装 Rancher 的 Helm Chart 仓库,按照以下步骤操作。
由于 rancher-alpha 仓库只包含 alpha 版本 Chart,因此不支持从 rancher alpha 仓库切换到 rancher-stable 或 rancher-latest 仓库以进行升级。
- Latest:建议用于试用最新功能
helm repo add rancher-latest https://releases.rancher.com/server-charts/latest
- Stable:建议用于生产环境
helm repo add rancher-stable https://releases.rancher.com/server-charts/stable
- Alpha:即将发布的实验性预览。注意:不支持升级到 Alpha 版、从 Alpha 版升级或在 Alpha 版之间升级。
helm repo add rancher-alpha https://releases.rancher.com/server-charts/alpha
列出当前 Helm Chart 仓库。
helm repo list
NAME URL
stable https://charts.helm.sh/stable
rancher-<CHART_REPO> https://releases.rancher.com/server-charts/<CHART_REPO>删除包含安装 Rancher 时用的 Chart 的 Helm Chart 仓库。是
rancher-stable
或rancher-latest
取决于你初始安装时的选择。helm repo remove rancher-<CHART_REPO>
添加你要用于安装 Rancher 的 Helm Chart 仓库。
helm repo add rancher-<CHART_REPO> https://releases.rancher.com/server-charts/<CHART_REPO>
按照以下步骤,从新的 Helm Chart 仓库升级 Rancher。
在执行 Docker 安装、升级或回滚时,你可以使用 tags 来安装特定版本的 Rancher。
Server 标签
Rancher Server 以 Docker 镜像的形式分发并附有标签。你可以在输入命令部署 Rancher 时指定标签。请记住,如果你指定了标签,但是没有指定版本(如 latest
或 stable
),你必须显式拉取该镜像标签的新版本。否则,将使用缓存在主机上的镜像。
标签 | 描述 |
---|---|
rancher/rancher:latest | 最新的开发版本。这些版本通过了我们的 CI 自动化验证。不推荐在生产环境使用这些版本。 |
rancher/rancher:stable | 最新的稳定版本。推荐将此标签用于生产环境。 |
rancher/rancher:<v2.X.X> | 你可以使用以前版本中的标签来指定要安装的 Rancher 版本。访问 DockerHub 查看可用的版本。 |
master
和带有-rc
或其他后缀的标签是供 Rancher 测试团队验证用的。这些标签不受官方支持,因此请不要使用这些标签。- 安装 alpha 版本进行预览:使用我们的公告页面中列出的 alpha 标签(例如,
v2.2.0-alpha1
)进行安装。不支持升级或升级到 Alpha 版本。