K3s Agent 配置参考

配置

日志

集群选项

数据

节点

运行时

网络

注意：
如果你想直接设置 kubelet 的 ​--resolv-conf​ 值，请使用 ​--kubelet-arg=resolv-conf=value​。只有在设置为有效的 resolv.conf 文件路径时，k3s 标志才会传递给 kubelet。

定制标志

实验性

弃用

Agent 节点的 标签和污点

K3s agent 可以用​--node-label​和​--node-taint​这两个选项进行配置，这两个选项可以给 kubelet 添加标签和污点。这两个选项只在注册时添加标签和/或污点，所以只能添加一次，之后不能再通过运行 K3s 命令来改变。

下面这个例子来说明如何添加标签和污点：

     --node-label foo=bar \
     --node-label hello=world \
     --node-taint key1=value1:NoExecute

如果你想在节点注册后更改节点标签和污点，你应该使用​kubectl​。

K3s Agent CLI 帮助

如果一个选项出现在下面的括号里，例如​[$K3S_URL]​，则意味着该选项可以作为该名称的环境变量传递进来。

名称:
   k3s agent - 运行agent节点

使用:
   k3s agent [选项]

选项:
   --config FILE, -c FILE                     (config) 通过文件加载配置 (默认值："/etc/rancher/k3s/config.yaml") [$K3S_CONFIG_FILE]
   --debug                                    (logging) 打开 debug 日志 [$K3S_DEBUG]
   -v value                                   (logging) 日志级别详细程度的数字 (默认值：0)
   --vmodule value                            (logging) 以逗号分隔的 pattern=N 设置列表，用于文件过滤的日志记录
   --log value, -l value                      (logging) 记录到文件
   --alsologtostderr                          (logging) 记录到标准错误输出和文件（如果设置）
   --token value, -t value                    (cluster) 用于身份认证的 token [$K3S_TOKEN]
   --token-file value                         (cluster) 用于身份认证的 token 文件 [$K3S_TOKEN_FILE]
   --server value, -s value                   (cluster) 要连接的 k3s Server [$K3S_URL]
   --data-dir value, -d value                 (agent/data) 存储数据的目录 (默认值："/var/lib/rancher/k3s")
   --node-name value                          (agent/node) 节点名 [$K3S_NODE_NAME]
   --with-node-id                             (agent/node) 将 ID 添加到节点名后
   --node-label value                         (agent/node) 使用标签组来注册和启动 kubelet
   --node-taint value                         (agent/node) 使用污点组来注册 kubelet
   --image-credential-provider-bin-dir value  (agent/node) 凭证提供商插件二进制文件的路径 (默认值："/var/lib/rancher/credentialprovider/bin")
   --image-credential-provider-config value   (agent/node) 凭证提供商插件配置文件的路径 (默认值："/var/lib/rancher/credentialprovider/config.yaml")
   --docker                                   (agent/runtime) 用 docker 代替 containerd
   --container-runtime-endpoint value         (agent/runtime) 禁用嵌入式 containerd，使用替代的 CRI 实现
   --pause-image value                        (agent/runtime) 针对 containerd 或 docker sandbox 的自定义 pause 镜像 (默认值："rancher/mirrored-pause:3.6")
   --snapshotter value                        (agent/runtime) 覆盖默认的 containerd snapshotter (默认值："overlayfs")
   --private-registry value                   (agent/runtime) 私有镜像仓库配置文件 (默认值："/etc/rancher/k3s/registries.yaml")
   --node-ip value, -i value                  (agent/networking) 发布节点的 IPv4/IPv6 地址
   --node-external-ip value                   (agent/networking) 对外发布节点的 IPv4/IPv6 IP 地址
   --resolv-conf value                        (agent/networking) Kubelet resolv.conf 文件 [$K3S_RESOLV_CONF]
   --flannel-iface value                      (agent/networking) 覆盖默认的 flannel 接口
   --flannel-conf value                       (agent/networking) 覆盖默认的 flannel 配置文件
   --kubelet-arg value                        (agent/flags) kubelet 进程的自定义标志
   --kube-proxy-arg value                     (agent/flags) kube-proxy 进程的自定义标志
   --protect-kernel-defaults                  (agent/node) 内核调优参数。如果设置，且内核的可设参数与 kubelet 默认值不同，则会出现错误
   --rootless                                 (experimental) 运行 rootless
   --selinux                                  (agent/node) 在 containerd 中启动 SELinux [$K3S_SELINUX]
   --lb-server-port value                     (agent/node) Supervisor 客户端负载均衡器的本地端口。如果 supervisor 和 apiserver 不在同一地点，则 apiserver 客户端负载均衡器也将使用比该端口少 1 的额外端口 (默认值：6444) [$K3S_LB_SERVER_PORT]
   --no-flannel                               (deprecated) 使用 --flannel-backend=none
   --cluster-secret value                     (deprecated) 使用 --token [$K3S_CLUSTER_SECRET]