awss 0.9.7

List, start, stop and ssh to AWS instances using Name, ID and Wilcards

AWS Shortcuts (awss) allows listing, starting, stopping and connecting to instances by name, instance-id, and supports wilcards. The awss list command displays every tag & value for each instances along with their status and core info. In the near future you will also be able to use any combination of Tag : Value combinations when specifying instances.

Overview

awss has the following sub-commands: list, start, stop, and ssh.

• SSH to an Instance: awss ssh NAME or awss ssh -i ID

  • Additional paramters described in Details.

• List Instances: awss list

  • Additional paramters described in Details.

• Start Instance: awss start NAME or awss start -i ID

• Stop Instance: awss stop NAME or awss stop -i ID

Example output of awss list

Details

• SSH to Instance: awss ssh NAME or awss ssh -i ID

  • typing awss ssh without a name or ID will display all running instances

    • this allows the user to select from the list if they can’t remember the name.

    • this can be combined with wilcards, for example awss ssh U* to display a list of instances starting with “U” to select from.

  • the login-name is automatically calculated based on the image-type of the instance

  • override the calculated login-name -u USERNAME

  • connect without PEM keys (if properly configured) -p

  • command specific help awss ssh -h

• List Instances: awss list

  • list all instances (default), or use wilcards awss list D*

  • list running instances -r or --running

  • list stopped instances -s or --stopped

  • list instances with specified name awss list NAME

  • list instance with specified instance-id awss list -i ID

  • instance-state and NAME may be combined in queries.

    • ex: list instances with NAME currently running: awss list NAME -r

  • command specific help awss list -h

• Start Instance: awss start NAME or awss start -i ID

  • typing awss start without a name or ID will display all stopped instances

    • this allows the user to select from the list if they can’t remember the name.

    • this can be combined with wilcards, for example awss start U* to display a list of instances starting with “U” to select from.

  • start instance by name or instance-id

  • command specific help awss start -h

• Stop Instance: awss stop NAME or awss stop -i ID

  • typing awss stop without a name or ID will display all running instances

    • this allows the user to select from the list if they can’t remember the name.

    • this can be combined with wilcards, for example awss stop U* to display a list of instances starting with “U” to select from.

  • start instance by name or instance-id

  • command specific help awss stop -h

Target Instance Determination

The start, stop, and ssh commands check if multiple instances match the parameters. If so, the the matching instances are listed, and the user selects the intended target.

Example screenshot of selecting instance from list:

Platforms & Python Versions Tested

Python 2.7, 3.3, 3.4, 3.5, 3.6

Platforms:

• Linux

• macOS (OS X)

• Windows

Installation

This utility can be installed with pip:

pip install awss