supervisorctl - Manage the state of a program or group of programs running via Supervisord

Author:Matt Wright

Synopsis

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

Options

parameter required default choices comments
config no
    configuration file path, passed as -c to supervisorctl (added in Ansible 1.3)
    name yes
      The name of the supervisord program/process to manage
      password no
        password to use for authentication with server, passed as -p to supervisorctl (added in Ansible 1.3)
        server_url no
          URL on which supervisord server is listening, passed as -s to supervisorctl (added in Ansible 1.3)
          state yes
          • present
          • started
          • stopped
          • restarted
          The state of service
          supervisorctl_path no
            Path to supervisorctl executable to use (added in Ansible 1.4)
            username no
              username to use for authentication with server, passed as -u to supervisorctl (added in Ansible 1.3)

              Examples


              # Manage the state of program to be in 'started' state.
              - supervisorctl: name=my_app state=started
              
              # Restart my_app, reading supervisorctl configuration from a specified file.
              - supervisorctl: name=my_app state=restarted config=/var/opt/my_project/supervisord.conf
              
              # Restart my_app, connecting to supervisord with credentials and server URL.
              - supervisorctl: name=my_app state=restarted username=test password=testpass server_url=http://localhost:9001
              

              Table Of Contents

              Previous topic

              jboss - deploy applications to JBoss

              Next topic

              Detailed Guides