This module provides a REST API that makes easy to build services with Puppet and Docker.

It takes as input some files like puppetfiles, puppet manifests, dockerfiles and docker-compose files and builds a container infrastructure which can be deployed in remote machines (also using the API).

It uses several docker components: host, builder, registry, swarm and compose. Also puppet tools like the puppet agent itself and r10k.

Take a look at this guide.

Crane runs in several docker containers.

• commander: contains the application which control all the logic (controllers) and a micro web server with the REST API (and a nice Swagger UI). 'Temp. storage' is a volume from this container and stores temporal files that the API receives (manifests, Dockerfiles...) and another temporal information like logs and another files useful for debuging.
• redis: container that runs an standalone redis. This redis is used as context information storage for the commander app. It allows the commander to restart, go down and even upgrade maintaining the status. This redis can be disabled leaving commander using a filesystem type datastore.
• docker-engine: this container provides an interface for a docker-engine. This docker-engine runs in the host but with a separate namespace. This is used for building images.
• docker-registry: container that runs a private registry where base images and builded images will be stored.

• Docker 1.8 or superior
• Docker-compose 1.4 or superior
• OpenSSL

Generate some self-signed certificates needed for the communication between components and with external elements. Just execute the script:

./genCerts.sh

This will generate several certs folders (one in each component) with the needed certificates.

These can be replaced with certificates obtained in other ways.

Type:

docker-compose -f <environment>.yml up

and docker-compose will build and run all the components.

Replace <environment> with development, production or test.

With the steps above.

You can use your favourite browser to navigate to http://127.0.0.1:8888. It will show a swagger UI interface with all the API specification.

Working on

• Multihost swarm

Issues

• Nothing serious.

• General refactoring
• Distributed building
• Docker-swarm complete support
  • customize hardware requirements by container with tags
• Update services on-the-fly
• Manage network parameters

Execute the script runTests.sh. You will need root permissions because it deletes files created by containers that runs as root.