Role Name

This Ansible role sets up the dock on a Mac OSX computer. It creates dock icons for the apps and folders that the user chooses.

Requirements

This role uses dockutil to manage the dock and will install it using homebrew. So make sure homebrew is installed before running this role.

########### Install Homebrew ############
if ! command -v brew >/dev/null; then
  echo Installing Homebrew...
  # suppress the need to press 'return' during the installation.
  yes '' | ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
else
  echo Homebrew is already installed...
fi

Role Variables

dockapps_apps: This is a list of apps that will be added to the dock. Each app must have its path specified like this:

dockapps_apps:
    - < path to app package for the dock >

For example:

dockapps_apps:
    - "/Applications/Google Chrome.app"

dockapps_apps_spacing: This is a list of app names that should have a space after them. Each item is defined like this:

dockapps_apps_spacing:
    - < name of app that should have a space after it >

For example:

dockapps_apps_spacing:
    - "Google Chrome"

dockapps_folders: This is a list of folders, along with their preferred view mode, to put on the dock. For example:

dockapps_folders:
    - { path: "~/Downloads",  view: fan   }
    - { path: "~/Documents",  view: grid  }

Dependencies

This role does not have any other dependencies from Ansible Galaxy.

Example Playbook

---
- hosts: localhost
  remote_user: root
  roles:
    - sicruse.dockapps

License

MIT

Author Information

If you have any questions or feedback, feel free to reach out to me via [email](mailto:si@sicruse.com?subject=dockapps Feedback).