Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hatena/swiro
swiro - A switching route tool for AWS
https://github.com/hatena/swiro
aws go golang
Last synced: about 18 hours ago
JSON representation
swiro - A switching route tool for AWS
- Host: GitHub
- URL: https://github.com/hatena/swiro
- Owner: hatena
- Created: 2016-12-20T06:55:03.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-07-12T02:29:30.000Z (over 2 years ago)
- Last Synced: 2024-06-20T16:49:27.424Z (5 months ago)
- Topics: aws, go, golang
- Language: Go
- Homepage:
- Size: 48.8 KB
- Stars: 11
- Watchers: 15
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# 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`:
```bash
$ go get -u github.com/taku-k/swiro
```
## Contribution
1. Fork ([https://github.com/taku-k/swiro/fork](https://github.com/taku-k/swiro/fork))
1. Create a feature branch
1. Commit your changes
1. Rebase your local changes against the master branch
1. Run test suite with the `go test ./...` command and confirm that it passes
1. Run `gofmt -s`
1. Create a new Pull Request
## Release
Prerequisite:
```bash
$ 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:
```bash
$ ./release.sh v0.2.8
```
## Author
[taku-k](https://github.com/taku-k)