跳到主要内容

具有嵌入式数据库的高可用

版本

完全支持 v1.19.5+k3s1
实验性支持 v1.19.1+k3s1

注意：已弃用 Dqlite

在 K3s v1.19.1 中，嵌入式 etcd 取代了实验性的 Dqlite。这是一个突破性的变化。请注意，不支持从实验性 Dqlite 升级到嵌入式 etcd。如果你尝试升级，升级将不会成功，并且数据将会丢失。

警告

嵌入式 etcd (HA) 在速度较慢的磁盘（例如使用 SD 卡运行的 Raspberry Pi）上可能会出现性能问题。

新集群​

要在这种模式下运行 K3s，你必须拥有奇数个 Server 节点。我们建议从三个节点开始。

首先，启动一个带有 cluster-init 标志的 Server 节点来启用集群和一个令牌，该令牌将作为共享 secret，用于将其他服务器加入集群。

curl -sfL https://get.k3s.io | K3S_TOKEN=SECRET sh -s - server --cluster-init
备注

中国用户，可以使用以下方法加速安装：

curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn K3S_TOKEN=SECRET sh -s - server --cluster-init

启动第一台服务器后，使用共享 secret 将第二台和第三台服务器加入集群：

curl -sfL https://get.k3s.io | K3S_TOKEN=SECRET sh -s - server --server https://<ip or hostname of server1>:6443
备注

中国用户，可以使用以下方法加速安装：

curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn K3S_TOKEN=SECRET sh -s - server --server https://<ip or hostname of server1>:6443

检查第二个和第三个服务器是否已加入集群：

$ kubectl get nodes
NAME        STATUS   ROLES                       AGE   VERSION
server1     Ready    control-plane,etcd,master   28m   vX.Y.Z
server2     Ready    control-plane,etcd,master   13m   vX.Y.Z

现在你有了一个高可用的 control plane。你可以在 --server 参数中使用任何集群 server，从而加入额外的 server 和 worker 节点。将其他 worker 节点加入到集群中，步骤与单个 server 集群相同。

有几个配置标志在所有 Server 节点中必须是相同的:

  • 网络相关标志：--cluster-dns、--cluster-domain、--cluster-cidr、--service- cidr
  • 控制某些组件部署的标志：--disable-helm-controller、--disable-kube-proxy、--disable-network-policy 和任何传递给 --disable 的组件
  • 功能相关标志：--secrets-encryption

现有集群​

如果你有一个使用默认嵌入式 SQLite 数据库的现有集群，你可以通过使用 --cluster-init 标志重新启动你的 K3s server，从而将其转换为 etcd。完成此操作后，你将能够如上所述添加其他实例。

如果由于节点已经初始化或加入了一个集群，导致在磁盘上发现一个 etcd 数据存储，那么数据存储参数（--cluster-init、--server、--datastore-endpoint 等）将被忽略。

重要提示：K3s v1.22.2 及更高版本支持将 SQLite 迁移到 etcd。如果你将 --cluster-init 添加到现有 server，旧版本将创建一个新的空数据存储。