docker swarm 加入
描述 | 作为节点和/或管理器加入集群 |
---|---|
用法 | docker swarm join [OPTIONS] HOST:PORT |
Swarm 此命令与 Swarm 协调器配合使用。
描述
将节点加入集群。该节点根据您通过标志传递的令牌作为管理节点或工作节点加入--token
。如果您传递管理者令牌,该节点将作为管理者加入。如果您传递工作人员令牌,该节点将作为工作人员加入。
选项
选项 | 默认 | 描述 |
---|---|---|
--advertise-addr | 广告地址(格式<ip|interface>[:port] :) | |
--availability | active | 节点的可用性 ( active , pause , drain ) |
--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 值
如果节点是管理器,它将侦听此地址上的入站群管理器流量。默认是监听 0.0.0.0:2377。还可以指定一个网络接口来侦听该接口的地址;例如--listen-addr eth0:2377
。
指定端口是可选的。如果该值为裸 IP 地址或接口名称,则将使用默认端口 2377。
加入现有集群时通常不需要此标志。
--advertise-addr 值
该标志指定将通告给群中其他成员以进行 API 访问的地址。如果未指定,Docker 将检查系统是否有单个 IP 地址,并将该 IP 地址与侦听端口一起使用(请参阅 参考资料
--listen-addr
)。如果系统有多个 IP 地址,--advertise-addr
则必须指定,以便为管理器间通信和覆盖网络选择正确的地址。
还可以指定一个网络接口来通告该接口的地址;例如--advertise-addr eth0:2377
。
指定端口是可选的。如果该值为裸 IP 地址或接口名称,则将使用默认端口 2377。
加入现有集群时通常不需要此标志。如果您通过负载均衡器加入新节点,则应使用此标志来确保节点公布其 IP 地址,而不是负载均衡器的 IP 地址。
--数据路径地址
此标志指定全局范围网络驱动程序将向其他节点发布的地址,以便到达在此节点上运行的容器。使用此参数可以将容器的数据流量与集群的管理流量分开。如果未指定,Docker 将使用与广告地址相同的 IP 地址或接口。
--令牌字符串
节点加入集群所需的秘密值
- 可用性
该标志指定节点加入主节点时节点的可用性。可能的可用性值为active
、pause
、 或drain
。
该标志在某些情况下很有用。例如,集群可能希望拥有不用作工作节点的专用管理器节点。这可以通过传递--availability=drain
到 来实现docker swarm join
。