Skip to content

darxkies/virtual-ip

Repository files navigation

Virtual-IP

Build Status Go Report Card GitHub release GitHub

Virtual-IP can be used to share a Virtual/Floating IP address between many computers. The IP address is assigned to only one computer. If that computer goes down, the same IP address is then reassigned to another computer in the cluster.

Features

  • Self contained binary that can be downloaded from GitHub
  • Docker Image on Docker Hub
  • No external dependencies as in sevices
  • Uses Raft Consensus for cluster communication

Usage

Assuming that you have the following setup:

  • three Linux servers with the IP addresses: 192.168.0.101, 192.168.0.102, 192.168.0.103)
  • the three servers have the network interface eth1
  • the Virtual-IP is 192.168.0.50
  • the port 10000 for Raft on all three servers is free

Binary

Download the binary from release page.

Then on each server run the following commands

Server1 (192.168.0.101):

sudo virtual-ip -id server1 -bind 192.168.0.101:10000 -peers server1=192.168.0.101:10000,server2=192.168.0.102:10000,server3=192.168.0.103:10000 -interface eth1 -virtual-ip 192.168.0.50

Server2 (192.168.0.102):

sudo virtual-ip -id server2 -bind 192.168.0.102:10000 -peers server1=192.168.0.101:10000,server2=192.168.0.102:10000,server3=192.168.0.103:10000 -interface eth1 -virtual-ip 192.168.0.50

Server3 (192.168.0.103):

sudo virtual-ip -id server3 -bind 192.168.0.102:10000 -peers server1=192.168.0.101:10000,server2=192.168.0.102:10000,server3=192.168.0.103:10000 -interface eth1 -virtual-ip 192.168.0.50

Docker

Alternatively, the Docker Image can be used like this.

Server1 (192.168.0.101):

docker run -ti --rm --privileged --net=host darxkies/virtual-ip -id server1 -bind 192.168.0.101:10000 -peers server1=192.168.0.101:10000,server2=192.168.0.102:10000,server3=192.168.0.103:10000 -interface eth1 -virtual-ip 192.168.0.50

Server2 (192.168.0.102):

docker run -ti --rm --privileged --net=host darxkies/virtual-ip -id server2 -bind 192.168.0.102:10000 -peers server1=192.168.0.101:10000,server2=192.168.0.102:10000,server3=192.168.0.103:10000 -interface eth1 -virtual-ip 192.168.0.50

Server3 (192.168.0.103):

docker run -ti --rm --privileged --net=host darxkies/virtual-ip -id server3 -bind 192.168.0.102:10000 -peers server1=192.168.0.101:10000,server2=192.168.0.102:10000,server3=192.168.0.103:10000 -interface eth1 -virtual-ip 192.168.0.50

Build

To build from source code you need make and Docker, then run the following commands:

git clone [email protected]:darxkies/virtual-ip.git
cd virtual-ip
make

The commands generate the binary virtual-ip in the current directory.