注册节点

Goal

您向控制平面注册并准备好接受容器的机器。

Before you start

• 一台安装了 Docker 并拥有 root shell 的 Linux 机器。
• 从该机器到控制平面的出站 HTTPS 连接。
• 在您的租户内注册的权限。一个节点属于一个租户，正如多租户与隔离所述。

Dashboard

Steps

1. 打开 节点 并选择 注册节点。
2. 复制安装命令。它包含一个一次性的注册令牌。
3. 在机器上以 root 身份运行它。
4. 观察节点出现在列表中并变为就绪。

REST API

Steps

1. 调用 POST /api/v1/nodes/enroll 以获取您选择的节点名称的注册令牌。
2. 使用该令牌在机器上执行 GET /api/v1/bootstrap/script 以获取安装程序。
3. 以 root 身份运行安装程序。它会调用 POST /api/v1/bootstrap/validate，然后 调用 POST /api/v1/bootstrap/complete。
4. 调用 GET /api/v1/nodes 并确认节点已列出。

CLI

Steps

1. 没有 CLI 注册命令。仪表盘和 API 提供的安装程序是 节点端工具，并且无论哪种方式都是同一个脚本。
2. 使用上面的仪表盘或 API 选项卡；CLI 在此处的作用是检查，而不是注册。

Verify

节点已列出并就绪，且 GET /api/v1/nodes/{name} 返回了它。

Evidence this worked

安装程序的最后一行报告代理程序已注册，节点的首次签到会在大约三十秒内更改其在列表中的状态。一个从未出现的节点尚未完成注册——令牌已被之前的尝试消耗，或者机器无法访问控制平面。

When it fails

• 令牌因已使用而被拒绝。 注册令牌是一次性的。请签发另一个，而不是重新运行旧命令；安装行的过时副本是最常见的原因。
• 节点出现但从未就绪。 代理程序已注册，但无法维持其出站连接。请检查出口连接，而不是注册过程。
• 节点属于另一个租户。 节点不会在租户之间移动；必须移除机器并重新注册。