docker swarm加入

描述

加入一群人作为节点和/或管理者

API 1.24+  客户端和守护程序API都必须至少为 1.24, 才能使用此命令。docker version在客户端上使用命令检查客户端和守护程序API版本。

Swarm此命令与Swarm协调器一起使用。

用法

$ docker swarm join [OPTIONS] HOST:PORT

扩展说明

将节点加入群集。该节点根据您传递的带有--token标志的令牌加入为管理者节点或辅助节点。如果传递管理员令牌,则该节点将作为管理员加入。如果传递工作程序令牌,则该节点将作为工作程序加入。

有关此命令的示例用法,请参阅下面的示例部分

选项

名称,简写 默认 描述
--advertise-addr 广告地址(格式:<ip | interface> [:port])
--availability active 节点的可用性(“活动” |“暂停” |“漏极”)
--data-path-addr API 1.31+
用于数据路径通信的地址或接口(格式:<ip | interface>)
--listen-addr 0.0.0.0:2377 监听地址(格式:<ip | interface> [:port])
--token 进入群体的代币

例子

加入节点,以管理员身份蜂拥而至

下面的示例演示使用管理者令牌加入管理者节点。

$ docker swarm join --token SWMTKN-1-3pu6hszjas19xyp7ghgosyx9k8atbfcr8p2is99znpy26u2lkl-7p73s1dx5in4tatdymyhg9hu2 192.168.99.121:2377
This node joined a swarm as a manager.
$ docker node ls
ID                           HOSTNAME  STATUS  AVAILABILITY  MANAGER STATUS
dkp8vy1dq1kxleu9g4u78tlag *  manager2  Ready   Active        Reachable
dvfxp4zseq4s0rih1selh0d20    manager1  Ready   Active        Leader

集群最多只能有3-7个管理器,因为必须有大多数管理器才能使集群正常运行。不应参与此管理仲裁的节点应改为作为工作人员加入。管理器应为具有静态IP地址的稳定主机。

加入节点以工人的身份蜂拥而至

下面的示例演示使用工作程序令牌加入工作程序节点。

$ docker swarm join --token SWMTKN-1-3pu6hszjas19xyp7ghgosyx9k8atbfcr8p2is99znpy26u2lkl-1awxwuwd3z9j1z3puu7rcgdbx 192.168.99.121:2377
This node joined a swarm as a worker.
$ docker node ls
ID                           HOSTNAME  STATUS  AVAILABILITY  MANAGER STATUS
7ln70fl22uw2dvjn2ft53m3q5    worker2   Ready   Active
dkp8vy1dq1kxleu9g4u78tlag    worker1   Ready   Active        Reachable
dvfxp4zseq4s0rih1selh0d20 *  manager1  Ready   Active        Leader

--listen-addr value

如果该节点是管理者,则它将侦听此地址上的入站群管理器流量。默认值为监听0.0.0.0:2377。还可以指定一个网络接口以监听该接口的地址。例如--listen-addr eth0:2377

指定端口是可选的。如果该值为裸IP地址或接口名称,则将使用默认端口2377。

加入现有群时,通常不需要此标志。

--advertise-addr value

此标志指定将向群的其他成员通告以供API访问的地址。如果未指定,则Docker将检查系统是否具有单个IP地址,并将该IP地址与侦听端口一起使用(请参阅参考资料 --listen-addr)。如果系统具有多个IP地址,则--advertise-addr 必须指定该地址,以便为管理者之间的通信和覆盖网络选择正确的地址。

还可以指定一个网络接口来通告该接口的地址。例如--advertise-addr eth0:2377

指定端口是可选的。如果该值为裸IP地址或接口名称,则将使用默认端口2377。

加入现有群时,通常不需要此标志。如果要通过负载均衡器加入新节点,则应使用此标志来确保该节点发布其IP地址而不是负载均衡器的IP地址。

--data-path-addr

此标志指定全局范围网络驱动程序将发布到其他节点的地址,以到达在此节点上运行的容器。然后,使用此参数可以将容器的数据流量与群集的管理流量分开。如果未指定,则Docker将使用与发布地址相同的IP地址或接口。

--token string

节点加入群所需的秘密值

--availability

该标志指定节点加入主服务器时节点的可用性。可能的可用性值activepausedrain

该标志在某些情况下很有用。例如,集群可能希望拥有不充当工作程序节点的专用管理器节点。这可以通过传递--availability=drain给来实现docker swarm join

上级命令

命令 描述
码头工人 管理群
命令 描述
docker swarm ca 显示并旋转根CA
docker swarm初始化 初始化一群
docker swarm加入 加入一群人作为节点和/或管理者
docker swarm连接令牌 管理加入令牌
码头群离开 离开群
码头群解锁 解锁群
泊坞窗群解锁密钥 管理解锁密钥
docker swarm更新 更新群