title: K3s Agent配置参考 description: 在本节中,您将学习如何配置 K3s agent keywords:

  • k3s中文文档
  • k3s 中文文档
  • k3s中文
  • k3s 中文
  • k3s
  • k3s教程
  • k3s中国
  • rancher
  • k3s 中文教程
  • 安装介绍
  • K3s Agent配置参考

在本节中,您将学习如何配置 K3s agent。

在整个 K3s 文档中,你会看到一些选项可以作为命令标志和环境变量传递进来。关于传入选项的帮助,请参考如何使用标志和环境变量。

日志

Flag 默认值 描述
-v value 0 日志级别详细程度的数字
--vmodule value N/A 以逗号分隔的 pattern=N 设置列表,用于文件过滤的日志记录
--log value, -l value N/A 记录到文件
--alsologtostderr N/A 记录到标准错误输出和文件(如果设置)

集群选项

Flag 环境变量 描述
--token value, -t value K3S_TOKEN 用于身份认证的 token
--token-file value K3S_TOKEN_FILE 用于身份认证的 token 文件
--server value, -s value K3S_URL 要连接的 k3s Server

数据

Flag 默认值 描述
--data-dir value, -d value “/var/lib/rancher/k3s” 存放数据的目录

节点

Flag 环境变量 描述
--node-name value K3S_NODE_NAME 节点名称
--with-node-id N/A 将 ID 附加到节点名称
--node-label value N/A 用一组标签注册和启动 kubelet。
--node-taint value N/A 用一组污点注册 kubelet

运行时

Flag 默认值 描述
--docker N/A 用 docker 代替 containerd
--container-runtime-endpoint value N/A 禁用嵌入式 containerd,使用替代的 CRI 实现
--pause-image value “docker.io/rancher/pause:3.1” 针对 containerd 或 Docker 的自定义 pause 镜像 (agent/runtime) (默认)
--private-registry value “/etc/rancher/k3s/registries.yaml” 私有镜像仓库配置文件

网络

Flag 环境变量 描述
--node-ip value, -i value N/A 为节点发布的 IP 地址
--node-external-ip value N/A 对外发布节点的 IP 地址
--resolv-conf value K3S_RESOLV_CONF Kubelet resolv.conf 文件
--flannel-iface value N/A 覆盖默认的 flannel 接口
--flannel-conf value N/A 覆盖默认的 flannel 文件

定制标志

Flag 描述
--kubelet-arg value 自定义 kubelet 进程的参数
--kube-proxy-arg value 自定义 kube-proxy 进程的参数

实验性

Flag 描述
--rootless 运行 rootless

弃用

Flag 环境变量 描述
--no-flannel N/A 使用 --flannel-backend=none
--cluster-secret value K3S_CLUSTER_SECRET 使用 --token

Agent 节点的 标签和污点

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

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

  1. --node-label foo=bar \
  2. --node-label hello=world \
  3. --node-taint key1=value1:NoExecute

如果你想在节点注册后更改节点标签和污点,你应该使用kubectl。关于如何添加taintsnode labels.,请参考 Kubernetes 官方文档。

K3s Agent CLI 帮助

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

  1. 名称:
  2. k3s agent - 运行agent节点
  3. 使用:
  4. k3s agent [选项]
  5. 选项:
  6. -v value (logging) 日志级别详细程度的数字 (默认: 0)
  7. --vmodule value (logging) 以逗号分隔的pattern=N设置列表,用于文件过滤的日志记录
  8. --log value, -l value (logging) 记录到文件
  9. --alsologtostderr (logging) 记录到标准错误输出和文件(如果设置)
  10. --token value, -t value (cluster) 用于身份认证的token [$K3S_TOKEN]
  11. --token-file value (cluster) 用于身份认证的token文件 [$K3S_TOKEN_FILE]
  12. --server value, -s value (cluster) 要连接的k3s Server [$K3S_URL]
  13. --data-dir value, -d value (agent/data) 存放数据的目录 (默认: "/var/lib/rancher/k3s")
  14. --node-name value (agent/node) Node name [$K3S_NODE_NAME]
  15. --with-node-id (agent/node) ID附加到节点名称
  16. --node-label value (agent/node) 用一组标签注册和启动kubelet
  17. --node-taint value (agent/node) 用一组污点注册kubelet
  18. --docker (agent/runtime) docker代替containerd
  19. --container-runtime-endpoint value (agent/runtime) 禁用嵌入式containerd,使用替代的CRI实现
  20. --pause-image value (agent/runtime) 针对containerdDocker的自定义pause镜像(默认: "docker.io/rancher/pause:3.1")
  21. --private-registry value (agent/runtime) 私有镜像仓库配置文件 (默认: "/etc/rancher/k3s/registries.yaml")
  22. --node-ip value, -i value (agent/networking) 为节点发布的IP地址
  23. --node-external-ip value (agent/networking) 对外发布节点的IP地址
  24. --resolv-conf value (agent/networking) Kubelet resolv.conf 文件 [$K3S_RESOLV_CONF]
  25. --flannel-iface value (agent/networking) 覆盖默认的flannel接口
  26. --flannel-conf value (agent/networking) 覆盖默认的flannel文件
  27. --kubelet-arg value (agent/flags) 自定义kubelet进程的参数
  28. --kube-proxy-arg value (agent/flags) 自定义kube-proxy进程的参数
  29. --rootless (experimental) 运行 rootless
  30. --no-flannel (deprecated) 使用 --flannel-backend=none
  31. --cluster-secret value (deprecated) 使用 --token [$K3S_CLUSTER_SECRET]