firewalld-formula

Saltstack Official FirewallD Formula

Niels Abspoel f560dcd1b4 add @myii recommendations		vor 5 Jahren
firewalld	fix spacing in closing tags	vor 5 Jahren
test/integration/default	Refactor backend format, add backward compatibility, simple pkg testing	vor 6 Jahren
.gitignore	Add basic test suite	vor 7 Jahren
.travis.yml	update test images	vor 5 Jahren
Gemfile	update gems	vor 5 Jahren
LICENSE	Initial commit.	vor 10 Jahren
README.rst	Updated REDME	vor 6 Jahren
VERSION	Update pillar.example	vor 6 Jahren
kitchen.yml	add @myii recommendations	vor 5 Jahren
pillar.example	update service and zones with more options	vor 5 Jahren

README.rst

=================
firewalld-formula
=================

Salt Stack Formula to set up and configure Firewalld, dynamically managed firewall with support for network/firewall zones to define the trust level of network connections or interfaces

.. image:: https://travis-ci.org/saltstack-formulas/firewalld-formula.svg?branch=master

NOTICE BEFORE YOU USE
=====================

* This formula aims to follow the conventions and recommendations described at http://docs.saltstack.com/topics/conventions/formulas.html

TODO
====

* configure local pre-commit hooks (code syntax check based on file extension, check for ugly *utf-8 mac os white space*)

Instructions
============

1. Add this repository as a `GitFS <http://docs.saltstack.com/topics/tutorials/gitfs.html>`_ backend in your Salt master config.

2. Configure your Pillar top file (``/srv/pillar/top.sls``), see pillar.example

3. Include this Formula within another Formula or simply define your needed states within the Salt top file (``/srv/salt/top.sls``).

Available states
================

.. contents::
    :local:

``firewalld``
-------------
Manage firewalld

Additional resources
====================

None

Formula Dependencies
====================

None

Contributions
=============

Contributions are always welcome. All development guidelines you have to know are

* write clean code (proper YAML+Jinja syntax, no trailing whitespaces, no empty lines with whitespaces, LF only)
* set sane default settings
* test your code
* update README.rst doc

Salt Compatibility
==================

Tested with:

* 2018.3.x (will probably work too with 2017.x.x)

OS Compatibility
================

Tested with:

* CentOS 7
* Debian 9
* Ubuntu 18.04