34 lines
1.4 KiB
Markdown
34 lines
1.4 KiB
Markdown
|
||
# MacOS Setup with Ansible
|
||
|
||
This repository contains an Ansible configuration for setting up a Mac from scratch. It's primary purpose is setting up a new Mac from scratch, but I endeavor to also use it for adding new software as I go so that it remains up to date. At the moment it's being used for setting up Intel based Macs running MacOS Big Sur.
|
||
|
||
## Getting Started
|
||
|
||
There's a simple shell script in `bin/bootstrap` which will perform the initial steps of:
|
||
|
||
1. Installing Xcode
|
||
2. Installing Ansible
|
||
3. Fetching required Ansible roles and collections
|
||
|
||
And then runs the main playbook `ansible_osx.yml`.
|
||
|
||
For future updates, `bin/apply` can be used to run just the Ansible playbook without the setup commands.
|
||
|
||
## What's installed
|
||
|
||
The easiest way to understand what's installed is to read the contents of `ansible_osx.yml`, this configuration is fairly specific to the range of development I do personally, but may serve as a useful starting point for others. The core components are:
|
||
|
||
- ZSH + Oh My Zsh as the primary shell
|
||
- Homebrew for package management
|
||
- ASDF for version management (along with plugins and default versions for ruby, python, javascript, elixir and erlang)
|
||
- Virtualbox, Vagrant and Docker
|
||
- VSCode + default plugins and configuration
|
||
- A selection of Android SDK's
|
||
- Lots of other tools and utilities
|
||
|
||
## Customising
|
||
|
||
Everything can be customised by editing `ansible_osx.yml`.
|
||
|