本文档采用自动化机器翻译技术翻译。 尽管我们力求提供准确的译文,但不对翻译内容的完整性、准确性或可靠性作出任何保证。 若出现任何内容不一致情况,请以原始 英文 版本为准,且原始英文版本为权威文本。

环境变量

快速入门指南中所述,您可以使用位于https://get.k3s.io的安装脚本在基于systemd和openrc的系统上安装K3s作为服务。

此命令的最简单形式如下:

curl -sfL https://get.k3s.io | INSTALL_K3S_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/k3s sh -

使用此方法安装K3s时,可以使用以下环境变量来配置安装:

环境变量 说明

INSTALL_K3S_SKIP_DOWNLOAD

如果设置为true,将不会下载K3s的哈希或二进制文件。

INSTALL_K3S_SYMLINK

默认情况下,如果命令在路径中不存在,将为kubectl、crictl和ctr二进制文件创建符号链接。如果设置为’skip',将不会创建符号链接;如果设置为’force',将覆盖。

INSTALL_K3S_SKIP_ENABLE

如果设置为true,将不会启用或启动K3s服务。

INSTALL_K3S_SKIP_START

如果设置为true,将不会启动K3s服务。

INSTALL_K3S_VERSION

要从Github下载的K3s版本。如果未指定,将尝试从稳定通道下载。

INSTALL_K3S_BIN_DIR

安装K3s二进制文件、链接和卸载脚本的目录,或使用`/usr/local/bin`作为默认值。

INSTALL_K3S_BIN_DIR_READ_ONLY

如果设置为true,将不会写入文件到`INSTALL_K3S_BIN_DIR`,强制设置`INSTALL_K3S_SKIP_DOWNLOAD=true`。

INSTALL_K3S_SYSTEMD_DIR

安装systemd服务和环境文件的目录,或使用`/etc/systemd/system`作为默认值。

INSTALL_K3S_EXEC

用于启动K3s服务的命令及其标志。如果未指定命令,并且设置了`K3S_URL`,则默认为"agent"。如果未设置`K3S_URL`,则默认为"server"。有关帮助,请参阅此示例。

INSTALL_K3S_NAME

要创建的systemd服务名称,如果作为服务器运行k3s,则默认为’k3s',如果作为代理运行k3s,则默认为’k3s-agent'。如果指定,名称将以’k3s-'为前缀。

INSTALL_K3S_TYPE

要创建的systemd服务类型,如果未指定,将从K3s执行命令中默认获取。

INSTALL_K3S_SELINUX_WARN

如果设置为true,将在未找到 k3s-selinux 策略时继续执行。

INSTALL_K3S_SKIP_SELINUX_RPM

如果设置为true,将跳过 k3s RPM 的自动安装。

INSTALL_K3S_CHANNEL_URL

用于获取 K3s 下载 URL 的通道 URL。默认为 https://update.k3s.io/v1-release/channels.

INSTALL_K3S_CHANNEL

用于获取 K3s 下载 URL 的通道。默认为 "stable"。选项包括:stablelatesttesting

此示例显示了在管道后放置上述环境变量作为选项的位置:

curl -sfL https://get.k3s.io | INSTALL_K3S_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/k3s INSTALL_K3S_CHANNEL=latest sh -

K3S_ 开头的环境变量将被保留供 systemd 和 openrc 服务使用。

设置 K3S_URL 而不显式设置 exec 命令将默认命令设置为 "agent"。

运行代理时,必须同时设置 K3S_TOKEN

版本门控

自 2024 年 10 月发布以来可用:v1.28.15+k3s1、v1.29.10+k3s1、v1.30.6+k3s1、v1.31.2+k3s1。

K3s 现在将使用 PATH 查找替代容器运行时,此外还会检查容器运行时软件包使用的默认路径。为了使用此功能,您必须修改 K3s 服务的 PATH 环境变量,以添加包含容器运行时二进制文件的目录。

建议您修改这两个环境文件中的一个:

  • /etc/default/k3s # 或 k3s-agent

  • /etc/sysconfig/k3s # 或 k3s-agent

此示例将在 PATH 中添加 /etc/default/k3s

echo PATH=$PATH >> /etc/default/k3s

PATH 的更改应谨慎进行,以避免将不受信任的二进制文件放置在以 root 身份运行的服务的路径中。