README

This is my mac; there are many like it, but this one is mine.

1. Install XCode developer tools:

   xcode-select --install || echo "xcode-select has been installed already, probably."
   # then hit install on the GUI popup

2. Get bootstrapped:

   curl --location --fail --show-error --silent https://github.com/petemounce/workstation/archive/refs/heads/master.zip --output "workstation-master.zip"
   unzip -d "." "workstation-master.zip"
   cd workstation-master
   bash bin/bootstrap.sh
   [[ -d ".venv" ]] && source ".venv/bin/activate"
   bash bin/run.sh --list-tasks

3. To avoid needing to use --ask-become-pass and typing your user's password on every run-through:

   https://jpmens.net/2021/12/17/ansible-vault-password-in-macos-keychain/

   1. Make an ansible vault password inside macOS keychain to avoid needing to type your account password every run-through:

      security add-generic-password -a "${USER}" -j "ansible-vault password for workstation repo" -s "workstation" -w

      ... and supply a password then confirm it.

   2. Make an ansible-vault encrypted file with your user account's password in it, like:

      ansible-vault create "secrets.yml"

      ... with content:

      ansible_become_password: 'your password'
      brew_password: 'brew user's password' # Choose something easy to type...
      github_token:
        personal: ''
        work: ''

4. Download an XCode xip (because download.developer.apple.com requires authentication):

   1. Set vars/Darwin.yml xcode_version if needed.

   2. Browse to https://developer.apple.com/download/all/?q=xcode

   3. Sign in with an Apple ID.

   4. Download the version you want.

   5. Move it to where ansible will look for it:

      mkdir -p "${HOME}/.cache/xcode-installers"
      mv "${HOME}/Download/Xcode_{xcode_version}.xip" "${HOME}/.cache/xcode-installers/Xcode_{xcode_version}.xip"

5. If you're happy with that set of tasks and have read what they do:

   bin/run.sh

   You can pass flags and arguments to bin/run.sh and ansible-playbook will receive them.