Ansible playbooks and roles for bootstrapping macOS and Linux workstations, and managing dotfiles. The playbooks are designed with no assumed prior knowledge of the system, and are meant to be run on a newly installed system.
Because these playbooks are meant to be run locally instead of over SSH, the inventory is dynamic, such that the current host is assigned to groups based on Linux distro, or simply Darwin for macOS.
- On macOS, authenticate to the App Store (required if using
mas) - Clone the repository locally
cdinto the git repo and runsh install
Tip
Run sh install -h to show available script flags
-
Bootstrap the OS: the
installscript installs necessary packages to setup and run Ansible; this includes e.g. Homebrew, Python, and Git. This script requiressudoaccess on Linux only. -
Bootstrap Ansible: this playbook installs the necessary Ansible collections, and creates a host YAML file that is pre-filled with global variables (used as default values in roles).
-
Initialize 1Password: the user is prompted for 1Password credentials, Ansible authenticates with the option of using the GUI or just the CLI version. A new entry is created for the host machine under the category
SERVER. -
System bootstrap: runs the
play_all_rolesplaybook which includes all roles and tasks, specificallyall,neverto target tasks where idompotence isn't desireable (e.g. completely resetting a dock).
Note
Upon completion, a full reboot is recommended for a clean shell.
Run the playbook play_dots. Tasks that fall under dotfile management are tagged with dots. Add the tag moredots to include additional tasks that are complimentary to dotfile management.
Tip
A Makefile is provided to use frequently used playbook settings; e.g. make dots