在线文档教程
Docker 17
引擎: CLI | Engine: CLI

docker swarm join

docker swarm join

描述

作为节点和/或管理器加入群集

使用

docker swarm join [OPTIONS] HOST:PORT

备选方案

名字,简写默认描述
--advertise-addr 通告地址(格式:<ip | interface>:端口)
--availability active 节点的可用性(“活动”|“暂停”|“漏”)
--data-path-addr 用于数据路径流量的地址或接口(格式:<ip | interface>)
--listen-addr 0.0.0.0:2377监听地址(格式:<ip | interface>:端口)
--token进入群的令牌

父命令

命令描述
docker swarm 管理群

相关命令

命令描述
docker 群管理根CA
docker 群初始化初始化一个群
docker 群加入加入群体作为节点和/或经理
docker 群联合令牌管理联合令牌
docker 群离开离开群
docker 群解锁解锁群
docker 群解锁键管理解锁密钥
docker 群更新更新群体

扩展描述

将一个节点加入群中。根据您使用该--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。

加入现有群时,此标志通常不是必需的。

--data-path-addr

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

--token string

节点加入群所需的秘密值。

--availability

该标志指定节点加入主设备时节点的可用性。可能的可用性值activepausedrain

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