环境变量
如快速入门指南中所述,你可以使用 https://get.k3s.io 上提供的安装脚本在基于 systemd 和 openrc 的系统上将 K3s 安装为服务。
此命令的最简单形式如下:
curl -sfL https://get.k3s.io | sh -
中国用户,可以使用以下方法加速安装: curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn sh - |
使用该方法安装 K3s 时,你可以使用以下环境变量来配置安装:
环境变量 | 描述 |
---|---|
|
如果设置为 |
|
默认情况下,如果命令不存在于路径中,将为 kubectl、crictl 和 ctr 二进制文件创建符号链接。如果设置为 |
|
如果设置为 |
|
如果设置为 |
|
从 GitHub 下载的 K3s 版本。如果未指定,将尝试从 stable channel 下载。 |
|
安装 K3s 二进制文件、链接和卸载脚本的目录,或使用 |
|
如果设置为 |
|
安装 systemd 服务和环境文件的目录,或使用 |
|
带有标志的命令,用于在服务中启动 K3s。如果未指定命令并且设置了 |
|
要创建的 systemd 服务的名称,如果将 K3s 作为 server 运行,则默认为 “k3s”,如果将 K3s 作为 agent 运行,则默认为 “k3s-agent”。如果指定,名称将以"`k3s-`"为前缀。 |
|
要创建的 systemd 服务类型,如果未指定,将默认使用来自 K3s exec 命令的类型。 |
|
如果设置为 |
|
如果设置为 |
|
用于获取 K3s 下载 URL 的 Channel URL。默认为 https://update.k3s.io/v1-release/channels。 |
|
用于获取 K3s 下载 URL 的 Channel。默认为 "stable"。可选项: |
以下示例显示了如何将上述环境变量作为选项设置(在管道符后):
curl -sfL https://get.k3s.io | INSTALL_K3S_CHANNEL=latest sh -
以 K3S_
开头的环境变量将被保留,供 systemd 和 openrc 服务使用。
如果设置了 K3S_URL
但没有设置 exec 命令,将默认命令为"`agent`"。
运行 agent 时,还必须设置 K3S_TOKEN
。
Version Gate
Available as of October 2024 releases: v1.28.15+k3s1, v1.29.10+k3s1, v1.30.6+k3s1, v1.31.2+k3s1. |
K3s will now use PATH
to find alternative container runtimes, in addition to checking the default paths used by the container runtime packages. In order to use this feature, you must modify the K3s service’s PATH environment variable to add the directories containing the container runtime binaries.
It’s recommended that you modify one of this two environment files:
-
/etc/default/k3s # or k3s-agent
-
/etc/sysconfig/k3s # or k3s-agent
This example will add the PATH
in /etc/default/k3s
:
echo PATH=$PATH >> /etc/default/k3s
|