community.general.awall (8.5.0) — module

Install collection

Install with ansible-galaxy collection install community.general:==8.5.0

Add to requirements.yml

  collections:
    - name: community.general
      version: 8.5.0

Description

This modules allows for enable/disable/activate of C(awall) policies.

Alpine Wall (C(awall)) generates a firewall configuration from the enabled policy files and activates the configuration on the system.

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Inputs

    
name:
    description:
    - One or more policy names.
    elements: str
    type: list

state:
    choices:
    - disabled
    - enabled
    default: enabled
    description:
    - Whether the policies should be enabled or disabled.
    type: str

activate:
    default: false
    description:
    - Activate the new firewall rules.
    - Can be run with other steps or on its own.
    - Idempotency is affected if O(activate=true), as the module will always report a
      changed state.
    type: bool