A role for creating supervisor tasks.

NOTE: This role depends on facts being gathered and will fail when gather_facts is set to false/no.

• Ensures that supervisor is installed (using apt)
• Creates a task in the supervisor conf directory.

  roles:
    - role: EDITD.supervisor_task
      name: webserver
      command: python -m SimpleHTTPServer
      directory: /opt/web
      user: ubuntu
      stopsignal: HUP

By default, the role will restart the task on each run, which you could skip like so:

  roles:
    - role: EDITD.supervisor_task
      name: webserver
      command: python -m SimpleHTTPServer
      directory: /opt/web
      user: ubuntu
      restart_task: no

Starting with supervisor 3.2.0, there is also the ability to send signals to tasks. A good example where this might come in handy is signaling web servers, e.g. uwsgi, to gracefully restart their workers. An example of how to do that would be:

  roles:
    - role: EDITD.supervisor_task
      name: webserver
      command: uwsgi
      directory: /opt/web
      user: ubuntu
      restart_task: no
      signal_task: HUP

Unfortunately versions 3.2.0+ of supervisor are not compatible with Ubuntu 12.04, in which case an older supervisor version is installed instead, without signaling support. In these systems tasks will always be restarted, even when restart: no is passed to the role.

MIT