agarthetiger / ansible-mac-setup

A portable automated configuration script using Ansible for managing my mac packages, tools, bash defaults etc.

ansible-mac-setup

Ansible automation for managing my macOS configuration. This is now used across both MacBook and Mac Mini.

Additional notes here for tools and config which I've not automated.

Shout out to Jeff Geerling for making his Mac Collection for Ansible open source and his mac-dev-playbook from which I've borrowed here.

Running

# Run once
ansible-galaxy install -r requirements.yaml

# Run everything, become password is required for p10k role
ansible-playbook configure-mac.yaml --tags roles -K

# Just install pipx packages
ansible-playbook configure-mac.yaml --tags pipx

# Upgrade all brew forumla
ansible-playbook configure-mac.yaml --tags homebrew_formula_update -e update_all_packages=yes

# Uninstall all packages listed for removal
ansible-playbook configure-mac.yaml --tags remove

# Uninstall just ruby gems
ansible-playbook configure-mac.yaml --tags ruby_gems_remove

Dependencies

Gist to be created for bootstrapping script. Ansible needs python to run, python3 needs X-Code developer tools which are not installed on a fresh MacOS install.

The basic steps are as follows Install xcode developer tools (required for pip/pipx/homebrew) Download and install

• Homebrew
• pipx (via homebrew)
• ansible (via pipx)
• VS Code (not strictly necessary as this can be installed by Ansible assuming this playbook needs no edits beforehand)
• Add config into ~/.zshrc for pipx and completions

To Do

List of things to improve here include

• Configure default font for iterm2 (via profile?)
• VS Code preferences (not necessarily to be configured by Ansible...) including Editor:Font Family to be MesloLGS NF, ...
• Configure p10k preferences to match current macbook settings
• Review and apply .macos settings
• dotFile management
• kubectl
• Install fonts for lsd, p10k
• Karabiner config?
• Install homebrew and pipx and ansible from a gist or other bootstrapping automation prior to running Ansible
• Testing!

Troubleshooting

If things don't go well, add or uncomment the debugging lines. See the Ansible Debugging docs for the available commands once you hit a debug breakpoint.

Non-managed software

• PyCharm

Dependencies

There are dependencies between configuration in here and in my dotfiles. It's not going to be simple or pratcial IMO to decouple them. For example, the diodonfrost.p10k role installs the MesloLGS NF font which is also set as the default font in my iterm2 profile (Default.json). Also, I configure a bunch of tools in my dotfiles, specifically in .zshrc, which are dependent on other packages being installed. My dotfiles are in a separate repo but the package installs are here. I currently have no requirement which warrants the time and effort to unpick and test these as separately managed components.

iterm2 profiles

See https://iterm2.com/documentation-dynamic-profiles.html I should diff the file I've just added with an export from another Mac to see if the GUIDs match and what the differences are. I should probably strip this file down to just the elements which I've changed vs the Default profile, which is the font and maybe the ASCII blue colour.

Dumping the file into ~/Library/Application Support/iterm2/Dynamic Profiles is the easy option. Automating iTerm2 with it's python api would be the first-class solution if I can justify the time to do it. See https://iterm2.com/python-api/profile.html

Karabiner elements configuration

See https://karabiner-elements.pqrs.org/docs/manual/operation/export/

vi(m) configuration

To do. See https://github.com/vim-airline/vim-airline or https://github.com/powerline/powerline , either of which would be awesome. I'm not big on doing much with vim, especially on MacOS but this would be useful on a Raspberry Pi with the Lite OS, like my Pi Zeros.

Fonts

I might need (or like) more fonts, see here for many powerline fonts. https://github.com/powerline/fonts