Pixiebox

Docker development simplified.

Start pixiebox and continue with the way you have always done things, except now, isolated inside containers

Install CLI

$ gem install pixiebox
$ pixiebox install

That's it your done

Available boxes

elixir
nodejs
python
rails
ruby

Create rails box

$ mkdir -p Code/rails
$ cd Code/rails
$ pixiebox init rails

Your box is up and running, use your container-ized rails as you would normally

Create a rails project

$ pb-gem install rails --no-ri --no-rdoc
$ pb-rails new .
$ pb-rails c
$ pb-rake -T
$ pb-rails s

Install gems, irb, bundler and more

$ pb-gem install rails --no-ri --no-rdoc
$ pb-irb
$ pb-bundle install
$ pb-ruby

Everything is running inside your box ! Commands are namespaced to avoid conflict with already existing tools in your environment.

Detailed Usage

Commands:
  pixiebox boxes               # list of available boxes
  pixiebox help [COMMAND]      # Describe available commands or one specific command
  pixiebox init [BOX]          # initialize directory for use with pixiebox
  pixiebox install             # installs pixiebox
  pixiebox reset               # reset pixiebox containers
  pixiebox restart             # restart pixiebox
  pixiebox service SUBCOMMAND  # do things with the SERVICES
  pixiebox ssh [SERVICE]       # open shell to service
  pixiebox start               # start pixiebox
  pixiebox status              # current status of containers
  pixiebox stop                # stop pixiebox
  pixiebox uninstall           # removes pixiebox
  pixiebox update              # udpates pixiebox
  pixiebox version             # displays current version

Commands:
  pixiebox service add [SERVICE]             # adds a service to your box
  pixiebox service build [SERVICE] optional  # builds the pixiebox
  pixiebox service help [COMMAND]            # Describe subcommands or one specific subcommand
  pixiebox service list                      # list available services
  pixiebox service remove [SERVICE]          # removes a service from your box

Options:
  [--verbose], [--no-verbose]  # Verbose debugging output

Dependencies

Linux

• build-essential
• ruby
• ruby-dev

Development

To run the tests you'll need ruby ^2.3 since we are using the <<~EOS operator (un-indented multiline strings)

After checking out the repo, run bin/setup to install dependencies. Then, run bundle exec rspec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To use without installing, use:

$ bin/pixiebox_dev version

To run tests:

$ bundle exec guard -g rspec
$ bundle exec guard -g acceptance
$ bundle exec guard -g wip

To install locally:

$ rake build
$ gem install pkg/pixiebox-x.x.x.gem

Helpful stuff

debug during an aruba test run

export REMOTE_DEBUG=true
guard -g wip

then connect using:

$ bundle exec byebug -R localhost:8989

will show that last command aruba executed

(byebug) last_command_started

License

The gem is available as open source under the terms of the MIT License.