Docs4dev
Docs
ansible / latest / collections / community / general / awall_module.html

community.general.awall – Manage awall policies

Note

This plugin is part of the community.general collection (version 3.8.1).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.awall.

Synopsis

  • This modules allows for enable/disable/activate of awall policies.
  • Alpine Wall (awall) generates a firewall configuration from the enabled policy files and activates the configuration on the system.

Parameters

Parameter Choices/Defaults Comments
activate
boolean
    Choices:
  • no ←
  • yes
Activate the new firewall rules.
Can be run with other steps or on its own.
name
list / elements=string
One or more policy names.
state
string
    Choices:
  • disabled
  • enabled ←
Whether the policies should be enabled or disabled.

Examples

- name: Enable "foo" and "bar" policy
  community.general.awall:
    name: [ foo bar ]
    state: enabled

- name: Disable "foo" and "bar" policy and activate new rules
  community.general.awall:
    name:
    - foo
    - bar
    state: disabled
    activate: no

- name: Activate currently enabled firewall rules
  community.general.awall:
    activate: yes

Authors

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/awall_module.html