goto

README

goto

An ssh client terminal written in Go.

This project and command were renamed from goterm to goto. Legacy ~/.goterm/config.yaml configuration is still supported.

with replace for expect tool in minds.

Problems

I used to use expect for machine jumps It got tricky issue that expect can't properly handle terminal resize or other issues.

Therefore this tool, also for easier hosts management.

Features

• Friendly with tmux(terminal resize)
• Replace expect tool
• Support password and key based auth
• Share credential for many hosts
• Config file for hosts and credentials
• Read HostName/User/Port/IdentityFile/ProxyCommand from ~/.ssh/config
• One line ssh login(with password, if you like)

install

go install github.com/chinglinwen/goto@latest

usage

  -cmd string
    	command to run in batch mode
  -f string
    	regexp filter for host
  -initcmds string
    	init cmds after login
  -j string
    	jump host name or user@host:port; key auth only
  -keypath string
    	private key path, e.g. ~/.ssh/id_rsa
  -l string
    	label filter for host
  -p string
    	credential name or plain password; use base64:<value> to decode
  -port string
    	port to connect
  -user string
    	user to auth
  -v	verbose output
  -V	print version

Usage: goto <name>
       goto -V
       goto <name|ip[:port]|expr|pattern> <cmd...>
       echo 'uptime' | goto <name|ip[:port]|expr|pattern>
       goto [-cmd='uptime'] <name|ip[:port]|expr|pattern>
       goto [-user=root] [-p=password] <ip[:port]>
       goto [-j=<jump>] <name|ip[:port]|expr|pattern> <cmd...>
       goto [-port=2222] [-user=userfoo] [-initcmds='sudo su -\n'] <name|ip[:port]|expr|pattern>

Examples:
  goto 11                                      # interactive login using config host 11
  goto root@10.47.120.11:2222                 # interactive login with inline user and port
  goto -user=root -p=vm 10.47.120.11          # use password from configured credential vm
  goto -user=root -p=password 10.47.120.11    # direct plain password login
  goto -user=root -p=base64:cGFzc3dvcmQ= 10.47.120.11
  goto -keypath=~/.ssh/id_rsa root@10.47.120.11
  goto 11 uptime                              # batch command; uses host jump config when jump is set
  goto -j=bastion 11 uptime                   # override with explicit jump host bastion
  goto internal-vm uptime                     # can resolve HostName/User/Port/IdentityFile/ProxyCommand from ~/.ssh/config
  goto -cmd='uname -a' 11                     # batch command from -cmd
  echo 'df -h' | goto 11                      # batch command from stdin
  goto -v 11 uptime                           # verbose batch execution
  goto -l prod                                # list hosts by label
  goto -f '10\.47\.120'                       # list hosts by regexp
  goto -initcmds='sudo su -\n' 11             # interactive login, then run sudo su -

Config example:
  $ cat ~/.ssh/goto.yaml
  creds:
  - name: vm
    user: root
    pass: password
    keypath: ~/.ssh/id_rsa  # optional private key path; omit to use ~/.ssh/id_rsa
  - name: jump
    user: root
    keypath: ~/.ssh/id_rsa
  hosts:
  - name: 11
    host: 10.47.120.11
    cred: vm
    port: 22
    jump: bastion
    initcmds: "sudo su -\n"
  - name: bastion
    host: 10.47.120.10
    cred: jump
    port: 22

keypath is a private key file, for example ~/.ssh/id_rsa, not id_rsa.pub.
If pass is empty, goto uses key-based auth with keypath.
Config is read from ~/.ssh/goto.yaml; legacy ~/.goterm/config.yaml still works.
initcmds is only for interactive mode because it writes commands into the opened shell after login. Batch mode ignores it.
Use -p with a credential name to reuse its password, or with any other value as a plain password.
Use pass: base64:<value> or -p base64:<value> to decode a base64 password.
Use host jump: <name> to set a default jump host. Use -j with a configured host name or inline user@host:port to override it.
Jump host config is resolved locally and uses key auth.
goto also reads ~/.ssh/config for HostName, User, Port, IdentityFile, and ProxyCommand.
Batch command mode writes only remote stdout to stdout, remote stderr to stderr, and exits with the remote command status.

Acknowledgements

Thanks to https://mritd.me/2018/11/09/go-interactive-shell/