Opinionated scripts to bootstrap my new Mac workstations when I get them. This doesn't happen all too often, but in between home, work, desktops, laptops, catastrophic hardware failures, etc., it happens more often than I'd like!
After years of messing with various solutions for this problem, I've tried a lot of different solutions and evaluated a bunch of different approaches.
As a result of these forays, there are a few things bootslap is opinionated about:
-
Stand on the shoulders of giants. Homebrew is the best way to manage CLI tools on OSX. Homebrew Cask is the best way to manage binary applications on OSX. Make sure these providers are used for automatic installations as well, so that we can take advantage of their expansive and well maintained libraries.
-
Install as much as possible via default tools in default locations. Doing things in a nonstandard way or putting files in a nonstandard location means you might hit state bugs the general populace won't. This also means you aren't tied to bootslap in the future -- you can use it once to set stuff up and then throw it away later.
-
Do everything in an idempotent way. Tasks should be runnable at any time, creating/repairing installations when needed, ignoring stuff if already exists. You should be able to run the bootstrap script on a fully up-to-date workstation after making a single change, only only that one change will be applied to the machine, and it will happen fast.
-
Favor simplicity over modularity. Goal is for the entire codebase to be understandable and modifiable directly by anyone seeking to repurpose this, instead of them relying on me building in configuration options for whatever they might want to do.
-
Use the same tools for automatic and interactive modes. Want to remove something later? Don't need to mess with finding an uninstall script (assuming one even exists) or going searching all over the hard disk to figure out where your clever bootstrapper script put stuff. Just
brew uninstall foo
and it's gone.
For an absolute pristine new Mac, it should be possible to just clone the repo
and then run bootslap.sh
. This will install XCode Command Line Dev Tools,
Homebrew, Ansible, and then run all the playbooks. You can even do it without
cloning the repo first (useful since MacOSX still doesn't have git by default):
curl -sL http://git.io/bootslap > /tmp/bootslap; bash /tmp/bootslap
Be sure to stick around for first minute or two so you can give Ansible your sudo password when it starts running playbooks.
Don't like running bash scripts piped off the interwebs? Or maybe you hate ASCII art and emoji? Either way, you can bootstrap the initial steps by hand as well too.
- Install Homebrew:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- Install Ansible via Homebrew:
brew install ansible
- Clone this repo, run the playbooks you want and go make yourself a coffee.
ansible-playbook -K install.yml shell.yml configure.yml
Well, in my particular scripts, this is what I have shoved onto the SSD:
- Sets my default shell to zsh with a bunch of extras.
- Installs and configures a bunch of programming development environments.
- Installs some common libraries you probably want to have around.
- Installs a bunch of common applications for dev types:
- Chrome, Firefox, MacVim, TextMate, SublimeText, Atom, Dropbox, GitHub for Mac, VirtualBox/Vagrant, f.lux, SizeUp...
- ...and bunch of common GUI applications:
- web browsers, text editors, media players, etc.
- Other handy CLI stuff:
- git, ack, ssh-copy-id, etc...
- Configure MacOSX to be less annoying:
- configure dock, disable network .DS_Store, etc.)
Note, I don't keep the above description up to date, so it's probably not accurate for my individual installer. But that shouldn't matter, since the actual files are easy to read and modify. As a starting point, look at:
install.yml
for everything that I "install" to the machineshell.yml
for my shell setup and modificationsconfigure.yml
for macOS system configuration twiddling
Note that this repo is only half the story, some of magic happens in my dotfiles as well. (Which these scripts automatically install for me).
But that's just what mine does! While I've certainly spent an inordinate amount of time obsessing about tooling and coming up with what I think they best tools and configuration for the job are, you probably have a different opinion. These scripts are designed and written in a way to hopefully be a good starting point to write your own version, that sets up things the way you like them. Check out the nascent Customization Guide for pointers.
Plays can be run individually if needed.
For example, to just do software installation (in case you don't have a dotfile
repo), you can do run the install.yml
playbook. Individual tasks are also
tagged within the playbook so you can even do a
ansible-playbook install.yml --tags ruby
for example.
User dotfiles are managed via homeshick.
By default we look for $USERNAME/dotfiles
on GitHub when getting things setup,
and we infer your GitHub username from your system environment. You can manually
override this in the shell.yml
playbook is desired.
I've investigated many possible approaches to this over time. A rough chronology for historical purposes:
- version5: Current ansible script solution. Rename to bootslap.
- version4 A year of working with the Boxen project instead.
- version3: Moved to using chef recipes for software installation,
backporting recipes into the
pivotal_workstation
project. - version2: Fancy Rakefiles version.
- version1: Mostly just shell scripts (lost to time)
In other words, alternatives.
After a year of struggling with Boxen for year (and contributing to the project) I've decided to abandon it. Some of the "highlights":
- Relies upon custom versions of common packages (e.g. git) that lag behind official point releases.
- Needs to own way too much of the system configuration. Uses it's own git
credential helper, for example, and overrides your
.gitconfig
to enable it. - Way too much enabled by default. Much of it to support the GitHub way of doing project development (dnsmasq and nginx for project switching). I stripped most of it out, but it was quite a lot of effort to do so.
- PITA to maintain updates. Require constant management of versions in Puppetfile.
- Custom configurations for many tools. This results in difficulty troubleshooting due to a nonstandard configuration. Also it breaks lots of stuff, for example, Homebrew can't use precompiled bottles due to nonstandard paths.
- Complex codebase. Sure, it's mostly puppet recipes, but the way everything is strung together makes it complex to understand whats happening when something goes wrong.
That said, some of the stuff Boxen does is very cool for large organizations (automatic GitHub Issue filing on install errors, for example). If you have a fulltime sysadmin to manage your configuration and deployments it's probably worth looking into.
Pretty close to what I want, but utilizes its own playbooks for installing common software. I'd much rather just depend on homebrew and homebrew-cask.