0.0
Repository is archived
No commit activity in last 3 years
No release in over 3 years
Easily open and close ssh tunnels required by your project
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 2.1.4
 Project Readme

TunnelVision!

What is it?

Simple tool which lets you create definitions of ssh tunnels your project will need.

By issuing one command it opens all required ssh tunnels and lets you carry on with your work.

Scratching an itch:

I find myself working remotely and/or changing machines more often than I could imagine.

Because at my day job I'm working only on a part of a big system I need to maintain connectivity of my development environment with other services by using SSH tunnels.

At worst I need 4 tunnels for my dev setup to be usable. sigh

So far I've been maintaining a set of different shell scripts which helped me establish SSH tunnels to different servers and such.

TunnelVision solves that problem.

Inspired by

Installation

gem install tunnel_vision

Usage

  • tunnelvision - shows simple help
  • tunnelvision generate - generates example tunnels.yaml file
  • tunnelvision start - opens all tunnels defined in tunnels.yaml
  • tunnelvision status - shows information about opened tunnels
  • tunnelvision stop - closes all opened tunnels defined by tunnels.yaml

Requirements

  • ruby 1.8.7 (probably works with 1.9.2)
  • OpenSSL support enabled in Ruby (OSX comes with that, Linux needs ruby-openssl package)
  • net-ssh gem (gets installed with TunnelVission)

Important!

You need to set up ssh-key based authentication before using TunnelVision. While it's possible to use passwords straight from tunnels.yaml it's horribly insecure!

You should always use ssh keys anyway.

Bugs?

Yeah, plenty.

This gem was created in few hours, so it has few things which can explode. I will hunt them down.

Todo

  • colors

Licence

TunnelVision is a product of Ɓukasz Korecki (lukasz@coffeesounds.com)

Licenced under MIT Licence