|
本文档采用自动化机器翻译技术翻译。 尽管我们力求提供准确的译文,但不对翻译内容的完整性、准确性或可靠性作出任何保证。 若出现任何内容不一致情况,请以原始 英文 版本为准,且原始英文版本为权威文本。 |
环境变量
如快速入门指南中所述,您可以使用位于https://get.k3s.io的安装脚本在基于systemd和openrc的系统上安装K3s作为服务。
此命令的最简单形式如下:
curl -sfL https://get.k3s.io | INSTALL_K3S_ARTIFACT_URL=<PRIME-ARTIFACTS-URL>/k3s sh -
使用此方法安装K3s时,可以使用以下环境变量来配置安装:
| 环境变量 | 说明 |
|---|---|
|
如果设置为true,将不会下载K3s的哈希或二进制文件。 |
|
默认情况下,如果命令在路径中不存在,将为kubectl、crictl和ctr二进制文件创建符号链接。如果设置为’skip',将不会创建符号链接;如果设置为’force',将覆盖。 |
|
如果设置为true,将不会启用或启动K3s服务。 |
|
如果设置为true,将不会启动K3s服务。 |
|
要从Github下载的K3s版本。如果未指定,将尝试从稳定通道下载。 |
|
安装K3s二进制文件、链接和卸载脚本的目录,或使用`/usr/local/bin`作为默认值。 |
|
如果设置为true,将不会写入文件到`INSTALL_K3S_BIN_DIR`,强制设置`INSTALL_K3S_SKIP_DOWNLOAD=true`。 |
|
安装systemd服务和环境文件的目录,或使用`/etc/systemd/system`作为默认值。 |
|
用于启动K3s服务的命令及其标志。如果未指定命令,并且设置了`K3S_URL`,则默认为"agent"。如果未设置`K3S_URL`,则默认为"server"。有关帮助,请参阅此示例。 |
|
要创建的systemd服务名称,如果作为服务器运行k3s,则默认为’k3s',如果作为代理运行k3s,则默认为’k3s-agent'。如果指定,名称将以’k3s-'为前缀。 |
|
要创建的systemd服务类型,如果未指定,将从K3s执行命令中默认获取。 |
|
如果设置为true,将在未找到 k3s-selinux 策略时继续执行。 |
|
如果设置为true,将跳过 k3s RPM 的自动安装。 |
|
用于获取 K3s 下载 URL 的通道 URL。默认为 https://update.k3s.io/v1-release/channels. |
|
用于获取 K3s 下载 URL 的通道。默认为 "stable"。选项包括: |
此示例显示了在管道后放置上述环境变量作为选项的位置:
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
|
对 |