Skip to main content

A Buildout recipe to install and configure supervisor for Anaconda.

Project description

Introduction

birdhousebuilder.recipe.supervisor is a Buildout recipe to configure Supervisor services 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.

The recipe will install the supervisor 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 of a given service. The configuration will be deployed in the birdhouse enviroment ~/.conda/envs/birdhouse/etc/supervisor/conf.d/myapp.conf. Supervisor can be started with ~/.conda/envs/birdhouse/etc/init.d/supervisord start.

The recipe depends on birdhousebuilder.recipe.conda.

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

supervisor-port

Buildout option (optional) to set the supervisor port. Default is 9001 (http://localhost:9001).

program

The name of the supervisor service.

command

The command to start the service.

directory

The directory where the command is started.

Example usage

The following example buildout.cfg installs a Supervisor configuration for myapp web application:

[buildout]
parts = myapp

anaconda-home = /home/myself/anaconda
supervisor-port = 9001

[myapp]
recipe = birdhousebuilder.recipe.supervisor
program = myapp
command = ${buildout:bin-directory}/gunicorn -b unix:///tmp/myapp.socket myapp:app
directory = /tmp

Authors

Carsten Ehbrecht ehbrecht at dkrz.de

Changes

0.2.0 (2014-02-24)

  • installing in conda enviroment birdhouse.

  • using $ANACONDA_HOME environment variable.

  • separation of anaconda-home and installation prefix.

0.1.5 (2015-01-22)

  • bugfix: var/log/supervisor directory is now created.

0.1.4 (2014-12-06)

  • Don’t update conda on buildout update.

0.1.3 (2014-07-31)

  • Updated documentation.

0.1.2 (2014-07-24)

  • Removed workaround “kill nginx”.

0.1.1 (2014-07-22)

  • Not using supervisor-host option.

0.1.0 (2014-07-10)

  • 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

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