手动升级
你可以使用安装脚本升级 K3s,也可以手动安装所需版本的二进制文件。
备注
升级时会先升级 Server 节点,然后再升级 Agent 节点。
版本 Channels
通过安装脚本或使用我们的自动升级功能执行的升级可以绑定到不同的版本 channels。以下是可用的 channels:
Channel | 描述 |
---|---|
stable | (默认)生产环境建议使用稳定版。这些版本已经过一段时间的社区强化。 |
latest | 建议使用最新版本来试用最新功能。这些版本已经过一段时间的社区强化。 |
v1.26(示例) | 每个 Kubernetes 次要版本都有一个 release channel,包括 EOL 的版本。这些 channel 会选择可用的最新补丁,不一定是稳定版本。 |
有关详细的最新 channel 列表,你可以访问 k3s channel 服务 API。有关 channel 如何工作的更多信息,请参阅 channelserver 项目。
提示
尝试升级到 K3s 新版本时,Kubernetes 版本倾斜策略适用。确保你的计划在升级时不会跳过中间次要版本。system-upgrade-controller 本身不会防止更改到不支持的 Kubernetes 版本。
使用安装脚本升级 K3s
要升级旧版本的 K3s,你可以使用最初运行安装脚本时使用的相同配置选项重新运行安装脚本。
信息
安装脚本使用 INSTALL_K3S_EXEC
变量、K3S_
变量和尾随的 shell 参数来生成 systemd 单元和环境文件。
如果你在最初运行安装脚本时进行了配置,但在重新运行安装脚本时没有重新设置,则原始值将会丢失。
配置文件 的内容不受安装脚本管理。 要让你的配置独立于安装脚本,请使用配置文件而不是传递环境变量或使用安装脚本参数。
例如,要升级到当前的稳定版本:
curl -sfL https://get.k3s.io | <EXISTING_K3S_ENV> sh -s - <EXISTING_K3S_ARGS>
如果想升级到特定 channel(如 latest)中的更新版本,你可以指定 channel:
curl -sfL https://get.k3s.io | INSTALL_K3S_CHANNEL=latest <EXISTING_K3S_ENV> sh -s - <EXISTING_K3S_ARGS>
如果要升级到特定版本,可以运行以下命令:
curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION=vX.Y.Z-rc1 <EXISTING_K3S_ENV> sh -s - <EXISTING_K3S_ARGS>
使用二进制文件手动升级 K3s
或者手动升级 K3s:
- 从 releases 页面下载所需版本的 K3s 二进制文件
- 将下载的二进制文件复制到
/usr/local/bin/k3s
(或你想要的位置) - 停止旧的 K3s 二进制文件
- 启动新的 K3s 二进制文件
重启 K3s
systemd 和 OpenRC 的安装脚本支持重启 K3s。
systemd
手动重启 Server:
sudo systemctl restart k3s
手动重启 Agent:
sudo systemctl restart k3s-agent
OpenRC
手动重启 Server:
sudo service k3s restart
手动重启 Agent:
sudo service k3s-agent restart