• This repository has been archived on 22/May/2018
  • Stars
    star
    2,595
  • Rank 17,663 (Top 0.4 %)
  • Language
    Ruby
  • License
    MIT License
  • Created about 12 years ago
  • Updated over 6 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Copy me for your team.

Our Boxen

This is a template Boxen project designed for your organization to fork and modify appropriately. The Boxen rubygem and the Boxen puppet modules are only a framework for getting things done. This repository template is just a basic example of how to do things with them.

Getting Started

To give you a brief overview, we're going to:

  • Install dependencies (basically Xcode)
  • Bootstrap a boxen for your self/team/org/company
  • Then convert your local copy of that boxen to the post-bootstrapped version

There are a few potential conflicts to keep in mind. Boxen does its best not to get in the way of a dirty system, but you should check into the following before attempting to install your boxen on any machine (we do some checks before every Boxen run to try and detect most of these and tell you anyway):

  • Boxen requires at least the Xcode Command Line Tools installed.
  • Boxen will not work with an existing rvm install.
  • Boxen may not play nice with a GitHub username that includes dash(-)
  • Boxen may not play nice with an existing rbenv install.
  • Boxen may not play nice with an existing chruby install.
  • Boxen may not play nice with an existing homebrew install.
  • Boxen may not play nice with an existing nvm install.
  • Boxen recommends installing the full Xcode.

Dependencies

Install the Xcode Command Line Tools and/or full Xcode. This will grant you the most predictable behavior in building apps like MacVim.

How do you do it?

OS X 10.9 (Mavericks)

If you are using b26abd0 of boxen-web or newer, it will be automatically installed as part of Boxen. Otherwise, follow instructions below.

OS X < 10.9

  1. Install Xcode from the Mac App Store.
  2. Open Xcode.
  3. Open the Preferences window (Cmd-,).
  4. Go to the Downloads tab.
  5. Install the Command Line Tools.

Bootstrapping

Create a new git repository somewhere on the internet. It can be private or public -- it really doesn't matter. If you're making a repository on GitHub, you may not want to fork this repo to get started. The reason for that is that you can't really make private forks of public repositories easily.

Once you've done that, you can run the following to bootstrap your boxen:

sudo mkdir -p /opt/boxen
sudo chown ${USER}:staff /opt/boxen
git clone https://github.com/boxen/our-boxen /opt/boxen/repo
cd /opt/boxen/repo
git remote rm origin
git remote add origin <the location of my new git repository>
git push -u origin master

Now that your boxen is bootstrapped, you can run the following to install the default configuration from this repo:

cd /opt/boxen/repo
./script/boxen

Distributing

That's enough to get your boxen into a usable state on other machines, usually. From there, we recommend setting up boxen-web as an easy way to automate letting other folks install your boxen.

If you don't want to use boxen-web, folks can get using your boxen like so:

sudo mkdir -p /opt/boxen
sudo chown ${USER}:staff /opt/boxen
git clone <location of my new git repository> /opt/boxen/repo
cd /opt/boxen/repo
./script/boxen

Keep in mind this requires you to encrypt your hard drive by default. If you do not want to do encrypt your hard drive, you can use the --no-fde.

./script/boxen --no-fde

It should run successfully, and should tell you to source a shell script in your environment. For users without a bash or zsh config or a ~/.profile file, Boxen will create a shim for you that will work correctly. If you do have a ~/.bashrc or ~/.zshrc, your shell will not use ~/.profile so you'll need to add a line like so at the end of your config:

[ -f /opt/boxen/env.sh ] && source /opt/boxen/env.sh

Once your shell is ready, open a new tab/window in your Terminal and you should be able to successfully run boxen --env. If that runs cleanly, you're in good shape.

What You Get

This template project provides the following by default:

  • Homebrew
  • Homebrew-Cask
  • Git
  • Hub
  • dnsmasq w/ .dev resolver for localhost
  • rbenv
  • Full Disk Encryption requirement
  • Node.js 0.8
  • Node.js 0.10
  • Node.js 0.12
  • Ruby 1.9.3
  • Ruby 2.0.0
  • Ruby 2.1.8
  • Ruby 2.2.4
  • 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. Use the Puppetfile to pull them in dependencies automatically whenever boxen is run.

Including boxen modules from github (boxen/puppet-)

You must add the github information for your added Puppet module into your Puppetfile at the root of your boxen repo (ex. /path/to/your-boxen/Puppetfile):

# Core modules for a basic development environment. You can replace
# some/most of these if you want, but it's not recommended.

github "repository", "2.0.2"
github "dnsmasq",    "1.0.0"
github "gcc",        "1.0.0"
github "git",        "1.2.2"
github "homebrew",   "1.1.2"
github "hub",        "1.0.0"
github "inifile",    "0.9.0", :repo => "cprice404/puppetlabs-inifile"
github "nginx",      "1.4.0"
github "nodejs",     "2.2.0"
github "ruby",       "4.1.0"
github "stdlib",     "4.0.2", :repo => "puppetlabs/puppetlabs-stdlib"
github "sudo",       "1.0.0"

# Optional/custom modules. There are tons available at
# https://github.com/boxen.

github "java",     "1.6.0"

In the above snippet of a customized Puppetfile, the bottom line includes the Java module from Github using the tag "1.6.0" from the github repository "boxen/puppet-java/releases". The function "github" is defined at the top of the Puppetfile and takes the name of the module, the version, and optional repo location:

def github(name, version, options = nil)
  options ||= {}
  options[:repo] ||= "boxen/puppet-#{name}"
  mod name, version, :github_tarball => options[:repo]
end

Now Puppet knows where to download the module from when you include it in your site.pp or mypersonal.pp file:

# include the java module referenced in my Puppetfile with the line
# github "java",     "1.6.0"
include java

Hiera

Hiera is preferred mechanism to make changes to module defaults (e.g. default global ruby version, service ports, etc). This repository supplies a starting point for your Hiera configuration at config/hiera.yml, and an example data file at hiera/common.yaml. See those files for more details.

The default config/hiera.yml is configured with a hierarchy that allows individuals to have their own hiera data file in hiera/users/{github_login}.yaml which augments and overrides site-wide values in hiera/common.yaml. This default is, as with most of the configuration in the example repo, a great starting point for many organisations, but is totally up to you. You might want to, for example, have a set of values that can't be overridden by adding a file to the top of the hierarchy, or to have values set on specific OS versions:

# ...
:hierarchy:
  - "global-overrides.yaml"
  - "users/%{::github_login}"
  - "osx-%{::macosx_productversion_major}"
  - common

Node definitions

Puppet has the concept of a 'node', which is essentially the machine on which Puppet is running. Puppet looks for node definitions in the manifests/site.pp file in the Boxen repo. You'll see a default node declaration that looks like the following:

node default {
  # core modules, needed for most things
  include dnsmasq

  # more...
}

How Boxen interacts with Puppet

Boxen runs everything declared in manifests/site.pp by default. But just like any other source code, throwing all your work into one massive file is going to be difficult to work with. Instead, we recommend you use modules in the Puppetfile when you can and make new modules in the modules/ directory when you can't. Then add include $modulename for each new module in manifests/site.pp to include them. One pattern that's very common is to create a module for your organization (e.g., modules/github) and put an environment class in that module to include all of the modules your organization wants to install for everyone by default. An example of this might look like so:

# modules/github/manifests/environment.pp

 class github::environment {
   include github::apps::mac

   include ruby::1-8-7

   include projects::super-top-secret-project
 }

If you'd like to read more about how Puppet works, we recommend checking out the official documentation for:

Creating a personal module

See the documentation in the modules/people directory for creating per-user modules that don't need to be applied globally to everyone.

Creating a project module

See the documentation in the modules/projects directory for creating organization projects (i.e., repositories that people will be working in).

Binary packages

We support binary packaging for everything in Homebrew, rbenv, and nvm. See config/boxen.rb for the environment variables to define.

Sharing Boxen Modules

If you've got a Boxen module you'd like to be grouped under the Boxen org, (so it can easily be found by others), please file an issue on this repository with a link to your module. We'll review the code briefly, and if things look pretty all right, we'll fork it under the Boxen org and give you read+write access to our fork. You'll still be the maintainer, you'll still own the issues and PRs. It'll just be listed under the boxen org so folks can find it more easily.

upgrading boxen

See FAQ-Upgrading.

Integrating with Github Enterprise

If you're using a Github Enterprise instance rather than github.com, you will need to set the BOXEN_GITHUB_ENTERPRISE_URL and BOXEN_REPO_URL_TEMPLATE variables in your Boxen config.

Halp!

See FAQ.

Use Issues or #boxen on irc.freenode.net.

More Repositories

1

boxen

Manage Mac development boxes with love (and Puppet).
Ruby
1,580
star
2

boxen-web

Automate your team's Boxen installations.
Ruby
210
star
3

puppet-osx

Generic OS X stuffs for boxen
Ruby
108
star
4

puppet-template

An example Puppet module for Boxen.
Ruby
84
star
5

puppet-boxen

Boxen's fundamental modules and types.
Ruby
76
star
6

puppet-brewcask

A homebrew-cask provider for Puppet's package type
Ruby
38
star
7

puppet-ruby

Installs Ruby versions with Boxen
Ruby
38
star
8

puppet-homebrew

Install Homebrew.
Ruby
24
star
9

cardboard

Development tools for Boxen's Puppet repositories.
Ruby
16
star
10

phantomenv

PhantomJS version manager, heavily inspired by rbenv
Shell
16
star
11

boxen.github.com

Deprecated.
HTML
16
star
12

puppet-nodejs

Ruby
15
star
13

puppet-iterm2

Puppet
13
star
14

puppet-java

Install Java
Ruby
13
star
15

puppet-dropbox

Install Dropbox.
11
star
16

puppet-python

Ruby
11
star
17

puppet-chrome

Install Google Chrome.
10
star
18

puppet-postgresql

Install Postgresql
Ruby
10
star
19

puppet-mongodb

Ruby
9
star
20

puppet-virtualbox

Ruby
9
star
21

puppet-dnsmasq

Install the dnsmasq DNS forwarder.
Ruby
9
star
22

puppet-git

Install Git.
Ruby
9
star
23

puppet-mysql

Ruby
9
star
24

puppet-redis

Ruby
8
star
25

puppet-alfred

Install the Alfred productivity app.
8
star
26

puppet-hub

Install hub.
Ruby
6
star
27

puppet-bash

Ruby
6
star
28

puppet-caffeine

Install the Caffeine Mac OS X app.
6
star
29

puppet-elasticsearch

Install elasticsearch.
Puppet
6
star
30

puppet-nginx

CSS
6
star
31

puppet-firefox

5
star
32

puppet-zsh

Ruby
5
star
33

puppet-packer

Puppet module for installing Packer, for Boxen.
Ruby
5
star
34

puppet-sublime_text_2

Ruby
5
star
35

puppet-repository

Repository management for Boxen
Ruby
5
star
36

puppet-slate

4
star
37

puppet-heroku

Install Heroku plugins.
Ruby
4
star
38

puppet-imagemagick

4
star
39

puppet-emacs

Install GNU Emacs
4
star
40

puppet-phantomjs

Install PhantomJS
Ruby
4
star
41

puppet-cassandra

Shell
4
star
42

puppet-seil

Boxen puppet module to install seil
Ruby
4
star
43

puppet-xquartz

Ruby
3
star
44

puppet-rdio

3
star
45

puppet-go

Puppet
3
star
46

puppet-textmate

3
star
47

puppet-googledrive

A Boxen puppet module to install Google Drive Sync
3
star
48

puppet-tower

Boxen module to setup Tower Git
3
star
49

puppet-nvm

Shell
3
star
50

puppet-sysctl

Ruby
3
star
51

puppet-mou

Puppet Boxen module for Mou
Ruby
3
star
52

puppet-sublime_text

New home for boxen/puppet-sublime_text_2 with versions as config options
Ruby
3
star
53

puppet-wget

Puppet module for installing wget, for Boxen
3
star
54

puppet-gitx

Install GitX.
3
star
55

puppet-onepassword

2
star
56

puppet-osxfuse

Ruby
2
star
57

puppet-augeas

Install the augeas configuration editor.
Ruby
2
star
58

puppet-erlang

Install Erlang.
Ruby
2
star
59

puppet-arq

Install the Arq backup app.
2
star
60

puppet-macvim

MacVim is the text editor Vim for Mac OS X
2
star
61

puppet-memcached

Ruby
2
star
62

puppet-cyberduck

2
star
63

puppet-gh

Ruby
2
star
64

puppet-fig

Puppet module for installing Fig, for Boxen
Ruby
2
star
65

puppet-inifile

Ruby
2
star
66

puppet-asciiio

2
star
67

puppet-fitbit

2
star
68

puppet-minecraft

1
star
69

puppet-hipchat

1
star
70

puppet-tor

TorBrowser Module for Boxen
1
star
71

puppet-ghostscript

Install Ghostscript.
1
star
72

puppet-wkhtmltopdf

Ruby
1
star
73

puppet-fonts

Boxen Module for installing Fonts
Puppet
1
star
74

puppet-rubymine

1
star
75

puppet-nmap

boxen nmap module
1
star
76

puppet-geoip

Install GeoIP.
1
star
77

puppet-transmission

1
star
78

puppet-fluid

1
star
79

puppet-dashlane

1
star
80

puppet-graphviz

Install GraphViz.
1
star
81

puppet-gyp

GYP module for Boxen
1
star
82

puppet-zeromq

1
star
83

puppet-qt

Ruby
1
star
84

puppet-gpgme

Install GPGme.
1
star
85

puppet-undercover

1
star
86

puppet-divvy

Install Divvy, a window resizer.
1
star
87

puppet-sparrow

1
star
88

puppet-istatmenus4

iStat Menus v4
1
star
89

puppet-pycharm

1
star
90

puppet-solr

Install Solr
1
star
91

puppet-skitch

Install Skitch 1.0
1
star
92

puppet-shiftit

1
star
93

puppet-clojure

Install the Clojure programming language.
1
star
94

puppet-vmware_fusion

Ruby
1
star
95

puppet-sudo

Ruby
1
star
96

puppet-autoconf

Install the autoconf development framework.
1
star
97

puppet-league_of_legends

Puppet Boxen module for League of Legends
1
star
98

puppet-zshgitprompt

ZSH Git Prompt, for great justice
1
star
99

puppet-colloquy

Install the Colloquy IRC client.
1
star