collar

Quickly query for EC2 instances on the command-line.

Status: in-development

Overview

Collar makes it easier for you to access on-demand servers that you've spun up on Amazon EC2. It's a command-line tool for querying and logging into these servers, a tool which lets you filter using immutable instance parameters (e.g. size, security group) as well as mutable tags.

Installing

Requires Python 3.x and pip. Then install with:

pip install collar

Configuring

You'll need to provide access to your Amazon account by creating a ~/.botorc file. See Configuring Boto Credentials.

Examples of use

Listing instances

# list all instances by id
collar list

# TODO: list all instance by public domain
collar list --public

# TODO: list all instances by private domain
collar list --private

# list only instances with tag Role:worker
collar list Role:worker

# constrain with many tags at once
collar list Role:worker Customer:blubbersoft

Describing instances

# describe all instances
collar describe

# describe a named instance
collar describe Name:projet-alpha

# describe a general query
collar describe Role:worker Customer:blubbersoft

Licence

BSD licenced.