gregandev
/
k3d
mirror of https://github.com/k3d-io/k3d
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Little helper to run CNCF's k3s in Docker
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1360 Commits
16 Branches
164 Tags
69 MiB
 
 
 
 
Tag: Branch: Tree: e9babb7441
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'e9babb7441'
${ noResults }
k3d/docs/usage/multiserver.md

1.1 KiB
Raw Blame History

Creating multi-server clusters

!!! info "Important note" For the best results (and less unexpected issues), choose 1, 3, 5, ... server nodes. (Read more on etcd quorum on etcd.io) At least 2 cores and 4GiB of RAM are recommended.

Embedded etcd

Create a cluster with 3 server nodes using k3s' embedded etcd database. The first server to be created will use the --cluster-init flag and k3d will wait for it to be up and running before creating (and connecting) the other server nodes.

k3d cluster create multiserver --servers 3

Adding server nodes to a running cluster

In theory (and also in practice in most cases), this is as easy as executing the following command:

k3d node create newserver --cluster multiserver --role server

!!! important "There's a trap!" If your cluster was initially created with only a single server node, then this will fail.
That's because the initial server node was not started with the --cluster-init flag and thus is not using the etcd backend.