furthermore's Introduction

furthermore

Interim censeo, Carthago delenda est. She is a menace to Rome.

furthermore is a command-line tool that manipulates keys in an etcd server or cluster somewhere over there. It's meant to be more convenient than etcdctl. npm install -g furthermore to begin setting keys.

It uses a file named ~/.etcdrc for config. That file looks like this:

[default]
hosts=etcd.example.com:443
ssl=true

[staging]
hosts=staging-etcd.example.com:443
ssl=true

[cluster]
hosts[]=etcd-1.example.com:443
hosts[]=etcd-2.example.com:443
ssl=true

The named sections may be passed to the --env option to use a different etcd host group than the default.

Usage:

furthermore: manipulate keys on a remote etcd server

Commands:
  backup             emit all keys in the given db as a json object
  get <key>          get the value for a key; wrap the key in // to treat it as a regexp
  grep <pattern>     search for values matching the given regexp pattern
  import <json>      import key/value pairs from a json file & set them in etcd
  ls <dir>           get a directory listing
  mkdir <dir>        create the named directory, recursively
  reconcile <json>   report how the keys in the given json file differ from the keys in etcd
  rm <key>           remove a key
  rmdir <dir>        remove the named directory
  set <key> <value>  set a key to a new value

Options:
  --env, -e  which etcd host group to use                   [default: "default"]
  --version  Show version number                                       [boolean]
  --help     Show help                                                 [boolean]

Examples:
  furthermore ls /deploys
  furthermore mkdir /deploys/website
  furthermore set /deploys/website/commit bfc8d32
  furthermore get /deploys/website/commit
  furthermore get "/foo/b.*/"
  furthermore rm /deploys/website/commit
  furthermore -e staging set canonical-host https://example.com