Skip to content
Ansible roles for go-ipfs and ipfs-cluster
Shell Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
group_vars
host_vars Template all variables in cluster config and add defaults to all too. Jun 7, 2019
roles Separate ipfs and ipfs-cluster roles. Support init.d for ipfs-cluster Nov 7, 2019
.gitignore
LICENSE Initial commit Mar 23, 2017
Makefile Add ansible roles, readme and Makefile Mar 23, 2017
README.md Separate ipfs and ipfs-cluster roles. Support init.d for ipfs-cluster Nov 7, 2019
inventory.yml Separate ipfs and ipfs-cluster roles. Support init.d for ipfs-cluster Nov 7, 2019
ipfs-cluster.yml Bring scripts up to date: Feb 21, 2018
ipfs.yml Separate ipfs and ipfs-cluster roles. Support init.d for ipfs-cluster Nov 7, 2019

README.md

Ansible roles for go-ipfs and ipfs-cluster

This repository contains Ansible roles to install and run go-ipfs and IPFS Cluster.

They include a Systemd service file both.

Usage

If you are familiar with Ansible, you can just re-use the modules in the way that fits you best. Otherwise follow these steps:

  1. Make sure you have ansible installed: pip install ansible.
  2. Fill in inventory.yml and place the hostnames of your nodes under the [ipfs] group.
  3. Edit the group_vars/ipfs.yml and group_vars/ipfs-cluster.yml file setting the right configuration values, including generating an IPFS Cluster secret with od -vN 32 -An -tx1 /dev/urandom | tr -d ' \n' ; echo
  4. Add a file for each hostname (filename is the hostname), to the host_vars folder as outlined in host_vars/README.md, containing the necessary host-specific variables (example in the host_vars README).
  5. Run make.

make will run ansible for the ipfs and the ipfs-cluster roles, which apply to the [ipfs] and [ipfs-cluster] inventory group. Upon successful, both go-ipfs and ipfs-cluster should be running in the nodes (they are installed under /usr/local/bin and run by a created ipfs system user).

You can use systemctl status ipfs and systemctl status ipfs-cluster to check the status of the new services.

Note that ipfs configuration has been generated using profile=server, thus will not automatically scan the local network.

You can’t perform that action at this time.