Skip to content

argument_specs missing for this role and others #206

@EmptyByte

Description

@EmptyByte

As per:
https://docs.ansible.com/projects/ansible/latest/playbook_guide/playbooks_reuse_roles.html#role-argument-validation

The role lacks argument validation. It would be nice if this was included ?

argument_specs:
  main:
    short_description: Main entry point for the Postfix role
    options:
      postfix_conf:
        type: dict
        default: {}
        description: >-
          This is a dictionary which can hold key/value pairs of all supported
          Postfix configuration parameters. Keys not supported by the installed
          Postfix are ignored. The default is empty {}.
        options:
          previous:
            type: str
            choices: ['replaced']

      postfix_files:
        type: list
        elements: dict
        default: []
        description: >-
          This is a list of files that will be placed in /etc/postfix and that
          can be converted into Postfix Lookup Tables if needed.
        options:
          name:
            type: str
            required: true
          content:
            type: str
            required: true
          postmap:
            type: bool
            default: false

      postfix_check:
        type: bool
        default: true
        description: >-
          This is a boolean which determines if postfix check is run before
          starting Postfix if the configuration has changed. The default is true.

      postfix_backup:
        type: bool
        default: false
        description: >-
          This is a boolean which determines if the role will make a single
          backup copy of the configuration - for example, cp /etc/postfix/main.cf
          /etc/postfix/main.cf.backup, thus overwriting the previous backup, if any.
          The default is false. NOTE: If you want to set this to true, you must also
          set postfix_backup_multiple: false - see below.

      postfix_backup_multiple:
        type: bool
        default: true
        description: >-
          This is a boolean which determines if the role will make a timestamped
          backup copy of the configuration - for example, cp /etc/postfix/main.cf
          /etc/postfix/main.cf.$(date -Isec), thus keeping multiple backup copies.
          The default is true. NOTE: This setting overrides postfix_backup, so you
          must set this to false if you want to use postfix_backup.

      postfix_manage_firewall:
        type: bool
        default: false
        description: >-
          Boolean flag allowing to configure firewall using the firewall role.
          Manage the smtp related ports, 25/tcp, 465/tcp, and 587/tcp. If the
          variable is set to false, the postfix role does not manage the firewall.
          Default to false.

      postfix_manage_selinux:
        type: bool
        default: false
        description: >-
          Boolean flag allowing to configure selinux using the selinux role.
          Assign smtp_port_t to the smtp related ports. If the variable is set to
          false, the postfix role does not manage the selinux.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions