Introduction

This role is a set of independent groups of tasks(tasks-group), imported from separate files, that configure a particular functionality of the system (cron, hostname, sshd, …).

Ansible role: vbotka.freebsd_postinstall
Supported systems: FreeBSD
Required collections:

Collection vbotka.freebsd

This role is included in the collection vbotka.freebsd. See the examples. For example,

Control flow

A few variables control the role execution flow. All of them are Boolean, disabled by default.

fp_<tasks-group>

Import tasks-group. The imports of all tasks-groups are disabled by default. See the control variables of the form fp_<tasks-group> in main.yml.

fp_<tasks-group>_install

Install packages. The control variables fp_<tasks-group>_install enable the installation of the predefined groups of packages. See the Installation frameworks and the files defaults/main/pkgdict_*.yml.

fp_<tasks-group>_enable

Enable service. The control variables fp_<tasks-group>_enable enable or disable particular services. In most cases, the name of the service is used as <tasks-group>. All variables fp_<tasks-group>_enable are disabled by default. See System configuration.

fp_<tasks-group>_debug

Display debug. Some tasks-groups provide the debug output which can be turned on by enabling fp_<tasks-group>_debug. All variables fp_<tasks-group>_debug are disabled by default. See the section Debug.

Tags

Limit the tasks-groups execution by selecting or rejecting(skipping) tags. See Tags.

Recommendations

Some tasks are described in detail in the section Tasks. If the description of a task is missing, it’s necessary to review the source code to see how to use it. To learn details, it’s always recommended to review the code and notes in the section Annotated source code. See the section Best practice to see how to check syntax, preview potential changes, and debug tasks.

Hint

See vars/samples