public/rancher-docs
1
0
Fork 0
mirror of https://github.com/rancher/rancher-docs.git synced 2026-05-28 07:35:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

Promote etcd to stable as of 1.19.5 (#2903)

Browse Source 
* Promote etcd to stable as of 1.19.5
* Update the document accordingly to call out that in 1.19.5 and newer, embedded etcd is no longer considered experimental
* Update as per review comments
* Completely remove dqlite section - it was depreciated for quite a while.
This commit is contained in:
David Nuzik
2020-12-11 12:27:57 -07:00
committed by GitHub
parent 1fbe73d851
commit 97eb1a514a
1 changed files with 4 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/k3s/latest/en/installation/ha-embedded/_index.md
+4 -20
View File
@@ -1,17 +1,11 @@
---
title: "High Availability with Embedded DB (Experimental)"
title: "High Availability with Embedded DB"
weight: 40
---
K3s is previewing support for running a highly available control plane without the need for an external database. This means there is no need to manage an external etcd or SQL datastore.
In K3s 1.0.0, Dqlite was used as the experimental embedded database. In K3s v1.19.1+, embedded etcd is used.
Please note that upgrades from experimental Dqlite to experimental embedded etcd are not supported. If you attempt an upgrade it will not succeed and data will be lost.
### Embedded etcd (Experimental)
_Available as of K3s v1.19.1_
>**Notice:**
K3s has added full support for embedded etcd as of release v1.19.5+k3s1. Versions v1.19.1 thru v1.19.4 provide only experimental support for embedded etcd.
Embedded etcd replaced experimental Dqlite in the K3s v1.19.1 release. This is a breaking change. Please note that upgrades from experimental Dqlite to embedded etcd are not supported. If you attempt an upgrade it will not succeed and data will be lost.
To run K3s in this mode, you must have an odd number of server nodes. We recommend starting with three nodes.
@@ -26,13 +20,3 @@ K3S_TOKEN=SECRET k3s server --server https://<ip or hostname of server1>:6443
```
Now you have a highly available control plane. Joining additional worker nodes to the cluster follows the same procedure as a single server cluster.
### Embedded Dqlite (Deprecated)
> **Warning:** Experimental etcd replaced experimental Dqlite in the K3s v1.19.1 release. This is a breaking change. Please note that upgrades from experimental Dqlite to experimental embedded etcd are not supported. If you attempt an upgrade it will not succeed and data will be lost.
As of v1.0.0, K3s previewed support for running a highly available control plane without the need for an external database.
This architecture is achieved by embedding a Dqlite database within the K3s server process. DQLite is short for "distributed SQLite." According to https://dqlite.io, it is "*a fast, embedded, persistent SQL database with Raft consensus that is perfect for fault-tolerant IoT and Edge devices.*"
To run K3s with the embedded Dqlite database, follow the same steps as the [embedded etcd database](#embedded-etcd-experimental) using a K3s release between v1.0.0 and v1.19.1.