docker swarm join-token
| 描述 | 管理加入令牌 |
|---|---|
| 用法 | docker swarm join-token [OPTIONS] (worker|manager) |
Swarm 此命令适用于 Swarm 编排器。
描述
加入令牌是允许节点加入 swarm 的秘密。有两种不同的可用加入令牌，一种用于 worker 角色，一种用于 manager 角色。当您运行 swarm join 时，您可以使用 --token 标志传递令牌。节点仅在加入 swarm 时使用加入令牌。
注意这是一个集群管理命令，必须在 Swarm 管理器节点上执行。要了解管理器和工作器，请参阅文档中的Swarm 模式部分。
选项
| 选项 | 默认值 | 描述 |
|---|---|---|
-q, --quiet | 仅显示令牌 | |
--rotate | 轮换加入令牌 |
示例
您可以使用 swarm join-token 查看或轮换加入令牌。
为方便起见，您可以将 worker 或 manager 作为参数传递给 join-token，以打印完整的 docker swarm join 命令来将新节点加入 swarm
$ docker swarm join-token worker
To add a worker to this swarm, run the following command:
docker swarm join \
--token SWMTKN-1-3pu6hszjas19xyp7ghgosyx9k8atbfcr8p2is99znpy26u2lkl-1awxwuwd3z9j1z3puu7rcgdbx \
172.17.0.2:2377
$ docker swarm join-token manager
To add a manager to this swarm, run the following command:
docker swarm join \
--token SWMTKN-1-3pu6hszjas19xyp7ghgosyx9k8atbfcr8p2is99znpy26u2lkl-7p73s1dx5in4tatdymyhg9hu2 \
172.17.0.2:2377
使用 --rotate 标志为指定角色生成新的加入令牌
$ docker swarm join-token --rotate worker
Successfully rotated worker join token.
To add a worker to this swarm, run the following command:
docker swarm join \
--token SWMTKN-1-3pu6hszjas19xyp7ghgosyx9k8atbfcr8p2is99znpy26u2lkl-b30ljddcqhef9b9v4rs7mel7t \
172.17.0.2:2377
使用 --rotate 后，只有新令牌才可用于以指定角色加入。
-q（或 --quiet）标志仅打印令牌
$ docker swarm join-token -q worker
SWMTKN-1-3pu6hszjas19xyp7ghgosyx9k8atbfcr8p2is99znpy26u2lkl-b30ljddcqhef9b9v4rs7mel7t
--rotate
由于令牌允许新节点加入 swarm，因此您应该对其保密。请特别注意 manager 令牌，因为它们允许新的 manager 节点加入 swarm。恶意 manager 有可能扰乱您的 swarm 的运行。
如果令牌被签入版本控制、被盗或节点受到攻击，请轮换您的 swarm 的加入令牌。您可能还需要定期轮换令牌，以确保任何未知的令牌泄露不会允许恶意节点加入 swarm。
要轮换加入令牌并打印新生成的令牌，请运行 docker swarm join-token --rotate 并传递角色：manager 或 worker。
轮换加入令牌意味着新节点将无法使用旧令牌加入 swarm。轮换不会影响 swarm 中的现有节点，因为加入令牌仅用于授权新节点加入 swarm。
--quiet
仅打印令牌。不打印完整的加入命令。