Kubernetes之etcd数据库备份与恢复

最新推荐文章于 2025-05-02 09:30:00 发布

GottdesKrieges

最新推荐文章于 2025-05-02 09:30:00 发布

阅读量454

点赞数 1

CC 4.0 BY-SA版权

分类专栏： Docker & K8S 文章标签： kubernetes etcd

本文链接：https://blog.youkuaiyun.com/Sebastien23/article/details/129475545

Docker & K8S 专栏收录该内容

42 篇文章

订阅专栏

本文详细介绍了如何在kubeadm部署和二进制部署的Kubernetes集群中对etcd数据库进行备份和恢复。备份过程涉及使用etcdctl工具，而恢复步骤包括暂停关键服务，恢复数据库，然后重新启动服务。在kubeadm部署中，需注意etcd容器的管理以及集群状态的维护；在二进制部署中，涉及systemctl命令来控制服务的启停。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

将etcd容器中的etcdctl命令拷贝到宿主机：

kubectl cp kube-system/etcd-k8s-master:/usr/local/etcdctl /root/

或者直接yum安装etcd包：

yum install etcd -y

etcdctl 3.3的默认API版本为2，与版本3的差别较大。在命令前加上ETCDCTL_API=3来调用版本3接口。

[root@k8s-master ~]# etcdctl --version
etcdctl version: 3.3.11
API version: 2

kubeadm部署方式

备份

ETCDCTL_API=3 etcdctl snapshot save snap_230312.db \
--endpoints=https://127.0.0.1:2379 \
--cacert=/etc/kubernetes/pki/etcd/ca.crt \
--cert=/etc/kubernetes/pki/etcd/server.crt \
--key=/etc/kubernetes/pki/etcd/server.key

恢复

暂停kube-apiserver和etcd容器

mv /etc/kubernetes/manifests /etc/kubernetes/manifests.bak
mv /var/lib/etcd/ /var/lib/etcd.bak

etcd容器所在Pod是kubelet管理的静态Pod，删除后会自动拉起。移除/etc/kubernetes/manifests下的yaml配置文件后，k8s集群会挂掉，etcd容器也不会自动拉起了。

恢复数据库

ETCDCTL_API=3 etcdctl snapshot restore snap_230312.db --data-dir=/var/lib/etcd

启动kube-apiserver和etcd容器

mv /etc/kubernetes/manifests.bak /etc/kubernetes/manifests

二进制部署方式

备份

ETCDCTL_API=3 etcdctl snapshot save snap_230313.db \
--endpoints=https://192.168.33.x:2379 \
--cacert=/opt/etcd/ssl/ca.pem \
--cert=/opt/etcd/ssl/server.pem \
--key=/opt/etcd/ssl/server-key.pem

恢复

暂停kube-apiserver和etcd容器

systemctl stop kube-apiserver
systemctl stop etcd
mv /var/lib/etcd/default.etcd /var/lib/etcd/default.etcd.bak

在所有节点上恢复

ETCDCTL_API=3 etcdctl snapshot restore snap_230313.db --name etcd-1 \
--initial-cluster="etcd-1=https://192.168.33.a:2380, etcd-2=https://192.168.33.b:2380, etcd-3=https://192.168.33.c:2380" \
--initial-cluster-token=etcd-cluster \
--initial-advertise-peer-urls=https://192.168.33.a:2380 \
--data-dir=/var/lib/etcd/default.etcd

启动kube-apiserver和etcd容器

systemctl start kube-apiserver
systemctl start etcd

References
【1】https://kubernetes.io/zh-cn/docs/tasks/administer-cluster/configure-upgrade-etcd/
【2】https://etcd.io/docs/v3.6/op-guide/recovery/#restoring-a-cluster