debops.etc_aliases default variables

Basic configuration

etc_aliases__rfc2142_compliant

Enable or disable mail aliases recommended by RFC 2142: Mailbox Names For Common Services and Functions.

etc_aliases__rfc2142_compliant: True
etc_aliases__admin_private_email

List of e-mail addresses of the system administrators defined by the debops.core Ansible role. These addresses will be used as the recipients of the mail sent to the root account.

etc_aliases__admin_private_email: '{{ ansible_local.core.admin_private_email
                                      if (ansible_local|d() and ansible_local.core|d() and
                                          ansible_local.core.admin_private_email)
                                      else ("root@" + etc_aliases__domain) }}'
etc_aliases__domain

The DNS domain used to generate the root e-mail alias if debops.core role facts are not present on the host.

etc_aliases__domain: '{{ ansible_local.core.domain
                         if (ansible_local|d() and ansible_local.core|d() and
                             ansible_local.core.domain|d())
                         else (ansible_domain if ansible_domain else ansible_hostname) }}'

Local mail aliases and their recipients

These lists define the aliases present in the /etc/aliases database and their corresponding mail recipients. See etc_aliases__recipients for more details.

etc_aliases__rfc2142_recipients

List of mailboxes defined by the RFC 2142: Mailbox Names For Common Services and Functions.

etc_aliases__rfc2142_recipients:

  - name: 'info'
    dest: 'staff'
    comment: |
      Packaged information about the organization,
      products and/or services, as appropriate.
    section: 'business'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'marketing'
    dest: 'staff'
    comment: 'Product marketing and marketing communications.'
    section: 'business'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'sales'
    dest: 'staff'
    comment: 'Product purchase information.'
    section: 'business'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'support'
    dest: 'staff'
    comment: 'Problems with products or services.'
    section: 'business'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'abuse'
    dest: 'root'
    comment: 'Inappropriate public behaviour.'
    section: 'network'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'noc'
    to: 'root'
    comment: 'Network infrastructure.'
    section: 'network'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - alias: 'security'
    to: 'root'
    comment: 'Security bulletins or queries.'
    section: 'network'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'postmaster'
    dest: 'root'
    section: 'support'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'hostmaster'
    dest: 'root'
    section: 'support'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'usenet'
    dest: 'root'
    section: 'support'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'news'
    dest: 'usenet'
    section: 'support'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'webmaster'
    dest: 'root'
    section: 'support'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'www'
    dest: 'webmaster'
    section: 'support'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'uucp'
    dest: 'root'
    section: 'support'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'ftp'
    dest: 'root'
    section: 'support'
    state: '{{ "present"
               if etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'
etc_aliases__default_recipients

List of the default mail aliases defined by the role.

etc_aliases__default_recipients:

  - name: 'root'
    dest: '{{ etc_aliases__admin_private_email }}'
    section: 'admin'
    weight: -10

  - name: 'admin'
    dest: 'root'
    section: 'admin'
    weight: -8

  - name: 'hostmaster'
    dest: 'root'
    section: 'admin'
    weight: -8
    state: '{{ "present"
               if not etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'operator'
    dest: 'root'
    section: 'admin'
    weight: -8

  - name: 'backup'
    dest: 'root'
    section: 'admin'
    weight: -5

  - name: 'monitoring'
    dest: 'root'
    section: 'admin'
    weight: -5

  - name: 'staff'
    dest: 'root'
    section: 'admin'

  - name: 'postmaster'
    dest: 'root'
    section: 'system'
    state: '{{ "present"
               if not etc_aliases__rfc2142_compliant|bool
               else "ignore" }}'

  - name: 'MAILER-DAEMON'
    dest: 'postmaster'
    section: 'system'

  - name: 'noreply'
    dest: 'devnull'
    section: 'system'
    weight: 10

  - name: 'devnull'
    dest: '/dev/null'
    section: 'system'
    weight: 20
etc_aliases__recipients

List of the mail aliases and recipients which should be present on all hosts in the Ansible inventory.

etc_aliases__recipients: []
etc_aliases__group_recipients

List of the mail alases and recipients which should be present on host in a specific Ansible inventory group.

etc_aliases__group_recipients: []
etc_aliases__host_recipients

List of the mail aliases and recipients which should be present on specific hosts in the Ansible inventory.

etc_aliases__host_recipients: []
etc_aliases__dependent_recipients

List of the mail aliases and recipients defined by other roles through role dependent variables. The configuration syntax differs from a normal alias/recipient configuration, see Usage as a role dependency for more details.

etc_aliases__dependent_recipients: []
etc_aliases__dependent_recipients_filter

The filtered configuration from other roles passed via role dependent variables. This variable should be included in the combined list of aliases/recipients. See Usage as a role dependency for more details.

etc_aliases__dependent_recipients_filter: '{{ lookup("template",
                                              "lookup/etc_aliases__dependent_recipients_filter.j2")
                                              | from_yaml }}'
etc_aliases__combined_recipients

Combined list of aliases and recipients which is passed to the configuration template.

etc_aliases__combined_recipients: '{{ etc_aliases__rfc2142_recipients
                                       + etc_aliases__default_recipients
                                       + etc_aliases__dependent_recipients_filter
                                       + etc_aliases__recipients
                                       + etc_aliases__group_recipients
                                       + etc_aliases__host_recipients }}'
etc_aliases__sections

List of sections defined in the /etc/aliases file for readability. See etc_aliases__sections for more details.

etc_aliases__sections:

  - name: 'admin'
    title: 'IT Operations mail aliases'

  - name: 'unknown'
    title: 'User mail aliases'

  - name: 'business'
    title: 'RFC 2142: Business-related mail aliases'

  - name: 'network'
    title: 'RFC 2142: Network Operations mail aliases'

  - name: 'support'
    title: 'RFC 2142: Mail aliases for specific host services'

  - name: 'system'
    title: 'Internal mail system aliases'