...

What is Supervisor?

Supervisor is a process manager that can be used to control scripts as a service. See http://supervisord.org/.

We offer this process manager with two options:

1. we configure the supervisor service to run the command the customer requires

2. the customers can write and configure supervisor services themselves

To use supervisor, open a ticket and write us what you need it for.

After we understand what you need, we install and configure supervisor on the needed systems. Supervisor can then be used by the customer.

Details on Option 2

 Important: The customer is responsible for the configuration and correct functioning of their supervisor services! 

Functionality

A supervisor service is started in the context of www-data. This monitors a shared path to supervisor configuration files.

Requirements for these configuration files are:

• File suffix must be .conf

• May only contain the configuration for '[program]' ( http://supervisord.org/configuration.html#program-x-section-settings )

• Has only access to the Webroot

• may not depend on defining the option 'user' as the program is always started as www-data

Supervisor is automatically restarted after each deployment, so that new and changed configuration for new supervisor services can be imported and started.

...

All configured processes and the supervisor can be controlled by the following command:  

sudo -u www-data supervisorctl -c /etc/supervisor/supervisord_www-data.conf

...