Skip to content
puppet module for circus
Find file
New pull request
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

A puppet module to manage circus.


You have a package named "circus" that installs:

  • /usr/bin/circusd
  • /usr/bin/circusctl

You are running some OS that uses Upstart, with configuration files in /etc/init/ and an initctl in /sbin.

System Layout

Installs a global /etc/circus.ini, and each circus::watcher instance gets a config file under /etc/circus.d/. The circus daemon is configured to log to /var/log/circus.log, and store a pid file as /var/run/

Example Usage

This puppet code:

circus::watcher {
        cmd  => "/bin/bash",
        args => "-c 'sleep 30'",
        numprocesses => 3;

Creates a config file that looks like this:

cmd = /bin/bash
args = -c 'sleep 30'
warmup_delay = 0
numprocesses = 3

And generates a puppet exec resource you can use to notify when you want to restart your program:

file {
        ensure => file,
        source => "...",
        notify => Exec["circus-restart-petef-test"];
Something went wrong with that request. Please try again.