MiCADO - autoscaling framework for Docker services on Cloud

This software is developed by the COLA project.

MiCADO is an auto-scaling framework for Docker applications. It supports autoscaling at two levels. At virtual machine (VM) level, a built-in Docker Swarm cluster is dynamically extended or reduced by adding/removing docker nodes hosted on cloud virtual machines. At container level, the number of replicas implementing a Docker Service is automatically increased/decreased. The application detailing the services, links and scaling rules must be specified by a TOSCA description.

MiCADO manual is hosted at https://micado-scale.readthedocs.io .

Manuals for MiCADO versions are as follows, and then is a very basic quick start guide below:

• MiCADO 0.7.3
• MiCADO 0.7.2-rev1
• MiCADO 0.7.2
• MiCADO 0.7.1
• MiCADO 0.7.0
• MiCADO 0.6.1
• MiCADO 0.6.0
• MiCADO 0.5.0

Quick Start Guide

Requirements

1x MiCADO Master

• 2 CPU / 4GB RAM / 20GB DISK
• Ubuntu 16.04 LTS
• On a supported cloud
  • AWS EC2
  • CloudSigma
  • CloudBroker
  • OpenStack

1x Ansible Remote (or locally on Master)

• Ansible >= v2.4
• curl
• jq (for test scripts)
• wrk (for test scripts)

Set-up

Clone the repository & prepare the credentials:

git clone https://github.com/micado-scale/ansible-micado micado
cd micado
cp sample-hosts.yml hosts.yml
cp sample-credentials-cloud-api.yml credentials-cloud-api.yml
cp sample-credentials-micado.yml credentials-micado.yml
#option to login to private registry# cp sample-credentials-docker-registry.yml credentials-docker-registry.yml

Fill the hosts file with micado-master vars for ansible_host (Master IP) and ansible_user (SSH user) and the credentials- files with usernames & passwords:

vim hosts.yml
vim credentials-cloud-api.yml
vim credentials-micado.yml
#option to login to private registry# vim credentials-docker-registry.yml

Run the playbook to completion:

ansible-playbook -i hosts.yml micado-master.yml

Now view the MiCADO Dashboard at https://<MiCADO_Master_IP>

Testing

Prepare a test by filling _settings with your MiCADO Master IP:

cd testing/stressng
vim _settings

Fill the required fields (ADD_YOUR_ID ...) under the worker-node virtual machine with IDs from your cloud service provider, then run the test scripts:

cp stressng_<yourcloud>.yaml stressng.yaml
vim stressng.yaml
./1-submit-tosca-stressng.sh
./2-list-apps.sh
./3-stress-cpu-stressng.sh 85

Check out the Dashboard to see the test scale up, and undeploy when done:

./4-undeploy-stressng.sh