Installation (deprecated version)

Clouni requires Python 3.6 to be used.

To install Clouni is recommended to create virtual environment and install requirements in your environment.

python3.6 -m venv $VIRTUALENV_HOME/clouni

It’s recommended not to use $CLOUNI_HOME as your $VIRTUALENV_HOME

Install Clouni requirements in you virtual environment if you will use this virtual environment to execute playbooks.

Files requirements-ansible.txt and requirements-cotea.txt required for using Clouni with Openstack and AWS based clouds since the current version of Clouni automatically deploys TOSCA templates.

source $VIRTUALENV_HOME/clouni/bin/activate
cd $CLOUNI_HOME
pip install -r requirements.txt
pip install -r requirements-ansible.txt
pip install -r requirements-cotea.txt

To use Clouni as gRPC server install requirements

pip install -r requirements-grpc.txt

Install required OpenStack TOSCA Parser in your virtual environment. Current version of TOSCA Parser doesn’t have required changes. Use temporary fork repository.

cd $CLOUNI_HOME/../
git clone https://github.com/bura2017/tosca-parser.git
cd tosca-parser
git checkout develop
pip install -r requirements.txt
python setup.py install

Installation command

cd $CLOUNI_HOME
python setup.py install

Install with Docker

You can use Docker installation.

docker run --name clouni-server -d -p <ip_address>:<port>:50051 clouni/clouni:latest

Or start Clouni gRPC server container from source with help of Docker. Container support both server and CLI version.

From Dockerfile you can get image for clouni-server container:

cd $CLOUNI_HOME
docker build -t clouni - < dockerfile

Then start the server on IP_address:port you needed:

docker run --name clouni-server -d -p IP_address:port:50051 clouni