portal

command module
Version: v0.0.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 12, 2020 License: MIT Imports: 3 Imported by: 0

README

Portal

GitHub Workflow Status Go Report Card

GitHub GitHub release (latest SemVer)

Simple tool to quickly connect to favorite servers, including creation of SSH tunnels.

Status

This project is very much in it's initial, experimental phase. Use at your own risk.

Features

Portal provides following set of features that one could find useful:

  • Bookmark-like feature for SSH connections - simply run portal connect <name>
  • Support for complex connections such as multi-hop SSH tunnels
  • Support for connections with AWS EC2 Instance Connect by temporarily pushing SSH key to the instance
  • Provides (potentially )useful hints upon established connection, e.g what ports are being forwarded

Usage

Configuration

Configuration file is looked for at ~/.portal/config.yaml.

---
debug: false

default-public-key: ~/.ssh/id_rsa.pub
default-private-key: ~/.ssh/id_rsa

# List of all known destinations
portals:

  # Tunnel
  - name: server1.tunnel
    hint: Port 3000
    raw:
      command: ssh -L 3000:localhost:8080 me@server1.dot.ip

  # Direct connection
  - name: server.prod.bastion
    raw:
      command: ssh -A user@bastion.dot.ip
  
  # Double tunnel
  - name: server.prod.tunnel
    hint: Local 33333 -> 12345 @ backend.dot.ip via bastion.dot.ip
    raw:
      command: ssh -L 33333:localhost:33333 -A user@bastion.dot.ip ssh -L 33333:localhost:12345 -A user@backend.dot.ip
  
  # AWS EC2 Instance Connect
  - name: aws.host
    aws:
      instance-id: i-1234abcd
      region: us-west-1
      user: ec2-user
Supported Commands
  • Get all available connections:
    portal list
  • Connect to a server:
    portal connect <name> where <name> is the favorite name

TODOs

See separate TODO document for what is planned.

Building

Simply run make all or make build-in-docker if you have Docker installed

License

MIT license, as described in the LICENSE file.

Documentation

The Go Gopher

There is no documentation for this package.

Source Files

Directories

Path Synopsis
pkg
run

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL