KantanCluster View Source
Form a simple Erlang cluster easily in Elixir.
Documentation can be found at https://hexdocs.pm/kantan_cluster.
Getting started
Add kantan_cluster
to your list of dependencies in mix.exs
:
def deps do
[
{:kantan_cluster, "~> 0.1.0"}
]
end
Start a KantanCluster
server, which will start a node and connect it to specified nodes using a specified Erlang magic cookie.
KantanCluster.start(
node: {:longnames, :"node1@127.0.0.1"},
cookie: :hello,
connect_to: [:"nerves@nerves-mn00.local"]
)
Options:
:node
- a name of the node that you want to start (default:{:longnames, :"xxxx@127.0.0.1"}
wherexxxx
is a random string):cookie
- Erlang magic cookie to form a cluster (default: random cookie):connect_to
- a list of nodes you want to connected to (default:[]
)
Alternatively, options can be loaded from your config/config.exs
.
config :kantan_cluster,
node: {:longnames, :"node1@127.0.0.1"},
cookie: :hello,
connect_to: [:"nerves@nerves-mn00.local"]
KantanCluster
starts a server that monitors the connection per node name under a dynamic supervisor.
kantan_cluster
monitors all the connected nodes and attempts to reconnect them automatically in case they get disconnected.
You can connect or disconnect a node on demand.
KantanCluster.connect(:"nerves@nerves-mn01.local")
KantanCluster.disconnect(:"nerves@nerves-mn01.local")