Climulon

Climulon is a CLI that eases the process of managing complex infrastructure and deployments of docker containers in AWS, while being faithful to the tenets of infrastructure-as-code.

It goes this way :

Describe your infrastructure and add it to your repo
Provision with Climulon
Deploy with Climulon

Description

Climulon is a CLI that takes care of provisionning and decommissioning a set of cloudformation templates in AWS, in a modular fashion. Each template of the set can be duplicated, modified or changed, or removed on its own, without impacting the set.
It also takes care of deploying docker images to AWS ECS, and checking the status of the scheduler that is running them.

Climulon consumes configuration files using a templating language similar to the AWS Cloudformation one, to link the multiple templates that describe the infrastructure and the scheduler that runs the docker containers.

Getting started

Prerequisites

Climulon runs on python 3 only.
Its only dependency is boto3

Installing

You can either use Climulon directly from its docker image, build the docker image locally or install it’s dependencies and use it directly from your machine.

Recommended :
Pull the latest Climulon docker image :

docker pull shrobs/climulon:latest

Alternatively :
If you want to run Climulon by building its docker image, just build it locally :

docker build

To install Climulon’s dependencies and use it locally, run the following :

If your system have python 3 as default version:
```
pip install -r requirements.txt
```
If your system have python 2 as default version, make sure that python 3 and pip 3 are installed, and run the following :
```
pip3 install -r requirements.txt
```

Using the CLI

Live examples

You can test how Climulon works by trying these two projects :

Just follow the instructions on the readmes.

Provisionning

An environment can be provisionned using a single command :

Docker :

docker run -v ~/.aws:/root/.aws -v ~/project/infrastructure:/infrastructure shrobs/climulon climulon provision -c /infrastructure/infrastructure.json

Where ~/.aws is the path to your aws configuration folder and ~/project/infrastructure the path of your infrastructure as code folder.

Locally :

climulon provision -c infrastructure.json

Detailed examples can be found in the Live examples section

Decommission

An environment can be Decommissioned using a single command :

Docker :

docker run -v ~/.aws:/root/.aws -v ~/project/infrastructure:/infrastructure shrobs/climulon climulon decommission -c /infrastructure/infrastructure.json

Where ~/.aws is the path to your aws configuration folder and ~/project/infrastructure the path of your infrastructure as code folder.

Locally :

climulon decommission -c infrastructure.json

Detailed examples can be found in the Live examples section

Deployment

An environment can be deployed using a single command :

Docker :

docker run -v ~/.aws:/root/.aws -v ~/project/infrastructure:/infrastructure shrobs/climulon climulon deploy -c /infrastructure/infrastructure.json

Where ~/.aws is the path to your aws configuration folder and ~/project/infrastructure the path of your infrastructure as code folder.

Locally :

climulon deploy -c infrastructure.json

Detailed examples can be found in the Live examples section

Status check

The status of an environment can be checked using a single command :

Docker :

docker run -v ~/.aws:/root/.aws -v ~/project/infrastructure:/infrastructure shrobs/climulon climulon status -c /infrastructure/infrastructure.json

Where ~/.aws is the path to your aws configuration folder and ~/project/infrastructure the path of your infrastructure as code folder.

Locally :

climulon status -c infrastructure.json

Detailed examples can be found in the Live examples section