purpose

I hate it when I need to setup a computer from scratch, but from time to time I need to do it. To simplify the process AND to share a similar local environment with all colleagues and friends (which makes communication and collaboration far easier), I created this simple ansible playbook.

It is not meant to be used for linux or windows environments and not meant to support setting up a remote host. It's just a tiny helper to automate installing all the tools and software you expect on your local machine.

Much simpler than https://github.com/geerlingguy/mac-dev-playbook, but obviously not as sophisticated.

features

• system configuration (sudo defaults write XXX) - hostname,
• user configuration (defaults write XXX) - dock behaviour, hot corners, finder defaults, ...
• setup the environment (.profile/.zshrc/aliases/...)
• install brew / pip3 packages
• download and install individual apps (zip or dmg)
• optionally use a URL to download the localhost.yml configuration

usage

install it

• open a terminal
• clone the repository git clone https://github.com/DrPsychick/macdev.git
• run ./install.sh interactively in the shell (requires entering password and/or installing XCode)

cd git # or wherever you keep stuff like this
git clone https://github.com/DrPsychick/macdev.git
cd macdev
./install.sh

configure it

• use host_vars/localhost-example.yml as a base and en-/disable roles, add/remove packages to install via pip or homebrew ...
• save it as host_vars/localhost.yml to enable it
• OR (see below): provide a URL to download your config from: -e config_url=http://raw.githubusercontent.com/DrPsychick/macdev/master/host_vars/localhost-example.yml

cp host_vars/localhost-example.yml host_vars/localhost.yml
open -e host_vars/localhost.yml
# replace "YOUR_MACDEV_DIRECTORY" with the directory where the cloned repository resides

run it

ansible-playbook macdev.yml
# OR with config URL (must re-run after download)
ansible-playbook macdev.yml -e config_url=http://raw.githubusercontent.com/DrPsychick/macdev/master/host_vars/localhost-example.yml

maintain it

You want to install a new package? Edit your host_vars/localhost.yml, then simply run your alias updatemac (see host_vars/localhost-example.yml) or the above command.

troubleshooting

• if you get this (after updating brew): /usr/local/bin/ansible-playbook: bad interpreter: /usr/local/opt/python/bin/python3.7: no such file or directory
  • then run pip3 install -U ansible and try again
• brew upgrade fails:
  • if brew upgrade sometimes requires user interaction or fails, simply run it manually once: brew upgrade

references

setup ENV for mac and ansible:

see https://gist.github.com/DrPsychick/847ea32c876fda2337e79096a8a23176

inspired by

• https://github.com/roberth1988/osx-bootstrap