birdhousebuilder.recipe.mongodb 0.4.0

A Buildout recipe to install and setup mongodb with Anaconda.

Introduction

birdhousebuilder.recipe.mongodb is a Buildout recipe to install and setup MongoDB with Anaconda. This recipe is used by the Birdhouse project.

Usage

The recipe requires that Anaconda is already installed. You can use the buildout option anaconda-home to set the prefix for the anaconda installation. Otherwise the environment variable CONDA_PREFIX (variable is set when activating a conda environment) is used as conda prefix.

The recipe will install the mongodb package from a conda channel in a conda environment defined by CONDA_PREFIX. It setups a MongoDB database in {{prefix}}/var/lib/mongodb. It deploys a Supervisor configuration for MongoDB in {{prefix}}/etc/supervisor/conf.d/mongodb.conf. Supervisor can be started with {{prefix}}/etc/init.d/supervisor start.

The recipe depends on birdhousebuilder.recipe.conda and birdhousebuilder.recipe.supervisor.

Supported options

The recipe supports the following options:

anaconda-home

Buildout option pointing to the root folder of the Anaconda installation. Default: $HOME/anaconda.

Buildout options for mongodb:

bind-ip

The IP address that mongodb binds to in order to listen for connections from applications. Default: 127.0.0.1

port

The TCP port on which the MongoDB instance listens for client connections. Default: 27017

Example usage

The following example buildout.cfg installs MongoDB with Anaconda:

[buildout]
parts = myapp_mongodb

[myapp_mongodb]
recipe = birdhousebuilder.recipe.mongodb
port = 27020

Authors

Carsten Ehbrecht ehbrecht at dkrz.de

Changes

0.4.0 (2016-10-20)

• updated to yaml config for mongodb 2.6

• pep8

0.3.0 (2016-06-19)

• using zc.recipe.deployment.

• separate conda env from install-prefix.

0.2.2 (2015-10-07)

• bind_ip and port are now configurable.

• logs to supervisor.

0.2.1 (2015-06-25)

• added user option.

0.2.0 (2015-02-24)

• installing in conda enviroment birdhouse.

• using $ANACONDA_HOME environment variable.

• separation of anaconda-home and installation prefix.

0.1.1 (2014-08-01)

Updated documentation.

0.1.0 (2014-07-10)

Initial Release.