birdhousebuilder.recipe.redis

Introduction

birdhousebuilder.recipe.redis is a Buildout recipe to install and configure Redis in-memory datastore with Anaconda. This recipe is used by the Birdhouse project.

Usage

The recipe requires that Anaconda is already installed. It assumes that the default Anaconda location is in your home directory ~/anaconda. Otherwise you need to set the ANACONDA_HOME environment variable or the Buildout option anaconda-home.

It installs the redis package from a conda channel in a conda enviroment named birdhouse. The location of the birdhouse environment is .conda/envs/birdhouse. It deploys a Supervisor configuration for Redis in ~/.conda/envs/birdhouse/etc/supervisor/conf.d/redis.conf. Supervisor can be started with ~/.conda/envs/birdhouse/etc/init.d/supervisord start.

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

Supported options

This recipe supports the following options:

anaconda-home

Buildout option with the root folder of the Anaconda installation. Default: $HOME/anaconda. The default location can also be set with the environment variable ANACONDA_HOME. Example:

export ANACONDA_HOME=/opt/anaconda

Search priority is:

1. anaconda-home in buildout.cfg
2. $ANACONDA_HOME
3. $HOME/anaconda

port

Accept connections on the specified port. Default: 6379.

loglevel

Specify the server verbosity level (debug, verbose, notice, warning). Default: warning.

Example usage

The following example buildout.cfg installs Redis with Anaconda and default options:

[buildout]
parts = redis

anaconda-home = /home/myself/anaconda

[redis]
recipe = birdhousebuilder.recipe.redis