如何搭建swarm+etcd+docker环境

# 如何搭建Swarm+etcd+Docker环境 ## 前言 在现代分布式系统架构中，容器编排和集群管理是关键组成部分。本文将详细介绍如何搭建一个基于Docker Swarm（集群管理工具）、etcd（分布式键值存储）和Docker（容器运行时）的完整环境，适用于中小规模的生产部署或开发测试场景。 --- ## 环境准备 ### 硬件要求 - 至少3台Linux服务器（推荐Ubuntu 20.04/CentOS 7+） - 每台服务器2GB+内存，2核CPU - 10GB+可用磁盘空间 - 服务器间网络互通（建议内网千兆） ### 软件要求 - Docker 20.10+ - etcd v3.4+ - 所有节点时间同步（NTP服务） --- ## 第一部分：安装Docker 在所有节点上执行： ```bash # Ubuntu示例 sudo apt-get update sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io # 验证安装 sudo docker --version 

提示：生产环境建议配置docker daemon的cgroupdriver=systemd

---

第二部分：部署etcd集群

选择3个节点作为etcd集群成员：

1. 下载etcd二进制包

ETCD_VER=v3.4.18 wget https://github.com/etcd-io/etcd/releases/download/${ETCD_VER}/etcd-${ETCD_VER}-linux-amd64.tar.gz tar xzvf etcd-${ETCD_VER}-linux-amd64.tar.gz sudo mv etcd-${ETCD_VER}-linux-amd64/{etcd,etcdctl} /usr/local/bin/ 

2. 创建配置文件（以node1为例）

cat > /etc/etcd.conf <<EOF ETCD_NAME=node1 ETCD_DATA_DIR=/var/lib/etcd ETCD_LISTEN_PEER_URLS=http://0.0.0.0:2380 ETCD_LISTEN_CLIENT_URLS=http://0.0.0.0:2379 ETCD_INITIAL_ADVERTISE_PEER_URLS=http://<NODE1_IP>:2380 ETCD_ADVERTISE_CLIENT_URLS=http://<NODE1_IP>:2379 ETCD_INITIAL_CLUSTER="node1=http://<NODE1_IP>:2380,node2=http://<NODE2_IP>:2380,node3=http://<NODE3_IP>:2380" ETCD_INITIAL_CLUSTER_TOKEN=etcd-cluster ETCD_INITIAL_CLUSTER_STATE=new EOF 

3. 创建systemd服务

cat > /etc/systemd/system/etcd.service <<EOF [Unit] Description=etcd service After=network.target [Service] Type=notify EnvironmentFile=/etc/etcd.conf ExecStart=/usr/local/bin/etcd Restart=always [Install] WantedBy=multi-user.target EOF 

4. 启动服务

sudo systemctl daemon-reload sudo systemctl enable etcd sudo systemctl start etcd 

5. 验证集群状态

etcdctl --endpoints=http://<NODE1_IP>:2379 member list etcdctl endpoint health 

---

第三部分：搭建Docker Swarm集群

1. 初始化Swarm Manager（在第一个节点执行）

docker swarm init --advertise-addr <MANAGER_IP> 

2. 添加工作节点

复制生成的join命令在其他节点执行：

docker swarm join --token SWMTKN-1-xxxxxx <MANAGER_IP>:2377 

3. 配置Swarm使用etcd存储

修改docker daemon配置（所有节点）：

sudo mkdir -p /etc/docker cat > /etc/docker/daemon.json <<EOF { "cluster-store": "etcd://<ETCD_CLUSTER_IPS>:2379", "cluster-advertise": "<NODE_IP>:2377" } EOF sudo systemctl restart docker 

4. 验证Swarm集群

docker node ls docker info | grep -i swarm 

---

第四部分：部署测试服务

1. 创建overlay网络

docker network create --driver overlay my-net 

2. 部署示例服务

docker service create --name nginx --replicas 3 --network my-net -p 80:80 nginx:alpine 

3. 查看服务状态

docker service ls docker service ps nginx curl http://<ANY_NODE_IP>:80 

---

常见问题排查

1. 节点无法加入Swarm

• 检查防火墙规则（需开放2377/tcp,7946/tcp+udp,4789/udp）
• 验证token是否过期（使用docker swarm join-token worker重新生成）

2. etcd集群健康检查失败

• 检查节点间网络连通性
• 查看日志：journalctl -u etcd -f

3. 服务无法跨节点通信

• 确认overlay网络创建成功
• 检查docker network inspect my-net

---

结论

通过以上步骤，我们成功搭建了一个高可用的Docker Swarm集群，使用etcd作为分布式存储后端。这种架构提供了： - 容器编排能力 - 服务发现功能 - 集群状态持久化 - 故障自动恢复

后续可以进一步探索： - 集成CI/CD流水线 - 添加监控（Prometheus+Grafana） - 实现自动扩缩容 “`

（全文约1250字，实际字数可能因配置细节调整略有变化）