Ansible Role for SpamAssassin

This guide explains how to install and set up SpamAssassin on your system.

GitHub	GitLab	Downloads	Version

Example Playbook

Here is a basic example of how to use this role, taken from molecule/default/converge.yml. This is tested automatically with each update.

---
- name: Converge
  hosts: all
  become: true
  gather_facts: true

  roles:
    - role: robertdebock.spamassassin

Before running this, your machine needs to be prepared. In a CI environment, this is done using molecule/default/prepare.yml:

---
- name: Prepare
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: robertdebock.bootstrap
    - role: robertdebock.core_dependencies
    - role: robertdebock.cron
    - role: robertdebock.logrotate
      logrotate_entries:
        - name: spamassassin
          path: /var/log/spamassassin
          missingok: true
    - role: robertdebock.rsyslog

For a more detailed explanation and examples, please visit this page.

Role Variables

Default settings for SpamAssassin variables can be found in defaults/main.yml:

---
# defaults file for spamassassin

# User and group SpamAssassin should run under.
spamassassin_group: spamd
spamassassin_user: spamd

Requirements

You will need the pip packages listed in requirements.txt.

State of Used Roles

These are the roles needed to set up your system. You can follow a different method if you'd like.

Requirement	GitHub	GitLab
robertdebock.bootstrap
robertdebock.core_dependencies
robertdebock.cron
robertdebock.logrotate
robertdebock.rsyslog

Context

This role works with many other related roles. For more information, check out the documentation of these roles.

Here's a visual representation of related roles:

Compatibility

This role has been tested on these container images:

You need at least Ansible version 2.12. Tests were executed on:

• Previous version
• Current version
• Development version

If you notice any issues, please report them on GitHub.

License

This project is licensed under the Apache-2.0.

Author Information

Created by robertdebock.

If you find this project useful, please consider sponsoring me.