No description
Find a file
Will Farrington 011f08e42b Merge pull request #1 from boxen/enable_puppet
Enable real Puppet runs
2012-10-07 18:01:33 -07:00
config add some docs about overrides 2012-10-05 12:05:58 -10:00
lib Preserve lib/ or Puppet will create it as root 2012-10-04 13:46:12 -07:00
manifests bump puppet-boxen to got boxen::repo to handle the repo clone 2012-10-05 12:04:04 -10:00
modules people module doc update 2012-10-07 15:00:32 -10:00
script Add script/boxen-git-credential 2012-10-04 21:09:40 -07:00
shared Things managed by librarian-puppet go in shared/ 2012-10-03 10:24:21 -07:00
vendor update puppet-boxen for projects::all action 💥 2012-10-07 14:58:24 -10:00
.gitignore Bring back dat cache 2012-10-03 13:55:23 -07:00
.rbenv-version Initial commit 2012-10-02 11:43:59 -07:00
Gemfile Use the released 0.1.0 gem 2012-10-03 14:05:55 -07:00
Gemfile.lock bump boxen version for fixes 2012-10-07 13:45:54 -10:00
Puppetfile update puppet-boxen for projects::all action 💥 2012-10-07 14:58:24 -10:00
Puppetfile.lock update puppet-boxen for projects::all action 💥 2012-10-07 14:58:24 -10:00
README.md Add customization docs to README 2012-10-04 10:30:22 -07:00

Our Boxen

This is a template Boxen project designed for your organization to fork and modify appropriately.

Getting Started

  1. Fork this repository.
  2. Modify the Puppetfile and modules/ to your heart's content.
  3. Get a copy of your fork somewhere locally.
  4. Install the XCode Command Line Tools package. You need an Apple ID. We know. It sucks. You can thank Apple for not allowing the Command Line Tools to be redistributed publicly.
  5. cd to that dir and run script/boxen
  6. Rock out. 🤘

What You Get

This template project provides the following by default:

  • Homebrew
  • Git
  • Hub
  • DNSMasq w/ .dev resolver for localhost
  • NVM
  • RBenv
  • Full Disk Encryption requirement
  • NodeJS 0.4
  • NodeJS 0.6
  • NodeJS 0.8
  • Ruby 1.8.7
  • Ruby 1.9.2
  • Ruby 1.9.3
  • Ack
  • Findutils
  • GNU-Tar

Customizing

You can always check out the number of existing modules we already provide as optional installs under the boxen organization. These modules are all tested to be compatible with Boxen. You can include these modules by modifying the Puppetfile, adding them to manifests/site.pp if they should be installed on every machine, and then running boxen.

For your organization, it's recommended you create a module to contain the configuration in the modules/ directory (eg. modules/github). Then, you simply need to include that module in manifests/site.pp.

For organization projects (read: repositories that people will be working in), please see the documentation in the projects module template we provide.

For per-user configuration that doesn't need to be applied globally to everyone, please see the documentation in the people module template we provide.