community.general.awall module – Manage awall policies

Note

This module is part of the community.general collection (version 4.8.3).

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

Comments

activate

boolean

Activate the new firewall rules.

Can be run with other steps or on its own.

Choices:

  • no ← (default)

  • yes

name

list / elements=string

One or more policy names.

state

string

Whether the policies should be enabled or disabled.

Choices:

  • disabled

  • enabled ← (default)

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

  • Ted Trask (@tdtrask)