Where can I find definition of etc rancher k3s config yaml Particularly it seems disable syntax is ambiguous ```disable etcd ``` or ```disable etcd true``` <https rancher com docs k3s latest en installation disable flags > <https rancher com docs k3s latest en installation install options server config >

Where can I find definition of etc rancher k3s config yaml P rancher-users #k3s

#k3s

Title

# k3s

melodic-hamburger-23329

09/30/2022, 8:04 AM

Where can I find definition of /etc/rancher/k3s/config.yaml? Particularly, it seems disable syntax is ambiguous.

Copy code

disable:
  - "etcd"

Copy code

disable-etcd: true

https://rancher.com/docs/k3s/latest/en/installation/disable-flags/ https://rancher.com/docs/k3s/latest/en/installation/install-options/server-config/

creamy-pencil-82913

09/30/2022, 9:37 AM

There is no fixed syntax for the config.yaml. The keys/values are just translated directly to CLI flags and then passed into the flag parser.

I think you’re confused about the different flags though.

--disable=foo

take a list of disables for packaged components - one or more of the manifests such as coredns, traefik, metrics-server.

--disable-etcd=true

is a flag that disables a built-in controller, such as etcd, kube-apiserver, cloud-controller-manager, and so on. Each component has its own separate flag.

✅ 1

They are not ambiguous, they do different things, even though they might be similarly named.

You cannot use --disable=etcd to accomplish the same thing as --disable-etcd=true. etcd is an embedded controller, not a packaged component

melodic-hamburger-23329

10/02/2022, 11:24 PM

Thanks for clarification.

Might be good to have clearer parameter naming ^^; e.g.

--disable-manifest

and

--disable-internal

@creamy-pencil-82913 If I use --datastore-endpoint
for connecting to external etcd, should I pass

--disable-etcd=true

? What happens if I do/don’t disable embedded etcd?

creamy-pencil-82913

10/03/2022, 6:23 AM

--disable-etcd has no meaning if you’re not using embedded etcd elsewhere in the cluster

melodic-hamburger-23329

10/03/2022, 8:01 AM

@creamy-pencil-82913 I have one node cluster and etcd running in separate process to which I connect by passing --datastore-endpoint. Maybe I don’t quite understand the architecture, but if I try to disable the embedded etcd, k3s fails to boot. I would have assumed embedded etcd is not needed if using external one. Or maybe I have some misconfiguration… 🤔

creamy-pencil-82913

10/03/2022, 8:05 AM

Embedded etcd is not the default. It is only used if you start the server with --cluster-init to initialize a new etcd cluster, or use --server to point it at an existing cluster to join. If you want to use an external datastore, just do so. You don't have to disable anything.

2 Views