Description

Installs (Python) supervisor and provides resources to configure services

Requirements

Platform:

Tested on Ubuntu 10.04

Cookbooks:

python

Attributes

node['supervisor']['dir'] - location of supervisor config files
node['supervisor']['log_dir'] - location of supervisor logs
node['supervisor']['inet_http_server']['enable'] - enable/disable web interface
node['supervisor']['inet_http_server']['host'] - web interface host to listen
node['supervisor']['inet_http_server']['port'] - web interface port
node['supervisor']['inet_http_server']['username'] - web interface username
node['supervisor']['inet_http_server']['password'] - web interface password

Resources/Providers

supervisor_service

Actions

The default action is the array [:enable, :start]. Actions use the supervisorctl program.

:enable - enables the service at boot time
:disable - disables the service at boot time
:start - starts the service
:stop - stops the service
:restart - restarts the service
:reload - reloads the service

Attribute Parameters

:service_name - (Name Attribute), a string, name of the service

The following attributes are used in the program.conf.erb as the values for the corresponding configuration option. See the supervisor documentation for more information about each setting, including applicable defaults.

:command - string
:process_name - string
:numprocs - integer
:numprocs_start - integer
:priority - integer
:autostart - true or false
:autorestart - string, symbol, true or false
:startsecs - integer
:startretries - integer
:exitcodes - array
:stopsignal - string or symbol
:stopwaitsecs - integer
:user - string or nil
:redirect_stderr - true or false
:stdout_logfile - string
:stdout_logfile_maxbytes - string
:stdout_logfile_backups - string
:stdout_capture_maxbytes - string
:stdout_events_enabled - true or false
:stderr_logfile - string
:stderr_logfile_maxbytes - string
:stderr_logfile_backups - integer
:stderr_capture_maxbytes - string
:stderr_events_enabled - true or false
:environment- hash
:directory- string or nil
:umask - string or nil
:serverurl - string

Examples

supervisor_service "celery" do
  action :enable
  autostart false
  user "nobody"
end

Recipes

default

Includes the python recipe, installs the supervisor PIP package and sets up supervisor.

License and Author

Author:: Noah Kantrowitz noah@opscode.com

Author:: Gilles Devaux gilles.devaux@gmail.com

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

picur/supervisor