【ETCD】【实操篇（十五）】etcd集群成员管理：如何高效地添加、删除与更新节点

张声录12024-12-27 11:45

etcd 是一个高可用的分布式键值存储，广泛应用于存储服务发现、配置管理等场景。为了确保集群的稳定性和可扩展性，管理成员节点的添加、删除和更新变得尤为重要。本文将指导您如何在etcd集群中处理成员管理，帮助您高效地维护集群节点。

目录

        • [1. etcc集群成员管理概述](#1. etcc集群成员管理概述)
        • [2. 准备工作(如果有对应的ETCD集群则跳过该步骤)](#2. 准备工作(如果有对应的ETCD集群则跳过该步骤))
        • [3. 获取集群成员信息](#3. 获取集群成员信息)
        • [4. 删除集群成员](#4. 删除集群成员)
        • [5. 添加新成员](#5. 添加新成员)
        • [6. 启动新节点](#6. 启动新节点)
        • [7. 注意事项](#7. 注意事项)
        • [8. 总结](#8. 总结)
1. etcc集群成员管理概述

etcd集群由多个节点组成，每个节点都可以通过一个peer URL与其他节点通信。当您需要对集群中的节点进行动态扩展或维护时，etcd 提供了丰富的命令来添加、删除和更新节点的成员身份。通过这些操作，您可以实现集群的高可用性和扩展性。

2. 准备工作(如果有对应的ETCD集群则跳过该步骤)

在操作集群之前，我们需要确保有一个正在运行的etcd集群。如果没有，您可以参考以下命令启动一个3节点的etcd集群：

bash 复制代码 
@echo off
REM 设置通用参数
set TOKEN=token-01
set CLUSTER_STATE=new
set NAME_1=machine-1
set NAME_2=machine-2
set NAME_3=machine-3
set HOST_1=127.0.0.1
set HOST_2=127.0.0.1
set HOST_3=127.0.0.1
set PEER_PORT_1=2380
set PEER_PORT_2=2381
set PEER_PORT_3=2382
set CLIENT_PORT_1=2379
set CLIENT_PORT_2=2383
set CLIENT_PORT_3=2384
set CLUSTER=%NAME_1%=http://%HOST_1%:%PEER_PORT_1%,%NAME_2%=http://%HOST_2%:%PEER_PORT_2%,%NAME_3%=http://%HOST_3%:%PEER_PORT_3%

REM 创建目录存储 etcd 数据
mkdir data.etcd1
mkdir data.etcd2
mkdir data.etcd3

REM 启动第一个 etcd 实例
start etcd.exe --data-dir=data.etcd1 --name %NAME_1% ^
    --initial-advertise-peer-urls http://%HOST_1%:%PEER_PORT_1% --listen-peer-urls http://%HOST_1%:%PEER_PORT_1% ^
    --advertise-client-urls http://%HOST_1%:%CLIENT_PORT_1% --listen-client-urls http://%HOST_1%:%CLIENT_PORT_1% ^
    --initial-cluster %CLUSTER% ^
    --initial-cluster-state %CLUSTER_STATE% --initial-cluster-token %TOKEN% ^
    --log-level debug

REM 启动第二个 etcd 实例
start etcd.exe --data-dir=data.etcd2 --name %NAME_2% ^
    --initial-advertise-peer-urls http://%HOST_2%:%PEER_PORT_2% --listen-peer-urls http://%HOST_2%:%PEER_PORT_2% ^
    --advertise-client-urls http://%HOST_2%:%CLIENT_PORT_2% --listen-client-urls http://%HOST_2%:%CLIENT_PORT_2% ^
    --initial-cluster %CLUSTER% ^
    --initial-cluster-state %CLUSTER_STATE% --initial-cluster-token %TOKEN% ^
    --log-level debug

REM 启动第三个 etcd 实例
start etcd.exe --data-dir=data.etcd3 --name %NAME_3% ^
    --initial-advertise-peer-urls http://%HOST_3%:%PEER_PORT_3% --listen-peer-urls http://%HOST_3%:%PEER_PORT_3% ^
    --advertise-client-urls http://%HOST_3%:%CLIENT_PORT_3% --listen-client-urls http://%HOST_3%:%CLIENT_PORT_3% ^
    --initial-cluster %CLUSTER% ^
    --initial-cluster-state %CLUSTER_STATE% --initial-cluster-token %TOKEN% ^
    --log-level debug

echo All etcd instances started with debug logging. Press any key to exit...
pause

运行以上脚本可以创建一个新的集群。

以上命令启动了3个etcd节点，并配置了初始集群。

如果是在linux上，可以使用下面的脚本进行创建。

sh 复制代码 
#!/bin/bash

# 设置通用参数
TOKEN="token-01"
CLUSTER_STATE="new"
NAME_1="machine-1"
NAME_2="machine-2"
NAME_3="machine-3"
HOST_1="127.0.0.1"
HOST_2="127.0.0.1"
HOST_3="127.0.0.1"
PEER_PORT_1=2380
PEER_PORT_2=2381
PEER_PORT_3=2382
CLIENT_PORT_1=2379
CLIENT_PORT_2=2383
CLIENT_PORT_3=2384
CLUSTER="${NAME_1}=http://${HOST_1}:${PEER_PORT_1},${NAME_2}=http://${HOST_2}:${PEER_PORT_2},${NAME_3}=http://${HOST_3}:${PEER_PORT_3}"

# 创建目录存储 etcd 数据
mkdir -p /data/deploy/data.etcd1
mkdir -p /data/deploy/data.etcd2
mkdir -p /data/deploy/data.etcd3

# 启动第一个 etcd 实例
nohup etcd --data-dir=/data/deploy/data.etcd1 --name ${NAME_1} \
    --initial-advertise-peer-urls http://${HOST_1}:${PEER_PORT_1} --listen-peer-urls http://${HOST_1}:${PEER_PORT_1} \
    --advertise-client-urls http://${HOST_1}:${CLIENT_PORT_1} --listen-client-urls http://${HOST_1}:${CLIENT_PORT_1} \
    --initial-cluster ${CLUSTER} \
    --initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN} \
    --log-level debug &

# 启动第二个 etcd 实例
nohup etcd --data-dir=/data/deploy/data.etcd2 --name ${NAME_2} \
    --initial-advertise-peer-urls http://${HOST_2}:${PEER_PORT_2} --listen-peer-urls http://${HOST_2}:${PEER_PORT_2} \
    --advertise-client-urls http://${HOST_2}:${CLIENT_PORT_2} --listen-client-urls http://${HOST_2}:${CLIENT_PORT_2} \
    --initial-cluster ${CLUSTER} \
    --initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN} \
    --log-level debug &

# 启动第三个 etcd 实例
nohup etcd --data-dir=/data/deploy/data.etcd3 --name ${NAME_3} \
    --initial-advertise-peer-urls http://${HOST_3}:${PEER_PORT_3} --listen-peer-urls http://${HOST_3}:${PEER_PORT_3} \
    --advertise-client-urls http://${HOST_3}:${CLIENT_PORT_3} --listen-client-urls http://${HOST_3}:${CLIENT_PORT_3} \
    --initial-cluster ${CLUSTER} \
    --initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN} \
    --log-level debug &

echo "所有etcd实例已启动，正在运行中..."
3. 获取集群成员信息

在对成员进行操作之前，首先需要获取当前集群成员的列表。使用以下命令：

bash 复制代码 
etcdctl endpoint status --cluster -w table --endpoints=http://127.0.0.1:2379,http://127.0.0.1:2383,http://127.0.0.1:2384

这个命令会列出集群中所有成员的详细信息，包括每个节点的ID。

4. 删除集群成员

如果某个节点需要从集群中移除，可以通过以下步骤进行操作：

  1. 获取需要删除的节点ID（如上一步获取成员列表时看到的）。
  2. 使用member remove命令将其移除。

例如，删除节点ID为 bf9071f4639c75cc的成员：

bash 复制代码 
etcdctl --endpoints=http://127.0.0.1:2379,http://127.0.0.1:2383,http://127.0.0.1:2384  member remove  8231876619f7abe6
5. 添加新成员

如果您希望向集群中添加一个新的节点（例如节点machine-4），可以使用member add命令：

bash 复制代码 
etcdctl --endpoints=http://127.0.0.1:2383,http://127.0.0.1:2384 member add machine-4 --peer-urls=http://127.0.0.1:2386

此命令会将新节点加入集群，并为其指定peer URL。

6. 启动新节点

在新节点添加到集群后，需要启动该节点。注意，此时需要使用--initial-cluster-state existing标记，因为集群状态已经存在。启动命令如下：

bash 复制代码 
etcd --data-dir=data.etcd4 --name machine-4 --initial-advertise-peer-urls http://127.0.0.1:2386 --listen-peer-urls http://127.0.0.1:2386 --advertise-client-urls http://127.0.0.1:2385 --listen-client-urls http://127.0.0.1:2385 --initial-cluster machine-1=http://127.0.0.1:2380,machine-4=http://127.0.0.1:2386,machine-2=http://127.0.0.1:2381 --initial-cluster-state existing --initial-cluster-token token-01

这个命令启动了新节点，并将其加入现有的etcd集群。

检查新的集群：

sh 复制代码 
etcdctl endpoint status --cluster -w table --endpoints=http://127.0.0.1:2385,http://127.0.0.1:2383,http://127.0.0.1:2379
7. 注意事项
  1. 节点数据清理： 在将节点移除后，如果您计划重新使用该节点，确保清理节点的旧数据，以避免出现不一致的状态。
  2. 集群状态： 启动新节点时，--initial-cluster-state existing标志至关重要，确保新节点不会初始化一个新的集群，而是加入到现有集群。
  3. 高可用性： 在生产环境中操作节点时，务必确保操作不会影响集群的高可用性，可以考虑在操作之前进行备份。
8. 总结

通过以上步骤，您可以轻松地管理etcd集群中的节点成员，无论是添加、删除还是更新。etcd提供了强大的命令行工具，可以帮助我们维护一个高效且稳定的集群。希望本文能够帮助您更好地理解etcd集群成员管理的基本操作。

相关推荐
KATA~16 分钟前
解决MyBatis-Plus枚举映射错误：No enum constant问题
java·数据库·mybatis
xyliiiiiL32 分钟前
一文总结常见项目排查
java·服务器·数据库
shaoing33 分钟前
MySQL 错误 报错：Table ‘performance_schema.session_variables’ Doesn’t Exist
java·开发语言·数据库
用户62799471826235 分钟前
南大通用GBase 8s 获取表的约束与索引列信息
数据库
Arbori_262151 小时前
获取oracle表大小
数据库·oracle
王强你强1 小时前
MySQL 高级查询：JOIN、子查询、窗口函数
数据库·mysql
草巾冒小子1 小时前
brew 安装mysql，启动，停止，重启
数据库·mysql
用户6279947182621 小时前
南大通用GBase 8c分布式版本gha_ctl 命令-HI参数详解
数据库
斯汤雷1 小时前
Matlab绘图案例，设置图片大小，坐标轴比例为黄金比
数据库·人工智能·算法·matlab·信息可视化
SQLplusDB1 小时前
Oracle 23ai Vector Search 系列之3 集成嵌入生成模型（Embedding Model）到数据库示例，以及常见错误
数据库·oracle·embedding
热门推荐
01我决定放弃搞 Java 了02DeepSeek各版本说明与优缺点分析03如何在WPS和Word/Excel中直接使用DeepSeek功能04RAG 实践- Ollama+RagFlow 部署本地知识库05苍穹外卖面试总结06从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑07本地化部署AI知识库：基于Ollama+DeepSeek+AnythingLLM保姆级教程08DeepSeek R1本地化部署 Ollama + Chatbox 打造最强 AI 工具09如何本地部署AI智能体平台，带你手搓一个AI Agent10Android下HWC以及drm_hwcomposer普法(上)