ansible-freebsd-jailhost-tools/README.md

43 lines
1.2 KiB
Markdown
Raw Normal View History

2017-03-09 17:17:13 +01:00
Role Name
=========
2017-03-09 17:40:10 +01:00
This role is a set of tools for maintaining FreeBSD jails using ZFS. The nature of this role is to include the `tasks/jail/main.yml` with the proper variables set up. It will check if the underlying OS version in the jail is outdated, and update if necessary, while calling configured hooks during the process.
I use this on my single server box to maintain separation between various services. Of course, the nature of Ansible does make this rule and anything that uses it, scalable.
2017-03-09 17:17:13 +01:00
Requirements
------------
2017-03-09 17:40:10 +01:00
A fairly recent FreeBSD box.
2017-03-09 17:17:13 +01:00
Role Variables
--------------
2017-03-09 17:40:10 +01:00
Variables this role uses are defined in the `defaults/main.yml` file, using sensible defaults. Override then at your convenience.
2017-03-09 17:17:13 +01:00
Dependencies
------------
2017-03-09 17:40:10 +01:00
This role depends on an already existing 'jail template', that is provided by the role `karolyi.freebsd-zfs-jailtemplate`.
2017-03-09 17:17:13 +01:00
Example Playbook
----------------
Including an example of how to use your role (for instance, with variables passed in as parameters) is always nice for users too:
2017-03-09 17:40:10 +01:00
- hosts:
- localhost
2017-03-09 17:17:13 +01:00
roles:
2017-03-09 17:58:42 +01:00
- karolyi.ansible-freebsd-jailhost-tools
2017-03-09 17:17:13 +01:00
License
-------
BSD
Author Information
------------------
2017-03-09 17:40:10 +01:00
László Károlyi: [Linkedin profile](https://linkedin.com/in/karolyi)