https://github.com/liv-io/ansible-roles-bsd

Ansible roles for FreeBSD and OpenBSD
https://github.com/liv-io/ansible-roles-bsd

ansible ansible-roles freebsd openbsd

Last synced: about 1 month ago
JSON representation

Ansible roles for FreeBSD and OpenBSD

• Host: GitHub
• URL: https://github.com/liv-io/ansible-roles-bsd
• Owner: liv-io
• License: bsd-2-clause
• Archived: true
• Created: 2016-10-15T21:17:07.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2022-10-25T10:34:34.000Z (about 2 years ago)
• Last Synced: 2024-09-26T06:01:18.397Z (about 2 months ago)
• Topics: ansible, ansible-roles, freebsd, openbsd
• Language: Shell
• Homepage:
• Size: 7.56 MB
• Stars: 41
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# ansible-roles-bsd

[![Contributors][contributors-shield]][contributors-url]

[![Forks][forks-shield]][forks-url]

[![Stargazers][stars-shield]][stars-url]

[![Issues][issues-shield]][issues-url]

[![BSD License][license-shield]][license-url]

:warning: This repository is not maintained anymore. Unfortunately, I stopped using and maintaining FreeBSD due to time constraints.

:information_source: For Ansible roles supporting the OpenBSD operating system, please use the new repository called `ansible-roles-openbsd`.

## Index

* [About](#about)

  * [Features](#features)

  * [Support](#support)

  * [Dependencies](#dependencies)

* [Setup](#setup)

  * [Requirements](#requirements)

  * [Installation](#installation)

* [Usage](#usage)

* [Roadmap](#roadmap)

* [Contributing](#contributing)

* [License](#license)

* [Contact](#contact)

* [Credits](#credits)

* [Appendix](#appendix)

## About

`ansible-roles-bsd` is a collection of well curated Ansible roles for the FreeBSD and OpenBSD operating system. All Ansible roles are licensed under the Simplified BSD License.

### Features

* Configurations follow the secure-by-default principle

* Roles are mostly self-contained and dependencies avoided

* Roles and services support multiple states (install, remove, enable, disable, inactive)

* Scripts and cronjobs support multiple states (enable, disable)

* Services can be monitored with Monit and exported via monit_exporter to Prometheus

* Scripts support Email and Prometheus monitoring

* Logs can be forwarded with syslog to Loki

* Roles can proxy HTTP/HTTPS traffic through Squid forward proxy

* Host-based firewall restricts ingress and egress traffic by default

* PF can be used as network-based/perimeter firewall

* Restic and rest-server are available as backup solution

* OpenNTPD is configurable as NTP client and server

* Unbound is available as resolving DNS server

* NSD is available as authoritative DNS server

* Prometheus has built-in alerting rules and Grafana dashboards

* Loki has built-in alerting rules and Grafana dashboards

* Parameters are documented with examples and marked when implemented

* Changes adhere to semantic versioning guidelines

* Roles contain changelog

### Support

The following operating systems are supported:

* FreeBSD 12.2-*

* OpenBSD 7.1

### Dependencies

The Ansible control machine depends on:

* [Ansible](https://github.com/ansible/ansible) >= 2.8.0

The Ansible managed node depends on:

* [Python](https://github.com/python/cpython) >= 2.7.0

## Setup

### Requirements

### Installation

## Usage

## Roadmap

* Add IPv6 support (freebsd_pf, openbsd_pf...)

* Support monitoring via Coremon

* Add OpenBSD support (cron)

* Add FreeBSD support (opensmtpd, rest_server, rsyslog, suricata, tinc)

## Contributing

## License

Distributed under the Simplified BSD License.

See `LICENSE` file for more information.

## Contact

Author: [email protected]

Project: [ansible-roles-bsd](https://github.com/liv-io/ansible-roles-bsd)

## Credits

See `CREDITS` file for more information.

## Appendix

### Loki/Grafana Dashboards

| Suricata |

| --- |

|  |

### Prometheus/Grafana Dashboards

| System Status | Script Status |

| --- | --- |

|  |  |

| Network Traffic | Ping Prober |

| --- | --- |

|  |  |

[contributors-shield]: https://img.shields.io/github/contributors/liv-io/ansible-roles-bsd.svg?style=flat

[contributors-url]: https://github.com/liv-io/ansible-roles-bsd/graphs/contributors

[forks-shield]: https://img.shields.io/github/forks/liv-io/ansible-roles-bsd.svg?style=flat

[forks-url]: https://github.com/liv-io/ansible-roles-bsd/network/members

[stars-shield]: https://img.shields.io/github/stars/liv-io/ansible-roles-bsd.svg?style=flat

[stars-url]: https://github.com/liv-io/ansible-roles-bsd/stargazers

[issues-shield]: https://img.shields.io/github/issues/liv-io/ansible-roles-bsd.svg?style=flat

[issues-url]: https://github.com/liv-io/ansible-roles-bsd/issues

[license-shield]: https://img.shields.io/github/license/liv-io/ansible-roles-bsd.svg?style=flat

[license-url]: https://github.com/liv-io/ansible-roles-bsd/blob/master/LICENSE