An open API service indexing awesome lists of open source software.

https://github.com/jomrr/ansible-role-firewalld

Ansible role for setting up firewalld.
https://github.com/jomrr/ansible-role-firewalld

ansible ansible-role firewalld

Last synced: about 1 month ago
JSON representation

Ansible role for setting up firewalld.

Awesome Lists containing this project

README

          

# Ansible role firewalld

![GitHub](https://img.shields.io/github/license/jomrr/ansible-role-firewalld) ![GitHub last commit](https://img.shields.io/github/last-commit/jomrr/ansible-role-firewalld) ![GitHub issues](https://img.shields.io/github/issues-raw/jomrr/ansible-role-firewalld)

**Ansible role for setting up firewalld.**

## Description

Install firewalld, manage zones and interface assignments and configure rules.
Rich and direct rules are also supported.

## Prerequisites

This role has no special prerequisites.

### System packages (Fedora)

- `python3` (Python 3.8 or later)
- `python3-nftables`

### Python (requirements.txt)

- ansible >= 2.15

## Dependencies (requirements.yml)

This role has no dependencies.

## Supported Platforms

| OS Family | Distribution | Version | Container Image |
|-----------|--------------|---------|-----------------|
| RedHat | AlmaLinux | 8 | [jomrr/molecule-almalinux:8]( https://hub.docker.com/r/jomrr/molecule-almalinux ) |
| | | 9 | [jomrr/molecule-almalinux:9]( https://hub.docker.com/r/jomrr/molecule-almalinux ) |
| Alpine | Alpine | 3.18 | [jomrr/molecule-alpine:3.18]( https://hub.docker.com/r/jomrr/molecule-alpine ) |
| | | 3.19 | [jomrr/molecule-alpine:3.19]( https://hub.docker.com/r/jomrr/molecule-alpine ) |
| Debian | Debian | 11 | [jomrr/molecule-debian:11]( https://hub.docker.com/r/jomrr/molecule-debian ) |
| | | 12 | [jomrr/molecule-debian:12]( https://hub.docker.com/r/jomrr/molecule-debian ) |
| RedHat | Fedora | 39 | [jomrr/molecule-fedora:39]( https://hub.docker.com/r/jomrr/molecule-fedora ) |
| | | 40 | [jomrr/molecule-fedora:40]( https://hub.docker.com/r/jomrr/molecule-fedora ) |
| | | rawhide | [jomrr/molecule-fedora:rawhide]( https://hub.docker.com/r/jomrr/molecule-fedora ) |
| Debian | Ubuntu | 20.04 | [jomrr/molecule-ubuntu:20.04]( https://hub.docker.com/r/jomrr/molecule-ubuntu ) |
| | | 22.04 | [jomrr/molecule-ubuntu:22.04]( https://hub.docker.com/r/jomrr/molecule-ubuntu ) |
| | | 24.04 | [jomrr/molecule-ubuntu:24.04]( https://hub.docker.com/r/jomrr/molecule-ubuntu ) |

## Role Variables

No role default variables specified, see [defaults/main.yml](defaults/main.yml).

## Example Playbook

Example playbooks(s) that show how to use this role.

## Simple example playbook

A simple default example playbook for using jomrr.firewalld.
```yaml
---
# name: "jomrr.firewalld"
# file: "playbook_firewalld.yml"

- name: "PLAYBOOK | firewalld"
hosts: all
gather_facts: true
roles:
- role: "jomrr.firewalld"
```

## Author(s) and License

- :octocat: Author:: [jomrr](https://github.com/jomrr)
- :triangular_flag_on_post: Copyright:: 2024, Jonas Mauer
- :page_with_curl: License:: [MIT](LICENSE)

## References

- [firewalld](https://firewalld.org/)

---