Mac Maker Profiles¶

Profiles are essentially a standardized Ansible Playbook, with explicitly defined dependencies, and some extra metadata.

The directory structure is defined as follows:

root
│
└── profile
    │
    ├── __precheck__
    │   │
    │   ├── env.yml
    │   └── notes.txt
    │
    ├── requirements.yml
    └── install.yml

Precheck Metadata¶

This information exists to give the end user of a profile a way of validating they have set any required environment variables, and provides a way for them to review any release notes.

The notes.txt file contains free form release notes about the profile.
The env.yml file defines all required environment files consumed by the profile.

Environment Precheck File (env.yml) Specification

Galaxy Requirements¶

The requirements.yml file is the Ansible Galaxy dependencies definition file. Any external roles or collections the profile requires should be defined here. Mac Maker will download and install these dependencies prior to applying your profile.

requirements.yml File Specification

install.yml Playbook¶

The install.yml playbook is the Ansible entrypoint into the profile. This playbook is called when Mac Maker applies the profile.

All roles and tasks should be defined in this file, and should be accessed from relative paths to this file.

Organizing Your Profile¶

Frequently it makes sense to create sub-folders under profile to nest your tasks, vars and handlers files for easier to manage Mac Maker profiles.

This is all derived from the folder structure used by Ansible Roles, and it’s recommended to use this type of structure as a guide.

The following example profile may be helpful to review:

Generic Profile Example

It’s also recommended to look at some Ansible Roles to see how they are structured: