community.general.supervisorctl (2.5.9) — module

Install collection

Install with ansible-galaxy collection install community.general:==2.5.9

Add to requirements.yml

  collections:
    - name: community.general
      version: 2.5.9

Description

Manage the state of a program or group of programs running via supervisord

Requirements

• supervisorctl

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Manage the state of program to be in started state
  community.general.supervisorctl:
    name: my_app
    state: started

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Manage the state of program group to be in started state
  community.general.supervisorctl:
    name: 'my_apps:'
    state: started

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Restart my_app, reading supervisorctl configuration from a specified file
  community.general.supervisorctl:
    name: my_app
    state: restarted
    config: /var/opt/my_project/supervisord.conf

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Restart my_app, connecting to supervisord with credentials and server URL
  community.general.supervisorctl:
    name: my_app
    state: restarted
    username: test
    password: testpass
    server_url: http://localhost:9001

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Send a signal to my_app via supervisorctl
  community.general.supervisorctl:
    name: my_app
    state: signalled
    signal: USR1

Inputs

    
name:
    description:
    - The name of the supervisord program or group to manage.
    - The name will be taken as group name when it ends with a colon I(:)
    - Group support is only available in Ansible version 1.6 or later.
    required: true
    type: str

state:
    choices:
    - present
    - started
    - stopped
    - restarted
    - absent
    - signalled
    description:
    - The desired state of program/group.
    required: true
    type: str

config:
    description:
    - The supervisor configuration file path
    type: path

signal:
    description:
    - The signal to send to the program/group, when combined with the 'signalled' state.
      Required when l(state=signalled).
    type: str

password:
    description:
    - password to use for authentication
    type: str

username:
    description:
    - username to use for authentication
    type: str

server_url:
    description:
    - URL on which supervisord server is listening
    type: str

supervisorctl_path:
    description:
    - path to supervisorctl executable
    type: path