README.md

AWS commands easy to manipulate on terminal

Prepare for homebrew

$ brew tap tilfin/aws

ec2ssh

A script to ssh EC2 instances to be selected from the list shown for specified profile

Install via homebrew

$ brew install ec2ssh

How to use

$ ec2ssh <aws profile>

• If switching profile needs your MFA token, Enter MFA code> is shown.
• SSH user is fixed to ec2-user.

Pre and Post hook

• If your need pre hook, put ~/.ec2ssh-pre file.
• If your need post hook, put ~/.ec2ssh-post file.

Purposes

• If target EC2 needs the connection via a bastion server, bastion in pre hook
• If target EC2 needs the routing (via VPN), add a route in pre hook and delete the route in post hook.

Examples

.ec2ssh-pre

case $profile in
  brand-x)
    bastion=brand-x-bastion
    ;;
  brand-y)
    sudo route add 50.200.200.100 192.168.50.1
    ;;
esac

.ec2ssh-post

case $profile in
  brand-y)
    sudo route del 50.200.200.100
    ;;
esac

Screenshot

swrole

A script to switch an assume role for terminal shell

Install via homebrew

$ brew install swrole

How to use

$ swrole [-j] [-o] [-t <OTP>] <aws_profile>

• -j: Output JSON for AWS credential_process.
• -o: Output AWS credentials values as environment variable definitions.
• -t <onetime_code>: Specify a onetime code, e.g., -t 123456.

• Enter forked bash that exports AWS_XXX environments if neither -o nor -j option is specified.
• Be careful that the session will expire in an hour.

Configuration Fields

Add the following fields to ~/.aws/config:

• color: Specify a color for the profile name in the forked bash.
• generate_token: Automatically obtain OTP by executing the specified command for profiles with mfa_serial defined.

Screenshot