shaddock 0.3.post136

Easily deploy an OpenStack platform in Docker Containers

Shaddock
============
Shaddock provides a platform deployed in http://docker.com containers following a predefined template (like a basic http://openstack.org infrastructure.)


Usage
-----
A basic infrastructure template can be found in [Shaddock-template](https://github.com/Epheo/shaddock-template) repository.
This template deploy a basic OpenStack infrastructure. You can/should edit it in **/var/lib/shaddock**

Common commands are:
- build [service_name]
- create [service_name]
- start [service_name]
- stop [service_name]
- list
- show [service_name]
- remove [service_name]

Installation
------------

Docker installation
'''''''''''''''''''
https://docs.docker.com/installation/

Shaddock installation
'''''''''''''''''''

sudo pip install shaddock

or

sudo python setupy.py install

Shaddock template installation
''''''''''''''''''''''''''''
(For an OpenStack platform)

git clone https://github.com/Epheo/shaddock-template /var/lib/shaddock/


Configuration
-------------

services.yaml

configuration.yaml

The general architecture of the platform is defined in *services.yaml*
All the configurations (passwords, users, etc.) are in *configuration.yaml*

Both are in [YAML](http://www.yaml.org/)

In order to use Shaddock with a distant server or on **Mac OS** with boot2docker you can change the address in configuration.yaml

INFORMATIONS
------------

Contributing
''''''''''''
I'm really interested in any advice, idea, help, or contribution.

License
'''''''
Shaddock is licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

References
''''''''''
[Docker-py API Documentation](https://github.com/docker/docker-py/blob/master/README.md)