Beekeeper::Config - Read configuration files
Version 0.01
Beekeeper applications use two config files to define how clients, workers and brokers connect to each other.
These files are searched for in ENV BEEKEEPER_CONFIG_DIR, ~/.config/beekeeper and then /etc/beekeeper.
BEEKEEPER_CONFIG_DIR
~/.config/beekeeper
/etc/beekeeper
This file defines all worker pools running on this host, specifying which logical bus should be used and which services it will run.
The file format is in relaxed JSON, which allows comments and trailings commas.
Each entry define a worker pool. Required parameters are:
pool-id: arbitrary identifier for the worker pool
pool-id
bus-id: identifier of logical bus used by worker processes
bus-id
workers: a map of worker classes to arbitrary config hashes
workers
Example:
[ { "pool-id" : "myapp", "bus-id" : "backend", "description" : "pool of MyApp workers", "workers" : { "MyApp::Service::Foo::Worker" : { "workers_count" : 4 }, "MyApp::Service::Bar::Worker" : { "workers_count" : 2 }, }, }, ]
This file defines all logical buses used by your application, specifying the conection parameters to the STOMP brokers that will service them.
For development purposes is handy to use a single broker to hold all logical buses and easily simulate a complex topology, but in production enviroments brokers should be isolated from each other.
Each entry define a logical bus. Required parameters are:
bus-id: unique identifier for the logical bus
host: hostname or IP address of the STOMP broker
host
user: username used to connect to the STOMP broker
user
pass: password used to connect to the STOMP broker
pass
vhost: virtual host of STOMP broker (may be omitted)
vhost
[ { "bus-id" : "backend", "host" : "localhost", "user" : "backend", "pass" : "def456", "vhost" : "/back", }, { "bus-id" : "frontend", "host" : "localhost", "user" : "frontend", "pass" : "def456", "vhost" : "/front", }, ]
Reads and parse bus.config.json and returns the config of the requested bus.
bus.config.json
Reads and parse pool.config.json and returns the config of the requested pool.
pool.config.json
Reads the given file and returns its content parsed as JSON.
José Micó, jose.mico@gmail.com
jose.mico@gmail.com
Copyright 2015 José Micó.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language itself.
This software is distributed in the hope that it will be useful, but it is provided “as is” and without any express or implied warranties. For details, see the full text of the license in the file LICENSE.
1 POD Error
The following errors were encountered while parsing the POD:
Non-ASCII character seen before =encoding in 'José'. Assuming UTF-8
To install Beekeeper, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Beekeeper
CPAN shell
perl -MCPAN -e shell install Beekeeper
For more information on module installation, please visit the detailed CPAN module installation guide.