Roles


Roles are specialized policies that may contain a subset of attributes, handlers, policies and modules. The top-level policy should specify the roles to activate:

roles{
    "packages",
    "cronjobs"
}

Roles are located under the roles/ subdirectory:

roles/
    packages/
        attributes/
        handlers/
        includes/
        modules/
        main.lua
    cronjobs/
        attributes/
        handlers/
        includes/
        modules/
        main.lua

Only the main policy main.lua is required to exist under the role but it's best practice to make use of the specified subdirectories for separation of concerns.

attributes/

This can contain variables and documentation for the role.

handlers/

Handlers specific to the role.

includes/

The main policy can get too long so it's advisable to use the includes/ directory for additional policy extension.

modules/

Lua/Configi module(s) specific to the role.