slingshot

slingshot

Slingshot is a command-line tool that allows you to easily write configuration values stored in formats like YAML and JSON as well as plain text to etcd.

Status

This project is pretty much a hack and should not be considered production ready. For this tool to be production ready, it needs the following:

• Tests.
• Code that isn't awful.
• Client library support.

Installation

To install Slingshot, you will need to have Go v1.3 or higher installed. Simply run:

$ go install github.com/bradgignac/slingshot

The slingshot binary is now available in your $GOPATH. Once the first version of this tool is officially released, binaries will be published to GitHub.

Usage

This section describes the options and commands available in Slingshot. The config files used in the code samples are located in the examples directory at the root of the repository. For more information about Slingshot commands and their options, run slingshot --help.

Push

The push command provides support for writing config files to etcd.

$ slingshot push examples

You can specify as many arguments to push as you'd like, and they can be either directories or files.

Global Options

Slingshot provides several global options that can be specified with every command.

Key

By default, all configuration files are written to the _slingshot directory. Config values are written to this directory to provide an isolated space where Slingshot can perform operations.

If you'll be storing configuration for multiple projects in the same etcd cluster, you should override this option with a different key for each project. Use the --key flag to set a custom directory.

$ slingshot --key _myproject push examples

Etcd Peers

Slingshot assumes etcd is available at http://127.0.0.1:4001. If you need specify an alternate etcd location, use the --peer flag to provide one or more URLs for nodes in your etcd cluster.

$ slingshot --peer http://10.10.10.1:4001 push examples

License

Slingshot is released under the MIT License.