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
该标志指定节点加入主设备时节点的可用性。可能的可用性值active
,pause
或drain
。
这个标志在某些情况下很有用。例如,群集可能希望具有专用管理器节点,这些节点不用作工作者节点。这可以通过传递--availability=drain
来实现docker swarm join
。