Support a 'signalled' state in the supervisorctl module

[ansibot]

From @underyx on 2016-03-22T10:51:59Z

Issue Type:

• Feature Idea

Component Name:

supervisorctl module

Ansible Version:

N/A

Ansible Configuration:

N/A

Environment:

N/A

Summary:

Supervisor 3.2.0 introduced the signal command for supervisorctl. This allows sending an arbitrary signal to supervised processes with the command supervisorctl signal <signal name> <name>. This could be used to for example reload nginx by sending it a SIGHUP, instead of using state=restarted and having it shut down momentarily.

Steps To Reproduce:

- name: restart nginx
  service: name=nginx state=restarted

- name: reload nginx
  service: name=nginx state=reloaded

- name: restart supervised nginx
  supervisorctl: name=nginx state=restarted

- name: reload supervised nginx
  supervisorctl: name=nginx state=signalled signal=SIGHUP

Copied from original issue: ansible/ansible-modules-core#3299

[ansibot]

From @stevelle on 2016-03-22T10:51:59Z

+1 for this feature idea.
Applies to recommended use of uwsgi as well where HUP signal is used for a graceful reload of the app, and several other signals are encouraged for other uses.

[ansibot]

From @dellsystem on 2016-03-22T10:51:59Z

+1 as well, would love this feature.

[ansibot]

From @tedder on 2016-03-22T10:51:59Z

SIGHUP type support would certainly cut down on some of the times where I use state=restarted.

[ansibot]

From @dellsystem on 2016-03-22T10:51:59Z

Turns out adding a "reloaded" state is a pretty simple fix:

dellsystem/ansible-modules-core@a97896c

I was going to submit a PR for this as well, but if anyone needs this functionality in the meantime, you can edit the source file yourself and apply the changes on lines 110 and 208-215. That should work if you're on the latest version of ansible (2.1.0). If you're on an older version, the code will be slightly different, but the basic instructions are:

1. find

state=dict(required=True, choices=['present', 'started', 'restarted', 'stopped', 'absent'])

and add 'reloaded' to the list of choices; then,

1. find the block that starts with

if state == 'restarted':

and clone the whole block directly underneath, replacing 'restarted' with 'reloaded', 'restart' with 'signal SIGHUP', and 'started' with 'signalled'.

[ansibot]

From @mattupstate on 2016-03-22T10:51:59Z

needs_contributor

[ansibot]

Thank you very much for your interest in Ansible. Ansible has migrated much of the content into separate repositories to allow for more rapid, independent development. We are closing this issue/PR because this content has been moved to one or more collection repositories.

• lib/ansible/modules/web_infrastructure/supervisorctl.py -> https://galaxy.ansible.com/community/general

For further information, please see:
https://github.com/ansible/ansibullbot/blob/master/docs/collection_migration.md