Docker集群：Worker节点创建Overlay网络失败及节点晋升歧义问题

一、工作节点创建Overlay网络失败的原因与解决 #

在工作节点ES13执行以下命令时报错：

sudo docker-compose -f config-certs.yml run --rm config_certs

报错信息：

Creating network "es-elastic" with driver "overlay"
ERROR: Cannot create a multi-host network from a worker node. Please create the network from a manager node.

原因 #

Docker Swarm中，工作节点无权限创建跨主机Overlay网络。即便管理节点已创建过同名网络，若config-certs.yml中网络配置未标记为外部网络（默认external: false），docker-compose仍会尝试在本地创建网络，触发权限报错。ES12执行正常是因为它实际为管理节点，具备对应权限。

临时解决（无需晋升节点） #

修改config-certs.yml中的网络配置，将已存在的Overlay网络标记为外部网络：

networks:
  es-elastic:
    external: true
    name: es-elastic

修改后重新执行命令，docker-compose会直接复用已存在的网络，不再尝试创建。

二、节点晋升时名称歧义错误的解决 #

在管理节点ES11执行晋升命令时报错：

sudo docker node promote ES13

报错信息：

Error response from daemon: node ES13 is ambiguous (2 matches found)

原因 #

集群中存在两个名称为ES13的节点（可能是旧节点残留或重复注册），导致通过名称匹配节点时出现歧义。

解决步骤 #

1. 列出集群所有节点，获取节点ID与状态：

sudo docker node ls

输出示例：

ID                            HOSTNAME   STATUS    AVAILABILITY   MANAGER STATUS   ENGINE VERSION
abc123...                     ES11       Ready     Active         Leader           24.0.6
def456...                     ES12       Ready     Active         Reachable        24.0.6
ghi789...                     ES13       Ready     Active         None             24.0.6
jkl012...                     ES13       Down      Drain          None             24.0.6

2. 使用目标节点的ID执行晋升命令，规避名称冲突：

sudo docker node promote ghi789...

3. 若存在重复的无效节点（如状态为Down的ES13），可清理删除：

sudo docker node rm jkl012...

内容的提问来源于stack exchange，提问作者Boodle