Introduction

• Supported systems: FreeBSD Supported Production Releases

• Requirements:

  • ansible.posix

  • ansible.utils

  • community.crypto

  • community.general

The collection is shipped with:

Plugins:

• module iocage - iocage jail handling.

• module service - Control or list system services.

• module ucl - CRUD-like interface for managing UCL files.

• inventory iocage - iocage inventory source.

• inventory iocage2 - iocage inventory source (libzfs & iocage_lib).

• filter ast_to_nginx - Convert AST list to NGINX config.

• filter dict_to_ast - Convert YAML dictionary to AST list.

• filter from_ucl - Parse UCL string into a YAML dictionary.

• filter iocage - Parse iocage lists.

• filter to_ucl - Convert YAML dictionary to UCL string.

• lookup galaxy_info - Get the meta data from galaxy.yml

Roles:

• apache - Install, configure, and run Apache HTTP server.

• certificate - Generate and/or check OpenSSL certificates.

• config_light - Install packages, configure files, services, and handlers.

• custom_image - Download, mount, and customize system images.

• dhcp - Install and configure DHCP.

• iocage - Install and configure iocage.

• iocage_template - Create iocage templates.

• lib - Library of tasks.

• network - Configure network.

• nginx - Install, configure, and run Nginx.

• packages - Configure repos and install packages.

• pf - Configure pf.

• postinstall - Postinstall configuration.

• poudriere - Install and configure Poudriere build system.

• rsnapshot - Install and configure rsnapshot.

• zfs - Configure ZFS.

Various Playbooks.

Note

• The above Requirements list the collections required by the roles.

• All listed collections are included in the standard Ansible distribution.

• The roles may require other roles not listed here. See the roles’ requirements.yml files and install the missing roles manually when needed.

See also

• Managing BSD hosts with Ansible

• Jails and Containers - FreeBSD Handbook

• Jails - FreeBSD Wiki

Tip

See the Examples and proof of concepts in the Sandbox.

Hint

• Run Ansible in Python virtual environment. See venv — Creation of virtual environments.

• Use result_format=yaml

Important

• Ansible claims:

  BSD support is important to us at Ansible. ... we have an active BSD community
  and strive to be as BSD-friendly as possible.
  

  Search latest Ansible docs for FreeBSD to learn the current FreeBSD support.