Package: awss
Connect and Control Instances by Name or Selection from Instance ListUse AWSS to establish SSH connections and control instances without the need to know IP addresses, instance-ids or Names.  This eliminates the need to leave the shell to use the Web Portal to retreive this information, which prevents workflow distruption and allows you to remain focused on the shell and the tasks at hand.AWSS is extremely useful when the following items are unknown for a target instance:The current IP address (changes frequently for on-demand instances)The login-user required for connecting via SSHThe keyfile associated with the SSH accountThe instance-idExample screenshotsRunning “awss ssh” without specifying any additional info allows you to select from list of running instancesRunning “awss list” will list all instances and their details, including all tags (listed in blue)Running “awss start” with a partial Name (and wildcard), lists matching results and allows selecting the targetTested Platforms & Python VersionsPython 2.7, 3.3, 3.4, 3.5, 3.6Platforms:LinuxmacOS (OS X)Windows (seeWindows Prereqsfor ssh functionality)InstallationThis utility can be installed withpip:pipinstallawssWindows PrereqsWindows does not have a built-in ssh command, so using theawss sshcommand on windows requires:Installation ofPuTTY Suiteuse the “Windows Installer”, install all options, and include it on your pathConverting ssh keys from Amazon’s “.pem” format to “.ppk” formatkeys can be converted using theputtygen utility(installed with PuTTY Suite)Powershell (native in of Windows since Windows XP Service Pack 3)ConfigurationSSH Access Keys(.pem or .ppk files)Keys should be stored in the.awsfolder in your home directoryUnix-type systems must set permission on files with a command such assudo chmod 400~/.aws/*.pemWindows systems must convert files to “.ppk” format, as described inWindows PrereqsAWS Credentialscan be stored usingeither one of these two methods:Environment variables “AWS_ACCESS_KEY_ID”, “AWS_SECRET_ACCESS_KEY” and “AWS_DEFAULT_REGION”Files named “credentials” and “config” in the.awsfolder in your home directoryThe Windows home directory is referred to by the environment variable %UserProfile%{HOME}/.aws/credentials[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY{HOME}/.aws/config[default]
region=us-west-2
output=jsonInformation on AWS Credentials is in theAWS Getting Setup guide.Information on configuration files in is theAWS Getting Started guide.Command DetailsSSH to Instance:awss ssh,awss ssh NAMEorawss ssh -i IDtypingawss sshwithout a name or ID will display all running instancesthis allows the user to select from the list if they can’t remember the namethis can be combined with wilcards, for exampleawss ssh U*to display
a list of instances starting with “U” to select fromthe login-name is automatically calculated based on the image-type of the instanceoverride the calculated login-name-u USERNAMEconnect without PEM keys (if properly configured)-pcommand specific helpawss ssh -hList Instances:awss list(other variations listed below)list all instances (default), or use wilcardsawss list D*list running instances-ror–runninglist stopped instances-sor–stoppedlist instances with specified nameawss list NAMElist instance with specified instance-idawss list -i IDinstance-state and NAME may be combined in queriesex: list instances with NAME currently running:awss list NAME -rcommand specific helpawss list -hStart Instance:awss start,awss start NAMEorawss start -i IDtypingawss startwithout a name or ID will display all stopped instancesthis allows the user to select from the list if they can’t remember the namethis can be combined with wilcards, for exampleawss start U*to display
a list of instances starting with “U” to select fromstart instance by name or instance-idcommand specific helpawss start -hStop Instance:awss stop,awss stop NAMEorawss stop -i IDtypingawss stopwithout a name or ID will display all running instancesthis allows the user to select from the list if they can’t remember the name.this can be combined with wilcards, for exampleawss stop U*to display
a list of instances starting with “U” to select from.start instance by name or instance-idcommand specific helpawss stop -h