evandbrown / habitat

habitat is a coreutils 'env' clone to link 12factor apps and service discovery systems as consul and etcd. It queries the kv db embedded in those systems and export the data as env variables. If you don't use etcd or consul, there's a redis module to capture data from a hash.

Habitat

What

Habitat is a golang clone of coreutils env that talks to many service discovery systems to create an enviroment and run applications. Habitat retrieves key/values from you service discovery/distributed kv and add it to the env passed to applications. It enables dynamic 12 factor app with custom runners. It is perfect for containers or applications which need distributed configuration values or quick time to spin with zero touch.

Usage

Run your application with habitat app_name for a local env, habitat -e for etcd based env and habitat -c for consul based queries. To eliminate the local env add the -n option. To access a daemon on a remote server use -p host:port Your keys need to be added in a way where the root name is the appname.

Build

$ cd src ; make

Options

- -e etcd <etcd addr:port>
- -c consul <consul addr:port>
- -r redis <redis addr:port>
- -n do not add local env
- -p host:port for remote servers

Examples (using env to show the new env vars)

- etcd
	$ curl http://127.0.0.1:4001/v1/keys/app/db -d value="newdb"
	$ curl http://127.0.0.1:4001/v1/keys/app/cache -d value="newcache"
	$ curl http://127.0.0.1:4001/v1/keys/app/queue -d value="datqueue"
	$ habitat -e 127.0.0.1:4001 env

- redis
	$ redis-cli hset app db newdb
	$ redis-cli hset app cache newcache
	$ redis-cli hset app queue newqueue
	$ habitat -r 127.0.0.1:6379 env

- consul
	$ curl -X PUT -d 'newdb' http://localhost:8500/v1/kv/app/db
	$ curl -X PUT -d 'newcache' http://localhost:8500/v1/kv/app/cache
	$ curl -X PUT -d 'newqueue' http://localhost:8500/v1/kv/app/queue
	$ habitat -c 127.0.0.1:8500 env

You can mix data coming from all sources too.

Authors

Gleicon <[e-mail]>

License MIT