spaceapegames / bog

A tool for managing cloud API and configuration management credentials. rbenv for dotfiles.

bog

A tool for managing cloud API and configuration management credentials. rbenv for dotfiles.

It is brought to you by the folks at OpsUnit.

Introduction

In a modern operations team it is common to have many different sets of credentials and dotfile configurations. You may have multiple clients, or may split your environments between EC2 accounts. bog allows you to easily work with collections of dotfile configurations and to swap between those sets.

Example

$ bog myclient init --aws --chef	# Configure ~/.bog with stubs for AWS and Chef under profile 'myclient'
Enter your Amazon Secrect Access Key:
...
$ bog myclient					# Switch to profile 'myclient'
$ knife client list
$ aws s3 ls
...
$ bog personal					# Switch to another profile
...

One-off commands

$ bog myclient exec aws s3 ls          # Exec command as myclient, then
$ bog myclient exec knife client list  # switch back to previous profile 
...

How it works

bog init myclient --aws --chef will create

.bog
├── current -> profiles/myclient/
├── plugins
└── profiles
    └── myclient
        ├── .aws
        └── .chef

If you passed a switch such as --aws then the correctly named configuration files will be present and populated. Otherwise you are free to include whatever you choose.

bog will never touch your ~/.aws and similar directories. You will need to symlink these to ~/.bog/current/.aws (as appropriate) in order to have bog work.

Why another dotfile manager

There are plenty out there. bog aims to fit a modern operational workflow and toolset.

Development

The gem and its dependencies are tested against the following ruby versions:

• 1.9.3
• 2.0.0
• 2.1.0