Symfony bundle to automatically create and update supervisor configurations for php-amqplib/rabbitmq-bundle
(and its predecessor oldsound/rabbitmq-bundle
) RabbitMQ consumer daemons.
If you use php-amqplib/rabbitmq-bundle
to handle the communication with RabbitMQ, just add this bundle and run
app/console rabbitmq-supervisor:rebuild
to get a running supervisord
instance that automatically manages all your consumer daemons.
When your worker configuration or your code changes, run
app/console rabbitmq-supervisor:rebuild
again and all the daemons will be updated.
Add bundle via command line
php composer.phar require phobetor/rabbitmq-supervisor-bundle
or manually to composer.json
file
{
"require": {
"phobetor/rabbitmq-supervisor-bundle": "~1.3"
}
}
Fetch the needed files:
$ php composer.phar update phobetor/rabbitmq-supervisor-bundle
This will install the bundle to your project’s vendor
directory.
Add the bundle to your project’s AppKernel
:
<?php
// app/AppKernel.php
public function registerBundles()
{
$bundles = [
// […]
new Phobetor\RabbitMqSupervisorBundle\RabbitMqSupervisorBundle(),
];
}
RabbitMQ supervisor bundle works out of the box with a predefined configuration. If you leave it this way you will end up with this directory structure:
app/supervisor/
└── dev
├── logs
│ ├── stderr.log
│ └── stdout.log
├── supervisord.conf
├── supervisord.log
├── supervisor.pid
├── supervisor.sock
└── worker
├── queue1.conf
├── queue2.conf
├── queue3.conf
└── queue4.conf
All the paths and commands can be changed in app/config/config.yml
:
rabbit_mq_supervisor:
worker_count: 1 # number of workers per queue
supervisor_instance_identifier: instance_name
paths:
workspace_directory: /path/to/workspace/
configuration_file: /path/to/workspace/supervisord.conf
pid_file: /path/to/workspace/supervisord.pid
sock_file: /path/to/workspace/supervisord.sock
log_file: /path/to/workspace/supervisord.log
worker_configuration_directory: /path/to/workspace/worker/
worker_output_log_file: /path/to/workspace/logs/%kernel.environment%.log
worker_error_log_file: /path/to/workspace/logs/%kernel.environment%.log
commands:
rabbitmq_consumer: user-specific-command:consumer -m %%1$d %%2$s
rabbitmq_multiple_consumer: user-specific-command:multiple-consumer -m %%1$d %%2$s
Build or rebuild the supervisor and worker configuration and start the daemon:
app/console rabbitmq-supervisor:rebuild
Control the supervisord daemon:
app/console rabbitmq-supervisor:control stop
app/console rabbitmq-supervisor:control start
app/console rabbitmq-supervisor:control restart
app/console rabbitmq-supervisor:control hup