7ff891796a
# [0.8.0](https://github.com/saltstack-formulas/firewalld-formula/compare/v0.7.0...v0.8.0) (2020-02-12) ### Continuous Integration * workaround issues with newly introduced `amazonlinux-1` [skip ci] ([ace3433](ace343353d)) * workaround issues with newly introduced `amazonlinux-1` [skip ci] ([b5a95f3](b5a95f35ab)) * **gemfile:** restrict `train` gem version until upstream fix [skip ci] ([908f5df](908f5df86c)) * **kitchen:** avoid using bootstrap for `master` instances [skip ci] ([0b82e43](0b82e43a15)) * **travis:** apply changes from build config validation [skip ci] ([6e1b876](6e1b876298)) * **travis:** opt-in to `dpl v2` to complete build config validation [skip ci] ([70dc9aa](70dc9aa3b4)) * **travis:** quote pathspecs used with `git ls-files` [skip ci] ([97afbb1](97afbb1575)) * **travis:** run `shellcheck` during lint job [skip ci] ([d8bede7](d8bede7082)) * **travis:** use `major.minor` for `semantic-release` version [skip ci] ([b96cc56](b96cc569fe)) * **travis:** use build config validation (beta) [skip ci] ([07e7900](07e79001cd)) ### Features * standardize license and hand over to saltstack formulas ([20cb8a6](20cb8a60d3))
.. _readme: firewalld-formula ================= |img_travis| |img_sr| .. |img_travis| image:: https://travis-ci.com/saltstack-formulas/firewalld-formula.svg?branch=master :alt: Travis CI Build Status :scale: 100% :target: https://travis-ci.com/saltstack-formulas/firewalld-formula .. |img_sr| image:: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg :alt: Semantic Release :scale: 100% :target: https://github.com/semantic-release/semantic-release A SaltStack Formula to set up and configure Firewalld, a dynamically managed firewall with support for network/firewall zones to define the trust level of network connections or interfaces. .. contents:: **Table of Contents** General notes ------------- See the full `SaltStack Formulas installation and usage instructions <https://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html>`_. If you are interested in writing or contributing to formulas, please pay attention to the `Writing Formula Section <https://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html#writing-formulas>`_. If you want to use this formula, please pay attention to the ``FORMULA`` file and/or ``git tag``, which contains the currently released version. This formula is versioned according to `Semantic Versioning <http://semver.org/>`_. See `Formula Versioning Section <https://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html#versioning>`_ for more details. If you need (non-default) configuration, please pay attention to the ``pillar.example`` file and/or `Special notes`_ section. Contributing to this repo ------------------------- **Commit message formatting is significant!!** Please see `How to contribute <https://github.com/saltstack-formulas/.github/blob/master/CONTRIBUTING.rst>`_ for more details. Special notes ------------- None 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``). 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 Available states ---------------- .. contents:: :local: ``firewalld`` ^^^^^^^^^^^^^ Manage firewalld Testing ------- Linux testing is done with ``kitchen-salt``. Requirements ^^^^^^^^^^^^ * Ruby * Docker .. code-block:: bash $ gem install bundler $ bundle install $ bin/kitchen test [platform] Where ``[platform]`` is the platform name defined in ``kitchen.yml``, e.g. ``debian-9-2019-2-py3``. ``bin/kitchen converge`` ^^^^^^^^^^^^^^^^^^^^^^^^ Creates the docker instance and runs the ``firewalld`` main state, ready for testing. ``bin/kitchen verify`` ^^^^^^^^^^^^^^^^^^^^^^ Runs the ``inspec`` tests on the actual instance. ``bin/kitchen destroy`` ^^^^^^^^^^^^^^^^^^^^^^^ Removes the docker instance. ``bin/kitchen test`` ^^^^^^^^^^^^^^^^^^^^ Runs all of the stages above in one go: i.e. ``destroy`` + ``converge`` + ``verify`` + ``destroy``. ``bin/kitchen login`` ^^^^^^^^^^^^^^^^^^^^^ Gives you SSH access to the instance for manual testing.