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
该标志指定节点加入主服务器时节点的可用性。可能的可用性值active
,pause
或drain
。
该标志在某些情况下很有用。例如,集群可能希望拥有不充当工作程序节点的专用管理器节点。这可以通过传递--availability=drain
给来实现docker swarm join
。
上级命令
命令 | 描述 |
---|---|
码头工人 | 管理群 |
相关命令
命令 | 描述 |
docker swarm ca | 显示并旋转根CA |
docker swarm初始化 | 初始化一群 |
docker swarm加入 | 加入一群人作为节点和/或管理者 |
docker swarm连接令牌 | 管理加入令牌 |
码头群离开 | 离开群 |
码头群解锁 | 解锁群 |
泊坞窗群解锁密钥 | 管理解锁密钥 |
docker swarm更新 | 更新群 |