etcd报错：etcdserver: mvcc: database space exceeded

最新推荐文章于 2025-01-16 11:04:56 发布

katy的小乖

最新推荐文章于 2025-01-16 11:04:56 发布

阅读量2.2k

点赞数 1

分类专栏： etcd

原文链接：https://blog.csdn.net/zhangxiangui40542/article/details/80800369

版权

etcd 专栏收录该内容

2 篇文章

订阅专栏

本文介绍如何使用Docker部署ETCD服务，并通过调整关键参数如--auto-compaction-retention, --max-request-bytes 和 --quota-backend-bytes来避免数据超出配额限制，确保服务稳定运行。

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

docker部署etcd

部署etcd，并把etcd数据挂载出来，防止数据丢失

docker run -d --network host -e ETCDCTL_API=3 --restart always \
--volume=/var/lib/katy/etcd:/etcd-data \
--name etcd quay.io/coreos/etcd:latest \
/usr/local/bin/etcd \
--data-dir=/etcd-data --name node1 \
--initial-advertise-peer-urls http://0.0.0.0:2380 --listen-peer-urls http://0.0.0.0:2380 \
--advertise-client-urls http://0.0.0.0:2379 --listen-client-urls http://0.0.0.0:2379 \
--initial-cluster node1=http://0.0.0.0:2380

确认数据是否真的超出配额

进入etcd容器查看etcd数据是否超出配额

etcdctl --write-out=table endpoint status
+----------------+------------------+---------+---------+-----------+------------+-----------+------------+--------------------+--------------------------------+
|    ENDPOINT    |        ID        | VERSION | DB SIZE | IS LEADER | IS LEARNER | RAFT TERM | RAFT INDEX | RAFT APPLIED INDEX |             ERRORS             |
+----------------+------------------+---------+---------+-----------+------------+-----------+------------+--------------------+--------------------------------+
| 127.0.0.1:2379 | 8e9e05c52164694d |  3.4.14 |  2.1 GB |      true |      false |         4 |    1716275 |            1716275 |  memberID:10276657743932975437 |
|                |                  |         |         |           |            |           |            |                    |                 alarm:NOSPACE  |
+----------------+------------------+---------+---------+-----------+------------+-----------+------------+--------------------+--------------------------------+

查看告警

ETCDCTL_API=3 etcdctl alarm list
memberID:10276657743932975437 alarm:NOSPACE

查看目录文件大小

/etcd-data$ du -sh *
2.1G	snap
495M	wal

可以确认，etcd数据目录大小与etcd设置的配额一致了，因此别的数据再也写不进去了。

数据备份

ETCDCTL_API=3 etcdctl snapshot save backup.db
ETCDCTL_API=3 etcdctl snapshot status backup.db

etcd参数调整

--auto-compaction-retention

由于ETCD数据存储多版本数据，随着写入的主键增加历史版本需要定时清理，默认的历史数据是不会清理的，数据达到2G就不能写入，必须要清理压缩历史数据才能继续写入;所以根据业务需求，在上生产环境之前就提前确定，历史数据多长时间压缩一次;推荐一小时压缩一次数据这样可以极大的保证集群稳定，减少内存和磁盘占用

--max-request-bytes

etcd Raft消息最大字节数，ETCD默认该值为1.5M; 但是很多业务场景发现同步数据的时候1.5M完全没法满足要求，所以提前确定初始值很重要;由于1.5M导致我们线上的业务无法写入元数据的问题，我们紧急升级之后把该值修改为默认32M，但是官方推荐的是10M，大家可以根据业务情况自己调整

--quota-backend-bytes

ETCD db数据大小，默认是2G，当数据达到2G的时候就不允许写入，必须对历史数据进行压缩才能继续写入;参加1里面说的，我们启动的时候就应该提前确定大小，官方推荐是8G，修改为使用32G的配置。

docker run -d --network host -e ETCDCTL_API=3 --restart always \
--volume=/var/lib/katy/etcd:/etcd-data \
--name etcd quay.io/coreos/etcd:latest \
/usr/local/bin/etcd \
--data-dir=/etcd-data --name node1 \
--auto-compaction-retention=1 \
--max-request-bytes=33554432 \
--quota-backend-bytes=34359738368 \
--initial-advertise-peer-urls http://0.0.0.0:2380 --listen-peer-urls http://0.0.0.0:2380 \
--advertise-client-urls http://0.0.0.0:2379 --listen-client-urls http://0.0.0.0:2379 \
--initial-cluster node1=http://0.0.0.0:2380