K3s Server 配置參考

常用選項(xiàng)

數(shù)據(jù)庫(kù)

集群選項(xiàng)

客戶端選項(xiàng)

Agent 選項(xiàng)

K3s agent 選項(xiàng)是可以作為 server 選項(xiàng)的，因?yàn)?nbsp;server 內(nèi)部嵌入了 agent 進(jìn)程。

Agent 節(jié)點(diǎn)

Agent 運(yùn)行時(shí)

Agent 網(wǎng)絡(luò)

Agent 選項(xiàng)之所以存在，是因?yàn)?nbsp;server 內(nèi)嵌了 agent 進(jìn)程

高級(jí)選項(xiàng)

日志

監(jiān)聽(tīng)

Data

網(wǎng)絡(luò)

定制標(biāo)志

存儲(chǔ)類(lèi)

Kubernetes 組件

Kubernetes 進(jìn)程定制標(biāo)志

實(shí)驗(yàn)性選項(xiàng)

廢棄的選項(xiàng)

K3s Server CLI 幫助

如果一個(gè)選項(xiàng)出現(xiàn)在下面的括號(hào)里，例如?[$K3S_TOKEN]?，則意味著該選項(xiàng)可以作為該名稱的環(huán)境變量傳遞進(jìn)來(lái)。

NAME:
   k3s server - 運(yùn)行K3s server

USAGE:
   k3s server [選項(xiàng)]

選項(xiàng):
   --config FILE, -c FILE                     (config) 從FILE加載配置（默認(rèn)："/etc/rancher/k3s/config.yaml" ） [$K3S_CONFIG_FILE]
   --debug                                    (logging) 開(kāi)啟debug調(diào)試日志 [$K3S_DEBUG]
   -v value                                   (logging) 日志級(jí)別詳細(xì)程度的數(shù)字 (默認(rèn): 0)
   --vmodule value                            (logging) 以逗號(hào)分隔的pattern=N設(shè)置列表，用于文件過(guò)濾的日志記錄
   --log value, -l value                      (logging) 記錄到文件
   --alsologtostderr                          (logging) 記錄到標(biāo)準(zhǔn)錯(cuò)誤輸出和文件（如果設(shè)置)
   --bind-address value                       (listener) k3s綁定地址 (默認(rèn): 0.0.0.0)
   --https-listen-port value                  (listener) HTTPS監(jiān)聽(tīng)端口 (默認(rèn): 6443)
   --advertise-address value                  (listener) apiserver用來(lái)向集群成員發(fā)布的IP地址 (默認(rèn): node-external-ip/node-ip)
   --advertise-port value                     (listener) apiserver用于通告集群成員的端口 (默認(rèn): listen-port) (默認(rèn): 0)
   --tls-san value                            (listener) 在TLS證書(shū)中添加其他主機(jī)名或IP作為主題備用名稱
   --data-dir value, -d value                 (data) 存放數(shù)據(jù)的目錄 默認(rèn) /var/lib/rancher/k3s or ${HOME}/.rancher/k3s(如果不是root用戶)
   --cluster-cidr value                       (networking) 用于Pod IP的網(wǎng)絡(luò)CIDR (默認(rèn): "10.42.0.0/16")
   --service-cidr value                       (networking) 用于service IP的網(wǎng)絡(luò)CIDR (默認(rèn): "10.43.0.0/16")
   --service-node-port-range value            (networking) 為具有 NodePort 可見(jiàn)性的服務(wù)保留的端口范圍 (默認(rèn): "30000-32767")
   --cluster-dns value                        (networking) 用于coredns服務(wù)的集群IP。應(yīng)該在您的`service-cidr`范圍內(nèi) (默認(rèn): 10.43.0.10)
   --cluster-domain value                     (networking) 集群域名 (默認(rèn): "cluster.local")
   --flannel-backend value                    (networking) 'none', 'vxlan', 'ipsec', 'host-gw', 或 'wireguard'中的一個(gè) (默認(rèn): "vxlan")
   --token value, -t value                    (cluster) 用于將server或agent加入集群的共享secret。 [$K3S_TOKEN]
   --token-file value                         (cluster) 包含cluster-secret/token的文件 [$K3S_TOKEN_FILE]
   --write-kubeconfig value, -o value         (client) 將管理客戶端的kubeconfig寫(xiě)入這個(gè)文件。 [$K3S_KUBECONFIG_OUTPUT]
   --write-kubeconfig-mode value              (client) 用這種模式編寫(xiě)kubeconfig，例如：644 [$K3S_KUBECONFIG_MODE]
   --etcd-arg value                           (flags) 自定義etcd進(jìn)程的參數(shù)
   --kube-apiserver-arg value                 (flags) 自定義kube-apiserver進(jìn)程的參數(shù)
   --kube-scheduler-arg value                 (flags) 自定義kube-scheduler進(jìn)程的參數(shù)
   --kube-controller-manager-arg value        (flags) 自定義kube-controller-manager進(jìn)程的參數(shù)
   --kube-cloud-controller-manager-arg value  (flags) 自定義kube-cloud-controller-manager進(jìn)程的參數(shù)
   --datastore-endpoint value                 (db) 指定 etcd、Mysql、Postgres 或 Sqlite（默認(rèn)）數(shù)據(jù)源名稱 [$K3S_DATASTORE_ENDPOINT]
   --datastore-cafile value                   (db) TLS證書(shū)授權(quán)文件，用于確保數(shù)據(jù)存儲(chǔ)后端通信的安全 [$K3S_DATASTORE_CAFILE]
   --datastore-certfile value                 (db) TLS認(rèn)證文件，用于確保數(shù)據(jù)存儲(chǔ)后端通信的安全 [$K3S_DATASTORE_CERTFILE]
   --datastore-keyfile value                  (db) 用于保護(hù)數(shù)據(jù)存儲(chǔ)后端通信的TLS密鑰文件 [$K3S_DATASTORE_KEYFILE]
   --etcd-expose-metrics                      (db) 將 etcd 指標(biāo)公開(kāi)給客戶端界面。(默認(rèn)為 false)
   --etcd-disable-snapshots                   (db) 禁用自動(dòng) etcd 快照
   --etcd-snapshot-name value                 (db) 設(shè)置 etcd 快照的基本名稱。默認(rèn)值: etcd-snapshot
   --etcd-snapshot-schedule-cron value        (db) cron 規(guī)范中的快照間隔時(shí)間。 例如。每 5 小時(shí) "\* \*/5 \* \* \*" (默認(rèn)值: "0 \*/12 \* \* \*")
   --etcd-snapshot-retention value            (db) 要保留的快照數(shù)量 (默認(rèn)值: 5)
   --etcd-snapshot-dir value                  (db) 保存數(shù)據(jù)庫(kù)快照的目錄. (默認(rèn) location: ${data-dir}/db/snapshots)
   --etcd-s3                                  (db) 啟用備份到 S3
   --etcd-s3-endpoint value                   (db) S3 endpoint url (默認(rèn)值: "s3.amazonaws.com")
   --etcd-s3-endpoint-ca value                (db) S3 自定義 CA 證書(shū)連接到 S3 endpoint
   --etcd-s3-skip-ssl-verify                  (db) 禁用 S3 的 SSL 證書(shū)驗(yàn)證
   --etcd-s3-access-key value                 (db) S3 access key [$AWS_ACCESS_KEY_ID]
   --etcd-s3-secret-key value                 (db) S3 secret key [$AWS_SECRET_ACCESS_KEY]
   --etcd-s3-bucket value                     (db) S3 bucket 名稱
   --etcd-s3-region value                     (db) S3 region / bucket 位置 (可選) 默認(rèn)值: "us-east-1")
   --etcd-s3-folder value                     (db) S3 文件夾
   --default-local-storage-path value         (storage) 本地存儲(chǔ)類(lèi)的默認(rèn)存儲(chǔ)路徑
   --disable value                            (components) 不需要部署的組件，刪除任何已部署的組件 (有效項(xiàng)目：coredns, servicelb, traefik,local-storage, metrics-server)
   --disable-scheduler                        (components) 禁用Kubernetes默認(rèn)調(diào)度器
   --disable-cloud-controller                 (components) 禁用k3s默認(rèn)云控制管理器
   --disable-kube-proxy                       (components) 禁止運(yùn)行 kube-proxy
   --disable-network-policy                   (components) 用K3S默認(rèn)網(wǎng)絡(luò)策略控制器
   --node-name value                          (agent/node) 節(jié)點(diǎn)名稱 [$K3S_NODE_NAME]
   --with-node-id                             (agent/node) 將ID附加到節(jié)點(diǎn)名稱
   --node-label value                         (agent/node) 用一組標(biāo)簽注冊(cè)和啟動(dòng)kubelet
   --node-taint value                         (agent/node) 用一組污點(diǎn)注冊(cè)kubelet
   --image-credential-provider-bin-dir value  (agent/node) 憑證提供程序插件二進(jìn)制文件所在目錄的路徑（默認(rèn)："/var/lib/rancher/credentialprovider/bin"）
   --image-credential-provider-config value   (agent/node) 憑證提供者插件配置文件的路徑 (默認(rèn)： "/var/lib/rancher/credentialprovider/config.yaml")
   --docker                                   (agent/runtime) 用docker代替containerd
   --container-runtime-endpoint value         (agent/runtime) 禁用嵌入式containerd，使用替代的CRI實(shí)現(xiàn)
   --pause-image value                        (agent/runtime) 針對(duì)containerd或Docker的自定義pause鏡像 (默認(rèn): "docker.io/rancher/pause:3.1")
   --snapshotter value                        (agent/runtime) 覆蓋默認(rèn)的 containerd 快照程序 (默認(rèn): "overlayfs")
   --private-registry value                   (agent/runtime) 私有鏡像倉(cāng)庫(kù)配置文件 (默認(rèn): "/etc/rancher/k3s/registries.yaml")
   --node-ip value, -i value                  (agent/networking) 為節(jié)點(diǎn)發(fā)布的IP地址
   --node-external-ip value                   (agent/networking) 對(duì)外發(fā)布節(jié)點(diǎn)的IP地址
   --resolv-conf value                        (agent/networking) Kubelet resolv.conf 文件 [$K3S_RESOLV_CONF]
   --flannel-iface value                      (agent/networking) 覆蓋默認(rèn)的flannel接口
   --flannel-conf value                       (agent/networking) 覆蓋默認(rèn)的flannel文件
   --kubelet-arg value                        (agent/flags) 自定義kubelet進(jìn)程的參數(shù)
   --kube-proxy-arg value                     (agent/flags) 自定義kube-proxy進(jìn)程的參數(shù)
   --protect-kernel-defaults                  (agent/node) 內(nèi)核調(diào)優(yōu)行為。如果設(shè)置，如果內(nèi)核可調(diào)參數(shù)與 kubelet 默認(rèn)值不同，則會(huì)出錯(cuò)。
   --rootless                                 (experimental) 運(yùn)行 rootless
   --agent-token value                        (experimental/cluster) 用于將agent加入集群但不用于server的共享密鑰 [$K3S_AGENT_TOKEN]
   --agent-token-file value                   (experimental/cluster) 包含agent secret的文件 [$K3S_AGENT_TOKEN_FILE]
   --server value, -s value                   (experimental/cluster) 要連接的k3s server，用于加入集群 [$K3S_URL]
   --cluster-init                             (experimental/cluster) 初始化為新的集群master [$K3S_CLUSTER_INIT]
   --cluster-reset                            (experimental/cluster) 忽略所有節(jié)點(diǎn)，成為一個(gè)新集群的集群master [$K3S_CLUSTER_RESET]
   --cluster-reset-restore-path value         (db) 要恢復(fù)的快照文件的路徑
   --secrets-encryption                       (experimental) 啟用Secret加密
   --system-default-registry value            (image) 用于所有系統(tǒng)鏡像的私有注冊(cè)表 [$K3S_SYSTEM_DEFAULT_REGISTRY]
   --selinux                                  (agent/node) 在 containerd 中啟用 SELinux [$K3S_SELINUX]
   --lb-server-port value                     (agent/node) 客戶端負(fù)載均衡器的本地端口。如果 supervisor 和 apiserver 不在同一個(gè)主機(jī)，則 apiserver 客戶端負(fù)載均衡器也將使用比該端口小 1 的額外端口。(默認(rèn)：6444) [$K3S_LB_SERVER_PORT]
   --no-flannel                               (deprecated) 使用 --flannel-backend=none
   --no-deploy value                          (deprecated) 不需要部署的組件 (有效選項(xiàng): coredns, servicelb, traefik, local-storage, metrics-server)
   --cluster-secret value                     (deprecated) 使用 --token [$K3S_CLUSTER_SECRET]