renv


A dead simple command line interface for managing remote configuration. Powered by etcd, inspired by heroku.

renv gives you:

* a heroku-inspired interface (set, unset).
* tools for managing your environment using JSON configuration files (import).

Installation

npm install renv -g

Core Concepts

$3

renv prefixes the configuration it stores with /:application/:environment, where:

* application: is the application that you wish to store configuration for.
(it tries to grab this out of a package.json).
* environment: is the environment to store the configuration for, e.g.,
development, production, test.

this is opinionated, but it works dang it!

$3

rather than serializing JSON to a single key, renv uses directories in
etcd to store a representation of the imported JSON file.

This is cool because:

* you can listen for changes on individual keys.
* you can modify keys atomically.

$3

Use a .renvrc to store information about your production etcd host:

``ini
hosts=etcd.example.com:443
ssl=true
`

The Interface

$3

List all configuration for a given application, and environment.

Use --output json, to dump the configuration to disk:

renv config --environment production --output json > service.json.

$3

Set a single configuration variable:

renv set URL=http://www.example.com

Set multiple configuration variables:

renv set URL=http://www.example.com TIMEOUT=5000

Creating or updating an object:

renv set OBJ.x 33 OBJ.y 99

Creating or updating an array:

renv set ARR.0 33 ARR.1 99

$3

Delete a single configuration variable:

renv unset OBJ

Delete multiple configuration variables:

renv unset OBJ ARR

$3

Import a JSON file and create keys and directories recursively.

renv import ./test/fixtures/service.json

$3

nuke all configuration for the current application and environment

__Danger, Will Robinson.__

renv nuke

$3

Dump configuration for all applications and environments:

renv dump

$3

Merge two configuration environments, useful if production servers only
vary slightly.


renv merge --application2 production-server-east`