Skip to main content

A Buildout recipe to generate a Dockerfile for Birdhouse applications.

Project description


.. image::
:alt: Travis Build

.. contents::


``birdhousebuilder.recipe.docker`` is a `Buildout`_ recipe to generate a `Dockerfile`_ for `Birdhouse`_ applications.

.. _`Buildout`:
.. _`Dockerfile`:
.. _`Birdhouse`:


The recipe will generate a Dockerfile for your application. You can find the Dockerfile in the root folder of the application.

Supported options

This recipe supports the following options:

The docker base image name. Default is ``ubuntu``.

The docker base image version. Default is ``latest``.

The maintainer of the Dockerfile.

Description of the Dockerfile.

The vendor of the application. Default: Birdhouse

The version of the application. Default: 1.0.0

Location of the source folder copied into the image. This option is not used it ``git-url`` is present. Default is ``.``.

GitHub URL pointing to the source repo. The sources are copied into the image. Default: None.

Branch of the source repo on GitHub. Default: ``master``.

The location of the ``buildout.cfg`` file used to build. Default: None.

Path to a local ``buildout.cfg`` which is copied into the sources. Default: None.

List of exposed ports.

List of KEY=value pairs added as ENV parameters in the Dockerfile.

Example usage

The following example ``buildout.cfg`` generates a Dockerfile for Ubuntu 14.04:

.. code-block:: ini

parts = docker

recipe = birdhousebuilder.recipe.docker
image-name = ubuntu
image-version = 14.04
maintainer = Birdhouse
description = My Birdhouse App
expose = 8090 8094
environment =


Carsten Ehbrecht ehbrecht at


0.4.2 (2015-12-14)

* added git-url, git-branch, subdir and buildout-cfg options.

0.4.1 (2015-12-10)

* fixed setting of EXPOSE in Dockerfile.

0.4.0 (2015-12-10)

* added environment and expose options.
* enabled travis.

0.3.2 (2015-09-25)

* fixed malleefowl default port in dockerfile template.
* changed dockerfile volumes.

0.3.1 (2015-09-24)

* updated Dockerfile template.
* added output-port option.

0.3.0 (2015-09-22)

* updated Dockerfile template.
* more options added.

0.2.2 (2015-08-05)

* cleaned up ... removed conda dependency.
* update to buildout 2.x.

0.2.1 (2015-04-13)

* Updated Dockerfile template for CentOS builds (sudo was missing).

0.2.0 (2015-03-16)

* Updated Dockerfile template for birdhouse environments.

0.1.1 (2014-11-13)

* Updated Dockerfile template
starts only supervisord.
* Fixed example in Readme.

0.1.0 (2014-11-05)

* Initial Release.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

birdhousebuilder.recipe.docker-0.4.2.tar.gz (9.2 kB view hashes)

Uploaded Source

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page