API to add peer to IPFS-CLUSTER

axife · September 29, 2021, 5:39pm

I am starting a new IPFS-CLUSTER server and I have old IPFS-CLUSTER servers.
I wish to call API on these old servers and let them know about new server.

I found API

github.com

ipfs/ipfs-cluster/blob/master/api/rest/client/client.go#L56

    
      
          // context.Context as their first parameter, this allows for
          // timing out and cancelling of requests as well as recording
          // metrics and tracing of requests through the API.
          type Client interface {
          	// ID returns information about the cluster Peer.
          	ID(context.Context) (*api.ID, error)
          
          
	// Peers requests ID information for all cluster peers.
          	Peers(context.Context) ([]*api.ID, error)
          	// PeerAdd adds a new peer to the cluster.
          	PeerAdd(ctx context.Context, pid peer.ID) (*api.ID, error)
          	// PeerRm removes a current peer from the cluster
          	PeerRm(ctx context.Context, pid peer.ID) error
          
          
	// Add imports files to the cluster from the given paths.
          	Add(ctx context.Context, paths []string, params *api.AddParams, out chan<- *api.AddedOutput) error
          	// AddMultiFile imports new files from a MultiFileReader.
          	AddMultiFile(ctx context.Context, multiFileR *files.MultiFileReader, params *api.AddParams, out chan<- *api.AddedOutput) error
          
          
	// Pin tracks a Cid with the given replication factor and a name for
          	// human-friendliness.

||// PeerAdd adds a new peer to the cluster.|
||PeerAdd(ctx context.Context, pid peer.ID) (*api.ID, error)|

But PeerAdd takes peer.ID that is random string or publickey but not multiaddr

Is there API to pass new peer as multiaddr string.

Do I have to restart all IPFS-CLUSTERs with bootstrap argument?

Is there other API to pass IP:port to use along side with PeerAdd that takes peer.ID

I do the same for ipfs with API

github.com

ipfs/go-ipfs-api/blob/v0.2.0/bootstrap.go#L11

    
      
          package shell
          
          
import (
          	"context"
          )
          
          
type PeersList struct {
          	Peers []string
          }
          
          
func (s *Shell) BootstrapAdd(peers []string) ([]string, error) {
          	var addOutput PeersList
          	err := s.Request("bootstrap/add", peers...).Exec(context.Background(), &addOutput)
          	return addOutput.Peers, err
          }
          
          
func (s *Shell) BootstrapAddDefault() ([]string, error) {
          	var addOutput PeersList
          	err := s.Request("bootstrap/add/default").Exec(context.Background(), &addOutput)
          	return addOutput.Peers, err
          }

Would IPFS-CLUSTER get host IPs from underlying ipfs server?

hector · September 30, 2021, 11:31am

Sorry, PeerAdd is misleading and not useful.

Yes, in principle you need to start the NEW peers with the --bootstrap argument (or modifying the peerstore) as explained here: Bootstrapping the Cluster - Pinset orchestration for IPFS. That is a must if using Raft consensus.

If you are using CRDT, it depends. You can restart the old peers (rather than the new) with the bootstrap argument or the modified peerstore. If the peers are on the same local network they may be able to auto-discover eachothers via mDNS without having to do anything else by just starting them. Or the new peers may simply discover each others as long as they connect to a peer that is already in the cluster via DHT routing.

My recommendation is to modify the peerstore file, as that is what makes them open connections to places and gives them first-hand multiaddress information for other peers.

Topic		Replies	Views
Released [UNOFFICIAL] ipfs-cluster-api ipfs-cluster	14	820	May 11, 2019
[SOLVED] Not able to ADD peer to a cluster using HTTP endpoint ipfs-cluster	4	474	May 21, 2019
Make a request to ipfs-cluster API for adding new content Coding ipfs-cluster	0	838	May 11, 2020
Error Adding cluster node Help go-ipfs , ipfs-cluster	5	516	May 2, 2019
Ipfs-cluster add file issue Help	6	1077	November 7, 2017

API to add peer to IPFS-CLUSTER

Related topics