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，因此您应该妥善保管它们。请特别注意管理节点令牌，因为它们允许新的管理节点加入 Swarm。恶意管理节点可能会扰乱 Swarm 的运行。

如果令牌被提交到版本控制、被盗或节点受到威胁，请轮换 Swarm 的加入令牌。您可能还需要定期轮换令牌，以确保任何未知的令牌泄露不会允许恶意节点加入 Swarm。

要轮换加入令牌并打印新生成的令牌，请运行 docker swarm join-token --rotate 并传递角色：manager 或 worker。

轮换加入令牌意味着没有新节点能够使用旧令牌加入 Swarm。轮换不会影响 Swarm 中的现有节点，因为加入令牌仅用于授权新节点加入 Swarm。

--quiet

仅打印令牌。不打印完整的加入命令。