swiro

swiro is a switching route tool for AWS to realize VIP (Virtual IP) with Routing-Based High Availability pattern.

This pattern is possible to perform failover (switching of the connection destination) of the EC2 redundant across the subnet (AZ).

Usage

• List routes

$ swiro list

• Switching routes

$ swiro switch -r rtb-xxxxxx -v 10.0.0.1 -I i-xxxxxx

Example

List routes

$ swiro list
===> Route Table: route_table_1 (rtb-xxxxxx1)
---> Virtual IP:  10.0.0.1/32 =======> src_instance_1 (i-yyyyyy1)
---> Virtual IP:  10.0.0.2/32 =======> src_instance_2 (i-yyyyyy2)
===> Route Table: route_table_2 (rtb-xxxxxx2)
---> Virtual IP:  10.0.0.3/32 =======> src_instance_3 (i-yyyyyy3)

Switching routes

In most cases you can switch the routing with the Route Table ID as follows:

$ swiro switch -r rtb-xxxxxx -v 10.0.0.1 -I i-xxxxxx
Switch the route below setting:
===> Route Table: route_table (rtb-xxxxxx)
---> Virtual IP:  10.0.0.1 -------- Src:  src_instance (i-yyyyyy)
                           \\
                            ======> Dest: i-xxxxxx
Are you sure? (y/n) [y]: y
Success!!

You can also switch by specifying Route Table Name instead of Route Table ID.

$ swiro switch -r route_table -v 10.0.0.1 -I dest_instance

Install

To install, use go get:

$ go get -u github.com/taku-k/swiro

Contribution

1. Fork (https://github.com/taku-k/swiro/fork)
2. Create a feature branch
3. Commit your changes
4. Rebase your local changes against the master branch
5. Run test suite with the go test ./... command and confirm that it passes
6. Run gofmt -s
7. Create a new Pull Request

Release

Prerequisite:

$ go get github.com/tcnksm/ghr
$ go get github.com/Songmu/ghch/cmd/ghch

When you'd like to release master branch as v0.2.8:

$ ./release.sh v0.2.8

Author

taku-k