Developer/Designer Macbook Setup

This is an Ansible process to provision a developer or designer's Macbook.

This is based on geerlingguy's example of this, but tweaked heavily for the Star Tribune.

Installation

1. Ensure Apple's command line tools are installed (xcode-select --install to launch the installer).
2. Install Ansible.
3. Clone this repository to your local drive.
4. Run ansible-playbook main.yml -i inventory -K inside this directory. Enter your account password when prompted.

Note: If some Homebrew commands fail, you might need to agree to Xcode's license or fix some other Brew issue. Run brew doctor to see if this is the case.

Another Note: If it complains about something being in ~/Applications that it expects to install/manage itself, remove that file, and then re-run this. In most cases, your settings will remain intact, as long as they were stored somewhere other than the application binary.

Running a specific set of tagged tasks

You can filter which part of the provisioning process to run by specifying a set of tags using ansible-playbook's --tags flag.

ansible-playbook main.yml -i inventory -K --tags "docker,zsh-setup"

Overriding Defaults

Not everyone's development environment and preferred software configuration is the same.

You can override any of the defaults configured in default.config.yml by creating a config.yml file and setting the overrides in that file. For example, you can customize the installed packages and apps with something like:

enable_zsh: True
shell_config_file: ".zshrc"

homebrew_additional_packages:
  - cowsay

composer_packages:
  - name: laravel/installer
  - name: drush/drush
    version: '^8.1'

gem_packages:
  - name: bundler
    state: latest

npm_packages:
  - name: webpack

pip_packages:
  - name: mkdocs

Any variable can be overridden in config.yml.

Things that still need to be done manually

You'll need to install Xcode and Ansible yourself.