Shared Configuration Interface using CouchDB as a backend
sharedconfig package is used to provide applications a mechanism for sharing application configuration information across a network of machines.
So why would you want to use
sharedconfig over many of the other excellent node configuration libraries. Primarily, because this configuration engine is designed to grab configuration information from a single configuration server. Additionally, the CouchDB
_changes feed is used (via nano and follow) to monitor changes in the config.
Combine this with the magic of xdiff and you have a really powerful little configuration service for your application. Here, let me show you:
To get started with
sharedconfig you simply need to create a new sharedconfig instance:
var config = sharedconfig'';
Once you have a config instance, you can then use a particular environment configuration. The
use command operates asynchronously and fires a callback once the complete merged config has been loaded for the target environment.
Merged config? What does that mean? Well, the merged config is the result of merging the data contained within the
default document and the data contained within the requested environment. To get a feel for how this works in practice, why not have a look at the contents of the two documents that are merged within the test db:
Which produces the merged results (via the lodash merge function) of:
use operation has completed, the configuration data will be made available directly on the created shared config object. In our case, this is a variable called
console.logconfigredishost;// => localhost
Now while all of this is useful in it's own right, it pales in comparison with what you can do when you combine the magic of the CouchDB
_changes feed into the mix.
Once you are using a config environment / area that area will be monitored for changes, and this will generate events on the config object. Additionally, there are two types of config change events that are fired:
- targeted updates using the
- a blanket
changedevent that is triggered after the individual update events have been fired. It's important to note that at the moment the
changedevent will fire after a configuration is loaded regardless of whether anything changed in the config or not. I'm open to discussion about this.
Handling config loads on environment selection / change:
configuse'dev'on'changed'// handle updates;
Listening for targeted changes on a specific configuration property. These events are triggered when a configuration change is detected for a specific property. This can happen when either a different environment is selected using the
use method, OR; a configuration update has been made to the CouchDB backend and it is picked up in the
configon'update.redis.host'console.log'The host has changed to: ' + newHost;;
Additionally, because EventEmitter2 has been used for the events system, you can also listen for wildcard events:
configon'update.redis.*'// no point looking at the value// and might be worth throttling the handler to deal with the event being fired twice// if both the port and the host changedconsole.log'Redis config has changed: ' configredis;;