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, in order to install apps via mas, log in to the App Store prior to running. Then download and run the install script:
```shell
curl -sO https://dotfiles.franklybrad.com/install
sh install
```
Tip
Upon completion, a full reboot is recommended for a clean shell.
Tip
Check the install script for environment variables that can be set prior to running.
e.g. ANSIBLE_REPO_BRANCH=develop sh install
Important
Do not pipe curl into sh as Ansible won't run in interactive mode and will skip setup prompts.
-
Bootstrap the OS: the
installscript installs the necessary packages to check out the repository and run Ansible; this includes Homebrew (excluding ARM systems), 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).
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.