离线升级
根据您在安装过程中做出的选择,完成以下程序之一。
选项 1:使用默认的自签名证书
Copy
helm template ./rancher-<VERSION>.tgz --output-dir . \
--name rancher \
--namespace cattle-system \
--set hostname=<RANCHER.YOURDOMAIN.COM> \
--set certmanager.version=<CERTMANAGER_VERSION> \
--set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \
--set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Available as of v2.2.0, set a default private registry to be used in Rancher
--set useBundledSystemChart=true # Available as of v2.3.0, use the packaged Rancher system charts
Copy
Copy
helm template rancher ./rancher-<VERSION>.tgz --output-dir . \
--no-hooks \ # prevent files for Helm hooks from being generated
--namespace cattle-system \
--set hostname=<RANCHER.YOURDOMAIN.COM> \
--set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \
--set ingress.tls.source=secret \
--set privateCA=true \
--set useBundledSystemChart=true # Use the packaged Rancher system charts
Copy
Copy
如果你使用的是私人 CA 签名的证书,请在--set ingress.tls.source=secret
后面添加--set privateCA=true
。
--name rancher \
--namespace cattle-system \
--set hostname=<RANCHER.YOURDOMAIN.COM> \
--set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \
--set ingress.tls.source=secret \
--set privateCA=true \
--set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Available as of v2.2.0, set a default private registry to be used in Rancher
--set useBundledSystemChart=true # Available as of v2.3.0, use the packaged Rancher system charts
Copy
应用渲染的模板
使用 “kubectl “应用渲染的清单。
Copy
登录 Rancher,确认升级成功。
如果升级之后出现了网络问题,请参考恢复集群网络。
已知问题
升级场景 | 问题描述 |
---|---|
升级到 v2.4.6 或 v2.4.7 | 这些 Rancher 版本存在一个问题,即创建、编辑或克隆 Amazon EC2 节点模板需要kms:ListKeys 权限。这一要求在 v2.4.8 中被删除。建议跳过 v2.4.6 或 v2.4.7,直接升级到 v2.4.8+。 |
升级到 v2.3.0+ | 任何用户供应的集群将在任何编辑后自动更新,因为容忍被添加到用于 Kubernetes 供应的镜像中。 |
升级到 v2.2.0-v2.2.x | Rancher 引入了system charts存储库,其中包含监控、日志、警报和全局 DNS 等功能所需的所有目录项。为了能够在 air gap 安装中使用这些功能,您需要在本地镜像system-charts 资源库,并配置 Rancher 使用该资源库。请按照说明。 |
从 v2.0.13 或更早的版本进行升级 | 如果你的集群的证书已经过期,你需要执行这些步骤来轮换证书。 |
从 v2.0.7 或更早的版本进行升级 | Rancher 引入了system 项目,这是一个自动创建的项目,用于存储 Kubernetes 运行所需的重要命名空间。在升级到 v2.0.7+的过程中,Rancher 希望这些命名空间能够从所有项目中取消分配。在开始升级之前,请检查您的系统命名空间,确保它们未被分配,以。 |