mirrors/k3d
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

docs: add section about multi-master setups

Browse Source
This commit is contained in:
iwilltry42 2020-05-11 08:44:57 +02:00
parent c061104b53
commit dd2d5a6b70
No known key found for this signature in database
GPG Key ID: 7BA57AD1CFF16110
1 changed files with 25 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
docs/usage/multimaster.md Normal file
View File

@ -0,0 +1,25 @@
# Creating multi-master clusters
!!! note "Important note"
For the best results (and less unexpected issues), choose 1, 3, 5, ... master nodes.
## Embedded dqlite
Create a cluster with 3 master nodes using k3s' embedded dqlite database.
The first master 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 master nodes.
```bash
k3d create cluster multimaser --masters 3
```
## Adding master nodes to a running cluster
In theory (and also in practice in most cases), this is as easy as executing the following command:
```bash
k3d create node newmaster --cluster multimaster --role master
```
!!! note "There's a trap!"
If your cluster was initially created with only a single master node, then this will fail.
That's because the initial master node was not started with the `--cluster-init` flag and thus is not using the dqlite backend.