Installs Homebrew on macOS, and configures packages, taps, and cask apps according to supplied variables.
None.
Available variables are listed below, along with default values (see defaults/main.yml
):
homebrew_repo: https://github.com/Homebrew/brew
The GitHub repository for Homebrew core.
homebrew_prefix: /usr/local
homebrew_install_path: "{{ homebrew_prefix }}/Homebrew"
The path where Homebrew will be installed (homebrew_prefix
is the parent directory). It is recommended you stick to the default, otherwise Homebrew might have some weird issues. If you change this variable, you should also manually create a symlink back to /usr/local so things work as Homebrew expects.
homebrew_brew_bin_path: /usr/local/bin
The path where brew
will be installed.
homebrew_installed_packages:
- ssh-copy-id
- pv
Packages you would like to make sure are installed via brew install
.
homebrew_upgrade_all_packages: no
Whether to upgrade homebrew and all packages installed by homebrew. If you prefer to manually update packages via brew
commands, leave this set to no
.
homebrew_taps:
- caskroom/cask
Taps you would like to make sure Homebrew has tapped.
homebrew_cask_apps:
- firefox
Apps you would like to have installed via cask
. Search for popular apps on http://caskroom.io/ to see if they're available for install via Cask. Cask will not be used if it is not included in the list of taps in the homebrew_taps
variable.
homebrew_cask_appdir: /Applications
Directory where applications installed via cask
should be installed.
homebrew_use_brewfile: true
Whether to install via a Brewfile. If so, you will need to install the homebrew/bundle
tap, which could be done within homebrew_taps
.
homebrew_brewfile_dir: '~'
The directory where your Brewfile is located.
None.
- hosts: localhost
vars:
homebrew_installed_packages:
- mysql
roles:
- v0rts.homebrew
See the tests/local-testing
directory for an example of running this role over Ansible's local
connection. See also: Mac Development Ansible Playbook.
MIT / BSD
This role managed and maintained by Chad Sailer This role was originally created in 2014 by Jeff Geerling