From 97eb1a514a250fe98f624a7640455e2e2f27a168 Mon Sep 17 00:00:00 2001 From: David Nuzik <45179589+davidnuzik@users.noreply.github.com> Date: Fri, 11 Dec 2020 12:27:57 -0700 Subject: [PATCH] Promote etcd to stable as of 1.19.5 (#2903) * 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. --- .../en/installation/ha-embedded/_index.md | 24 ++++--------------- 1 file changed, 4 insertions(+), 20 deletions(-) diff --git a/content/k3s/latest/en/installation/ha-embedded/_index.md b/content/k3s/latest/en/installation/ha-embedded/_index.md index 6693efb4e73..6b940fc02c9 100644 --- a/content/k3s/latest/en/installation/ha-embedded/_index.md +++ b/content/k3s/latest/en/installation/ha-embedded/_index.md @@ -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://: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. \ No newline at end of file