mirror of
https://github.com/rancher/rancher-docs.git
synced 2026-09-27 21:50:21 +00:00
Completely remove cli flags from single-server install page
- As discussed via slack with Craig, completely remove cli flags from this page -- This content was not helpful. It's the same as running the --help flag we didn't provide any context or additional info. -- At a later date we may cherry pick some of those cli flags and add more detail about them where necessary.
This commit is contained in:
David Nuzik
@@ -95,308 +95,3 @@ The full help text for the install script environment variables are as follows:
|
|||||||
Type of systemd service to create, will default from the k3s exec command
|
Type of systemd service to create, will default from the k3s exec command
|
||||||
if not specified.
|
if not specified.
|
||||||
|
|
||||||
Server Options
|
|
||||||
--------------
|
|
||||||
|
|
||||||
The following information on server options is also available through `k3s server --help` :
|
|
||||||
|
|
||||||
* `--bind-address` _value_
|
|
||||||
|
|
||||||
k3s bind address (default: localhost)
|
|
||||||
|
|
||||||
* `--https-listen-port` _value_
|
|
||||||
|
|
||||||
HTTPS listen port (default: 6443)
|
|
||||||
|
|
||||||
* `--http-listen-port` _value_
|
|
||||||
|
|
||||||
HTTP listen port (for /healthz, HTTPS redirect, and port for TLS terminating LB) (default: 0)
|
|
||||||
|
|
||||||
* `--data-dir` _value_, `-d` _value_
|
|
||||||
|
|
||||||
Folder to hold state default /var/lib/rancher/k3s or ${HOME}/.rancher/k3s if not root
|
|
||||||
|
|
||||||
* `--log` _value_, `-l` _value_
|
|
||||||
|
|
||||||
Log to file
|
|
||||||
|
|
||||||
* `--cluster-cidr` _value_
|
|
||||||
|
|
||||||
Network CIDR to use for pod IPs (default: "10.42.0.0/16")
|
|
||||||
|
|
||||||
* `--cluster-secret` _value_
|
|
||||||
|
|
||||||
Shared secret used to bootstrap a cluster [$`K3S_CLUSTER_SECRET`]
|
|
||||||
|
|
||||||
* `--service-cidr` _value_
|
|
||||||
|
|
||||||
Network CIDR to use for services IPs (default: "10.43.0.0/16")
|
|
||||||
|
|
||||||
* `--cluster-dns` _value_
|
|
||||||
|
|
||||||
Cluster IP for coredns service. Should be in your service-cidr range
|
|
||||||
|
|
||||||
* `--cluster-domain` _value_
|
|
||||||
|
|
||||||
Cluster Domain (default: "cluster.local")
|
|
||||||
|
|
||||||
* `--no-deploy` _value_
|
|
||||||
|
|
||||||
Do not deploy packaged components (valid items: coredns, servicelb, traefik)
|
|
||||||
|
|
||||||
* `--write-kubeconfig` _value_, `-o` _value_
|
|
||||||
|
|
||||||
Write kubeconfig for admin client to this file [$`K3S_KUBECONFIG_OUTPUT`]
|
|
||||||
|
|
||||||
* `--write-kubeconfig-mode` _value_
|
|
||||||
|
|
||||||
Write kubeconfig with this mode [$`K3S_KUBECONFIG_MODE`]
|
|
||||||
|
|
||||||
* `--tls-san` _value_
|
|
||||||
|
|
||||||
Add additional hostname or IP as a Subject Alternative Name in the TLS cert
|
|
||||||
|
|
||||||
* `--kube-apiserver-arg` _value_
|
|
||||||
|
|
||||||
Customized flag for kube-apiserver process
|
|
||||||
|
|
||||||
* `--kube-scheduler-arg` _value_
|
|
||||||
|
|
||||||
Customized flag for kube-scheduler process
|
|
||||||
|
|
||||||
* `--kube-controller-arg` _value_
|
|
||||||
|
|
||||||
Customized flag for kube-controller-manager process
|
|
||||||
|
|
||||||
* `--kube-cloud-controller-arg` _value_
|
|
||||||
|
|
||||||
Customized flag for kube-cloud-controller-manager process
|
|
||||||
|
|
||||||
* `--rootless`
|
|
||||||
|
|
||||||
(experimental) Run rootless
|
|
||||||
|
|
||||||
* `--storage-endpoint` _value_
|
|
||||||
|
|
||||||
Specify etcd, Mysql, Postgres, or Sqlite (default) data source name [$`K3S_STORAGE_ENDPOINT`]
|
|
||||||
|
|
||||||
* `--storage-cafile` _value_
|
|
||||||
|
|
||||||
SSL Certificate Authority file used to secure storage backend communication [$`K3S_STORAGE_CAFILE`]
|
|
||||||
|
|
||||||
* `--storage-certfile` _value_
|
|
||||||
|
|
||||||
SSL certification file used to secure storage backend communication [$`K3S_STORAGE_CERTFILE`]
|
|
||||||
|
|
||||||
* `--storage-keyfile` _value_
|
|
||||||
|
|
||||||
SSL key file used to secure storage backend communication [$`K3S_STORAGE_KEYFILE`]
|
|
||||||
|
|
||||||
* `--advertise-address` _value_
|
|
||||||
|
|
||||||
IP address that apiserver uses to advertise to members of the cluster
|
|
||||||
|
|
||||||
* `--advertise-port` _value_
|
|
||||||
|
|
||||||
Port that apiserver uses to advertise to members of the cluster (default: 0)
|
|
||||||
|
|
||||||
* `--disable-scheduler`
|
|
||||||
|
|
||||||
Disable Kubernetes default scheduler
|
|
||||||
|
|
||||||
* `--disable-cloud-controller`
|
|
||||||
|
|
||||||
Disable k3s default cloud controller manager
|
|
||||||
|
|
||||||
* `--disable-network-policy`
|
|
||||||
|
|
||||||
Disable k3s default network policy controller
|
|
||||||
|
|
||||||
* `--default-local-storage-path` _value_
|
|
||||||
|
|
||||||
Default local storage path for local provisioner storage class
|
|
||||||
|
|
||||||
* `--node-ip` _value_, `-i` _value_
|
|
||||||
|
|
||||||
(agent) IP address to advertise for node
|
|
||||||
|
|
||||||
* `--node-name` _value_
|
|
||||||
|
|
||||||
(agent) Node name [$`K3S_NODE_NAME`]
|
|
||||||
|
|
||||||
* `--docker`
|
|
||||||
|
|
||||||
(agent) Use docker instead of containerd
|
|
||||||
|
|
||||||
* `--no-flannel`
|
|
||||||
|
|
||||||
(agent) Disable embedded flannel
|
|
||||||
|
|
||||||
* `--flannel-iface` _value_
|
|
||||||
|
|
||||||
(agent) Override default flannel interface
|
|
||||||
|
|
||||||
* `--flannel-conf` _value_
|
|
||||||
|
|
||||||
(agent) (experimental) Override default flannel config file
|
|
||||||
|
|
||||||
* `--flannel-backend` _value_
|
|
||||||
|
|
||||||
(agent) Specify the flannel backend you would like to use: vxlan (default), ipsec, or wireguard
|
|
||||||
|
|
||||||
* `--container-runtime-endpoint` _value_
|
|
||||||
|
|
||||||
(agent) Disable embedded containerd and use alternative CRI implementation
|
|
||||||
|
|
||||||
* `--pause-image` _value_
|
|
||||||
|
|
||||||
(agent) Customized pause image for containerd sandbox
|
|
||||||
|
|
||||||
* `--resolv-conf` _value_
|
|
||||||
|
|
||||||
(agent) Kubelet resolv.conf file [$`K3S_RESOLV_CONF`]
|
|
||||||
|
|
||||||
* `--kubelet-arg` _value_
|
|
||||||
|
|
||||||
(agent) Customized flag for kubelet process
|
|
||||||
|
|
||||||
* `--kube-proxy-arg` _value_
|
|
||||||
|
|
||||||
(agent) Customized flag for kube-proxy process
|
|
||||||
|
|
||||||
* `--node-label` _value_
|
|
||||||
|
|
||||||
(agent) Registering kubelet with set of labels
|
|
||||||
|
|
||||||
* `--node-taint` _value_
|
|
||||||
|
|
||||||
(agent) Registering kubelet with set of taints
|
|
||||||
|
|
||||||
* `--private-registry` _value_
|
|
||||||
|
|
||||||
(agent) Private registry configuration file (default: "/etc/rancher/k3s/registries.yaml")
|
|
||||||
|
|
||||||
* `--node-external-ip` _value_
|
|
||||||
|
|
||||||
(agent) External IP address to advertise for node
|
|
||||||
|
|
||||||
Agent Options
|
|
||||||
------------------
|
|
||||||
|
|
||||||
The following information on agent options is also available through `k3s agent --help` :
|
|
||||||
|
|
||||||
* `--token` _value_, `-t` _value_
|
|
||||||
|
|
||||||
Token to use for authentication [$`K3S_TOKEN`]
|
|
||||||
|
|
||||||
* `--token-file` _value_
|
|
||||||
|
|
||||||
Token file to use for authentication [$`K3S_TOKEN_FILE`]
|
|
||||||
|
|
||||||
* `--server` _value_, `-s` _value_
|
|
||||||
|
|
||||||
Server to connect to [$`K3S_URL`]
|
|
||||||
|
|
||||||
* `--data-dir` _value_, `-d` _value_
|
|
||||||
|
|
||||||
Folder to hold state (default: "/var/lib/rancher/k3s")
|
|
||||||
|
|
||||||
* `--cluster-secret` _value_
|
|
||||||
|
|
||||||
Shared secret used to bootstrap a cluster [$`K3S_CLUSTER_SECRET`]
|
|
||||||
|
|
||||||
* `--rootless`
|
|
||||||
|
|
||||||
(experimental) Run rootless
|
|
||||||
|
|
||||||
* `--docker`
|
|
||||||
|
|
||||||
(agent) Use docker instead of containerd
|
|
||||||
|
|
||||||
* `--no-flannel`
|
|
||||||
|
|
||||||
(agent) Disable embedded flannel
|
|
||||||
|
|
||||||
* `--flannel-iface` _value_
|
|
||||||
|
|
||||||
(agent) Override default flannel interface
|
|
||||||
|
|
||||||
* `--flannel-conf` _value_
|
|
||||||
|
|
||||||
(agent) (experimental) Override default flannel config file
|
|
||||||
|
|
||||||
* `--node-name` _value_
|
|
||||||
|
|
||||||
(agent) Node name [$`K3S_NODE_NAME`]
|
|
||||||
|
|
||||||
* `--node-ip` _value_, `-i` _value_
|
|
||||||
|
|
||||||
(agent) IP address to advertise for node
|
|
||||||
|
|
||||||
* `--container-runtime-endpoint` _value_
|
|
||||||
|
|
||||||
(agent) Disable embedded containerd and use alternative CRI implementation
|
|
||||||
|
|
||||||
* `--pause-image` _value_
|
|
||||||
|
|
||||||
(agent) Customized pause image for containerd sandbox
|
|
||||||
|
|
||||||
* `--resolv-conf` _value_
|
|
||||||
|
|
||||||
(agent) Kubelet resolv.conf file [$`K3S_RESOLV_CONF`]
|
|
||||||
|
|
||||||
* `--kubelet-arg` _value_
|
|
||||||
|
|
||||||
(agent) Customized flag for kubelet process
|
|
||||||
|
|
||||||
* `--kube-proxy-arg` _value_
|
|
||||||
|
|
||||||
(agent) Customized flag for kube-proxy process
|
|
||||||
|
|
||||||
* `--node-label` _value_
|
|
||||||
|
|
||||||
(agent) Registering kubelet with set of labels
|
|
||||||
|
|
||||||
* `--node-taint` _value_
|
|
||||||
|
|
||||||
(agent) Registering kubelet with set of taints
|
|
||||||
|
|
||||||
* `--private-registry` _value_
|
|
||||||
|
|
||||||
(agent) Private registry configuration file (default: "/etc/rancher/k3s/registries.yaml")
|
|
||||||
|
|
||||||
* `--node-external-ip` _value_
|
|
||||||
|
|
||||||
(agent) External IP address to advertise for node
|
|
||||||
|
|
||||||
Customizing components
|
|
||||||
----------------------
|
|
||||||
|
|
||||||
As of v0.3.0 any of the following processes can be customized with extra flags:
|
|
||||||
|
|
||||||
* `--kube-apiserver-arg` _value_
|
|
||||||
|
|
||||||
(server) [kube-apiserver options](https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/)
|
|
||||||
|
|
||||||
* `--kube-controller-arg` _value_
|
|
||||||
|
|
||||||
(server) [kube-controller-manager options](https://kubernetes.io/docs/reference/command-line-tools-reference/kube-controller-manager/)
|
|
||||||
|
|
||||||
* `--kube-scheduler-arg` _value_
|
|
||||||
|
|
||||||
(server) [kube-scheduler options](https://kubernetes.io/docs/reference/command-line-tools-reference/kube-scheduler/)
|
|
||||||
|
|
||||||
* `--kubelet-arg` _value_
|
|
||||||
|
|
||||||
(agent) [kubelet options](https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/)
|
|
||||||
|
|
||||||
* `--kube-proxy-arg` _value_
|
|
||||||
|
|
||||||
(agent) [kube-proxy options](https://kubernetes.io/docs/reference/command-line-tools-reference/kube-proxy/)
|
|
||||||
|
|
||||||
Adding extra arguments can be done by passing the following flags to server or agent.
|
|
||||||
For example to add the following arguments `-v=9` and `log-file=/tmp/kubeapi.log` to the kube-apiserver, you should add the following options to k3s server:
|
|
||||||
|
|
||||||
```
|
|
||||||
--kube-apiserver-arg v=9 --kube-apiserver-arg log-file=/tmp/kubeapi.log
|
|
||||||
```
|
|
||||||
|
|||||||
Reference in New Issue
Block a user