ecpc 0.0.4

Simple scripts to launch EC2 instances

# ECPC: Simple creation and managment of EC2 instances

ECPC provides a small collection of command-line tools to launch, list,
log in to, and terminate EC2 (spot) instances.

It's deliberately a basic
tool with few parameters for a user to tweak.

## Prerequisites:

You need to have an AWS account, and have you ACCESS_KEY and SECRET_ACCESS_KEYs to hand. Then install boto3 according to the
instructions [here](https://pypi.org/project/boto3/)

## Installation:

Via `pip`:

pip install ecpc

## Usage:

To launch an instance, use `ecpc create`:

% ecpc create
creating a t2.small instance in region eu-west-1 with ID d830a8f4
key pair created
security group created
required ami identified
launching instance - this may take some time...
instance launched
%

You can give it a nicer name, change the instance type, and the region it is launched into:

% ecpc create -r us-west-1 -t c5.large -n c5large-1
creating a c5.large instance in region eu-west-1 with ID c5large-1
key pair created
security group created
required ami identified
launching instance - this may take some time...
instance launched
%

To list your instances:

% ecpc list
ID region type up_time state cost($)
c5large-1 us-west-1 c5.large 00:00:00 booting-up 0.00
d830a8f4 eu-west-1 t2.small 00:04:00 ready 0.00

**Note: the "cost" value is approximate**

To log in to an instance, use `ecpc login`:

% ecpc login d830a8f4
Warning: Permanently added '52.19.207.118' (ECDSA) to the list of known hosts.
Welcome to Ubuntu 18.04.1 LTS (GNU/Linux 4.15.0-1029-aws x86_64)

* Documentation: https://help.ubuntu.com
* Management: https://landscape.canonical.com
* Support: https://ubuntu.com/advantage

System information as of Fri Dec 7 17:07:20 UTC 2018

System load: 0.0 Processes: 82
Usage of /: 13.4% of 7.69GB Users logged in: 0
Memory usage: 6% IP address for eth0: 172.31.21.191
Swap usage: 0%

Get cloud support with Ubuntu Advantage Cloud Guest:
http://www.ubuntu.com/business/services/cloud

0 packages can be updated.
0 updates are security updates.



The programs included with the Ubuntu system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Ubuntu comes with ABSOLUTELY NO WARRANTY, to the extent permitted by
applicable law.

To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.

ubuntu@ip-172-31-21-191:~$

To terminate an instance, use `ecpc terminate`:

% ecpc terminate d830a8f4
instance terminated
security group deleted
key pair deleted
.pem file deleted
%