docker swarm join
| 描述 | 作為節點和/或管理器加入 swarm |
|---|---|
| 用法 | docker swarm join [OPTIONS] HOST:PORT |
Swarm 此命令適用於 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 | 加入 swarm 的令牌 |
示例
將節點作為管理器加入 swarm
以下示例演示了使用管理器令牌加入管理器節點。
$ 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 地址的穩定主機。
將節點作為工作節點加入 swarm
以下示例演示了使用工作節點令牌加入工作節點。
$ 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
如果節點是管理器，它將在此地址上監聽入站 swarm 管理器流量。預設是監聽 0.0.0.0:2377。也可以指定一個網路介面來監聽該介面的地址；例如 --listen-addr eth0:2377。
指定埠是可選的。如果值是裸 IP 地址或介面名稱，則將使用預設埠 2377。
在加入現有 swarm 時，通常不需要此標誌。
--advertise-addr value
此標誌指定將通告給 swarm 其他成員以進行 API 訪問的地址。如果未指定，Docker 將檢查系統是否具有單個 IP 地址，並使用該 IP 地址和監聽埠（請參閱 --listen-addr）。如果系統具有多個 IP 地址，則必須指定 --advertise-addr，以便為管理器間通訊和覆蓋網路選擇正確的地址。
也可以指定一個網路介面來通告該介面的地址；例如 --advertise-addr eth0:2377。
指定埠是可選的。如果值是裸 IP 地址或介面名稱，則將使用預設埠 2377。
在加入現有 swarm 時，通常不需要此標誌。如果您透過負載均衡器加入新節點，則應使用此標誌以確保節點通告其 IP 地址而不是負載均衡器的 IP 地址。
--data-path-addr
此標誌指定全域性範圍網路驅動程式將向其他節點發布以到達在此節點上執行的容器的地址。使用此引數，可以將容器的資料流量與叢集的管理流量分開。如果未指定，Docker 將使用與通告地址相同的 IP 地址或介面。
--token string
節點加入 swarm 所需的秘密值
--availability
此標誌指定節點加入主節點時的可用性。可能的可用性值為 active、pause 或 drain。
此標誌在某些情況下很有用。例如，叢集可能希望擁有不作為工作節點服務的專用管理器節點。這可以透過將 --availability=drain 傳遞給 docker swarm join 來實現。