docker swarm join-token
| 描述 | 管理加入令牌 |
|---|---|
| 用法 | docker swarm join-token [OPTIONS] (worker|manager) |
Swarm 此命令适用于 Swarm 调度器。
描述
加入令牌是允许节点加入集群的密钥。有两种不同的加入令牌可用，一种用于 worker 角色，另一种用于 manager 角色。在运行 swarm join 时，你可以使用 --token 标志传递令牌。节点仅在加入集群时使用加入令牌。
注意
这是一个集群管理命令，必须在 Swarm 管理节点上执行。要了解管理节点和工作节点，请参阅文档中的Swarm 模式部分。
选项
| 选项 | 默认 | 描述 |
|---|---|---|
-q, --quiet | 仅显示令牌 | |
--rotate | 轮换加入令牌 |
示例
您可以使用 swarm join-token 查看或轮换加入令牌。
为了方便起见，您可以将 worker 或 manager 作为参数传递给
join-token，以打印完整的 docker swarm join 命令，用于将新节点加入
集群：
$ 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 加入令牌。您可能还需要定期轮换令牌，以确保任何未知的令牌泄露不会导致恶意节点加入 Swarm。
要轮换加入令牌并打印新生成的令牌，请运行
docker swarm join-token --rotate 并传递角色：manager 或 worker。
轮换加入令牌意味着没有新节点能够使用旧令牌加入集群。轮换不会影响集群中现有的节点，因为加入令牌仅用于授权新节点加入集群。
--quiet
仅打印令牌。不要打印完整的加入命令。