1. 首页
  2. 文档
  3. IPFS集群 | IPFS Cluster
  4. 用户文档 | User Documentation
  5. 启动集群

启动集群

启动IPFS集群对等节点是一个简单的过程,但我们必须很好地理解它,因为它是大多数错误发生的地方之一。

ipfs-cluster-service daemon 启动一个集群对等节点,但我们必须确保对等节点正确参与并被集群的其余部分看到。

启动集群时的大多数注意事项取决于“共识 ” 组件的选择  。目前,唯一可用的 共识  实施是  raft

Raft

raft 实现对于peerset的初始化和维护非常严格  。该  peerset  是节点组成一个集群的列表。

使用  raft 组件时,首次启动集群对等节点时有两种主要方法  :

  • 使用固定的peerset启动多个对等节点
  • 启动单个对等节点并将其余节点引导到它

Raft在内部存储和维护  peerset,因此一旦第一次启动成功,任何进一步的启动都很简单  ipfs-cluster-service daemon

使用固定的peerset启动多个对等节点

这是首次启动集群的推荐方法。这在以下情况下非常有用:

  • 使用稳定的群集对等节点,在已知位置运行
  • 使用自动部署
  • 您可以轻松地为集群中的所有对等节点触发启动
要点:当您需要新对等节点加入已在运行的集群时,请勿使用此方法。如果新对等节点不是正在运行的集群的peerset的一部分,请使用 --bootstrap 方法添加它。

要求

  • ipfs-cluster-service 和 ipfs 安装在您的所有主机中。
  • ipfs 正在运行(或同时启动)。
  • 该  peerstore 文件已在所有对等节点中创建,包含至少一个其他对等节点的多地址。
  • 所述  init_peerset 配置密钥列出了所有的对等ID的簇(并非multiaddresses)英寸
  • init_peerset 所有节点中的值应该相同。
  • 你可以使用 raft.wait_for_leader_timeout启动其中的大多数节点。否则启动将失败。

程序

在所有节点中运行以下内容(最好一次):

$ ipfs-cluster-service daemon

将启动集群对等节点:

  • raft 将用init_peerset初始化  。
  • 由于地址在peerstoreor中使用DHT服务进行发现服务的,所有对等节点将知道如何与其他对等节点通信。
  • 节点将选出一名Raft Leader成为  Ready
  • 如果出错,您可以随时重新运行 ipfs-cluster-service daemon

启动单个对等节点并将其余节点引导到它

一种不同的,更灵活的方法是启动单个对等节点,然后将其他对节点引导到它。随着它们的自举,集群将与新的节点一起成长。这在以下情况下非常有用:

  • 您正在手动构建集群,或者要向其添加新的集群
  • 你不知道你的节点会听取的IP或端口(除了第一个)。请注意, 支持peerstore文件中的/ dns4 // dns6地址。快速入门指南中演示了此方法  。

要求

  • ipfs-cluster-service 和 ipfs 安装在您的所有主机中。
  • ipfs 正在运行(或同时启动)。
  • 不需要  peerstore 文件或  init_peerset

程序

首先启动一个节点:

$ ipfs-cluster-service daemon

然后按照以下部分中的说明引导其他每个对等节点

引导节点

Bootstrapping是将对等节点安全地添加到集群的方法:

$ ipfs-cluster-service daemon --bootstrap <multiaddress of first peer>

这将引导对等节点到现有对象:

  • 清理任何预先存在的raft状态。
  • 请求添加到peerset
  • 接收所有其他对等节点的peerset和地址。
  • peerstore 将创建该文件,并使用其他对等节点的对等地址填充该文件。
  • 新对等节点接收群集状态。
  • 当收到完整状态时,新同伴变为Ready
添加对等体仅适用于健康集群,所有对等节点都在线。在添加新的节点之前删除任何不健康的同伴。

重新启动集群和对等节点

一旦你的同伴一直在运行,再启动,重启就像跑步一样简单

$ ipfs-cluster-service daemon
重要:除非已从集群peerset中删除对象,否则不建议使用`-bootstrap`重新启动对等节点。

验证一个良好的开端

验证集群正常运行的最佳方法是:

  • 运行并检查输出 ipfs-cluster-ctl peers ls:它应列出所有对等节点,并且所有对等节点应该 看到 相同数量的其他对等节点。
  • 检查日志输出。

后续步骤:  生产部署

这篇文章对你有帮助吗?

我们要如何帮助您?