diff --git a/docs/index.html b/docs/index.html index 465d02c..4e513f2 100644 --- a/docs/index.html +++ b/docs/index.html @@ -156,6 +156,13 @@

Contents

  • postfix_manage_selinux
  • +
  • Variables Exported by the +Role +
  • Limitations
  • Example Playbook
  • @@ -276,6 +283,23 @@

    postfix_manage_selinux

    adding policy. It cannot be used for removing policy. If you want to remove policy, you will need to use the selinux system role directly.

    +

    Variables Exported by the +Role

    +

    postfix_default_database_type

    +

    This is a string which specifies the default database type used by +postfix, which is obtained by using +postconf -h default_database_type. This can be used to set +configuration which depends on the type. NOTE this is +not supported with Ansible 2.9.

    +
    - name: Manage postfix
    +  hosts: all
    +  vars:
    +    postfix_conf:
    +      relay_domains: "{{ postfix_default_database_type }}:/etc/postfix/relay_domains"
    +  roles:
    +    - linux-system-roles.postfix

    Limitations

    There is no way to remove separate configuration parameters. As a workaround, you can use postfix_conf's @@ -287,52 +311,52 @@

    Example Playbook

    Install and enable postfix. Configure relay_domains=$mydestination and relayhost=example.com.

    -
    ---
    -- name: Manage postfix
    -  hosts: all
    -  vars:
    -    postfix_conf:
    -      relay_domains: $mydestination
    -      relayhost: example.com
    -  roles:
    -    - linux-system-roles.postfix
    -

    Install and enable postfix. Do not run 'postfix check' before -restarting postfix:

    ---
    -- name: Manage postfix with no check
    +- name: Manage postfix
       hosts: all
       vars:
    -    postfix_check: false
    -  roles:
    -    - linux-system-roles.postfix
    -

    Install and enable postfix. Do single backup of main.cf (older backup -will be rewritten) and configure relayhost=example.com:

    + postfix_conf: + relay_domains: $mydestination + relayhost: example.com + roles: + - linux-system-roles.postfix +

    Install and enable postfix. Do not run 'postfix check' before +restarting postfix:

    ---
    -- name: Manage postfix with relayhost
    +- name: Manage postfix with no check
       hosts: all
       vars:
    -    postfix_conf:
    -      relayhost: example.com
    -    postfix_backup: true
    -  roles:
    -    - linux-system-roles.postfix
    -

    Install and enable postfix. Do timestamped backup of main.cf and -configure relayhost=example.com (if -postfix_backup_multiple is set to true -postfix_backup is ignored):

    + postfix_check: false + roles: + - linux-system-roles.postfix +

    Install and enable postfix. Do single backup of main.cf (older backup +will be rewritten) and configure relayhost=example.com:

    ---
    -- name: Manage postfix with multiple backups
    +- name: Manage postfix with relayhost
       hosts: all
       vars:
         postfix_conf:
           relayhost: example.com
    -    postfix_backup_multiple: true
    +    postfix_backup: true
       roles:
         - linux-system-roles.postfix
    +

    Install and enable postfix. Do timestamped backup of main.cf and +configure relayhost=example.com (if +postfix_backup_multiple is set to true +postfix_backup is ignored):

    +
    ---
    +- name: Manage postfix with multiple backups
    +  hosts: all
    +  vars:
    +    postfix_conf:
    +      relayhost: example.com
    +    postfix_backup_multiple: true
    +  roles:
    +    - linux-system-roles.postfix

    rpm-ostree

    See README-ostree.md

    License

    diff --git a/latest/README.html b/latest/README.html index 465d02c..4e513f2 100644 --- a/latest/README.html +++ b/latest/README.html @@ -156,6 +156,13 @@

    Contents

  • postfix_manage_selinux
  • +
  • Variables Exported by the +Role +
  • Limitations
  • Example Playbook
  • @@ -276,6 +283,23 @@

    postfix_manage_selinux

    adding policy. It cannot be used for removing policy. If you want to remove policy, you will need to use the selinux system role directly.

    +

    Variables Exported by the +Role

    +

    postfix_default_database_type

    +

    This is a string which specifies the default database type used by +postfix, which is obtained by using +postconf -h default_database_type. This can be used to set +configuration which depends on the type. NOTE this is +not supported with Ansible 2.9.

    +
    - name: Manage postfix
    +  hosts: all
    +  vars:
    +    postfix_conf:
    +      relay_domains: "{{ postfix_default_database_type }}:/etc/postfix/relay_domains"
    +  roles:
    +    - linux-system-roles.postfix

    Limitations

    There is no way to remove separate configuration parameters. As a workaround, you can use postfix_conf's @@ -287,52 +311,52 @@

    Example Playbook

    Install and enable postfix. Configure relay_domains=$mydestination and relayhost=example.com.

    -
    ---
    -- name: Manage postfix
    -  hosts: all
    -  vars:
    -    postfix_conf:
    -      relay_domains: $mydestination
    -      relayhost: example.com
    -  roles:
    -    - linux-system-roles.postfix
    -

    Install and enable postfix. Do not run 'postfix check' before -restarting postfix:

    ---
    -- name: Manage postfix with no check
    +- name: Manage postfix
       hosts: all
       vars:
    -    postfix_check: false
    -  roles:
    -    - linux-system-roles.postfix
    -

    Install and enable postfix. Do single backup of main.cf (older backup -will be rewritten) and configure relayhost=example.com:

    + postfix_conf: + relay_domains: $mydestination + relayhost: example.com + roles: + - linux-system-roles.postfix +

    Install and enable postfix. Do not run 'postfix check' before +restarting postfix:

    ---
    -- name: Manage postfix with relayhost
    +- name: Manage postfix with no check
       hosts: all
       vars:
    -    postfix_conf:
    -      relayhost: example.com
    -    postfix_backup: true
    -  roles:
    -    - linux-system-roles.postfix
    -

    Install and enable postfix. Do timestamped backup of main.cf and -configure relayhost=example.com (if -postfix_backup_multiple is set to true -postfix_backup is ignored):

    + postfix_check: false + roles: + - linux-system-roles.postfix +

    Install and enable postfix. Do single backup of main.cf (older backup +will be rewritten) and configure relayhost=example.com:

    ---
    -- name: Manage postfix with multiple backups
    +- name: Manage postfix with relayhost
       hosts: all
       vars:
         postfix_conf:
           relayhost: example.com
    -    postfix_backup_multiple: true
    +    postfix_backup: true
       roles:
         - linux-system-roles.postfix
    +

    Install and enable postfix. Do timestamped backup of main.cf and +configure relayhost=example.com (if +postfix_backup_multiple is set to true +postfix_backup is ignored):

    +
    ---
    +- name: Manage postfix with multiple backups
    +  hosts: all
    +  vars:
    +    postfix_conf:
    +      relayhost: example.com
    +    postfix_backup_multiple: true
    +  roles:
    +    - linux-system-roles.postfix

    rpm-ostree

    See README-ostree.md

    License