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
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.
Climulon runs on python 3 only.
Its only dependency is boto3
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
You can test how Climulon works by trying these two projects :
Just follow the instructions on the readmes.
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
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
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
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