linux-system-roles.postfix

postfix

ansible-lint.yml ansible-test.yml markdownlint.yml tft.yml tft_citest_bad.yml woke.yml

Este rol puede instalar, configurar e iniciar Postfix MTA.

Requisitos

Ver a continuación

Requisitos de colección

El rol requiere el rol firewall y el rol selinux de la colección fedora.linux_system_roles, si postfix_manage_firewall y postfix_manage_selinux están establecidos en verdadero, respectivamente. (También consulte postfix_manage_firewall y postfix_manage_selinux)

Si postfix es un rol de la colección fedora.linux_system_roles o del paquete RPM de Fedora, el requisito ya está satisfecho.

El rol requiere colecciones adicionales para gestionar sistemas rpm-ostree. Si necesita gestionar sistemas rpm-ostree, ejecute el siguiente comando para instalar las colecciones.

ansible-galaxy collection install -r meta/collection-requirements.yml

Variables del rol

postfix_conf

postfix_conf:
  relayhost: example.com

Este es un diccionario que puede contener pares de clave/valor de todos los parámetros de configuración soportados por Postfix. Las claves no soportadas por el Postfix instalado son ignoradas. El valor por defecto es vacío {}.

Puede especificar previous: replaced dentro del diccionario postfix_conf para eliminar cualquier configuración existente y aplicar la configuración deseada sobre una instalación limpia de postfix.

ADVERTENCIA: Si especifica previous: replaced, el rol reinstala el paquete postfix y reemplaza los archivos existentes /etc/postfix/main.cf y /etc/postfix/master.cf. Asegúrese de hacer una copia de seguridad de esos archivos para preservar su configuración.

ADVERTENCIA: Al gestionar sistemas rpm-ostree, el rol no puede reinstalar el paquete postfix, por lo que solo reemplaza los archivos de configuración modificados por archivos vacíos. Esto no es idempotente.

Si solo especifica previous: replaced en el diccionario postfix_conf, el rol reinstala el paquete postfix y habilita el servicio postfix sin aplicar ninguna configuración.

Por ejemplo, para eliminar la configuración existente y establecer relayhost: example.com sobre una instalación limpia del postfix, use postfix_conf de esta manera:

postfix_conf:
  previous: replaced
  relayhost: example.com

postfix_files

postfix_files:
  - name: sasl_passwd
    content: example.com user:password
    postmap: true
  - name: sender_canonical_maps
    content: /.+/  [email protected]

Esta es una lista de archivos que se colocarán en /etc/postfix y que se pueden convertir en Tablas de Búsqueda de Postfix si es necesario.

Está destinado a ser un mecanismo simple para configurar cosas como credenciales SASL y otros fragmentos pequeños.

postfix_check

postfix_check: false

Este es un booleano que determina si se ejecuta postfix check antes de iniciar Postfix si la configuración ha cambiado. El valor por defecto es true.

postfix_backup

postfix_backup: true

Este es un booleano que determina si el rol hará una copia de seguridad única de la configuración - por ejemplo, cp /etc/postfix/main.cf /etc/postfix/main.cf.backup, sobrescribiendo la copia de seguridad anterior, si la hay. El valor por defecto es false. NOTA: Si desea establecer esto en true, también debe establecer postfix_backup_multiple: false - consulte a continuación.

postfix_backup_multiple

postfix_backup_multiple: false

Este es un booleano que determina si el rol hará una copia de seguridad con sello de tiempo de la configuración - por ejemplo, cp /etc/postfix/main.cf /etc/postfix/main.cf.$(date -Isec), manteniendo así varias copias de seguridad. El valor por defecto es true. NOTA: Esta configuración anula postfix_backup, por lo que debe establecer esto en false si desea usar postfix_backup.

postfix_manage_firewall

Bandera booleana que permite configurar el firewall usando el rol de firewall. Gestiona los puertos relacionados con smtp: 25/tcp, 465/tcp y 587/tcp. Si la variable se establece en false, el rol postfix no gestiona el firewall. Por defecto es false.

NOTA: postfix_manage_firewall está limitado a agregar puertos. No se puede utilizar para eliminar puertos. Si desea eliminar puertos, deberá usar el rol de sistema de firewall directamente.

NOTA: la gestión del firewall no es compatible en RHEL 6.

postfix_manage_selinux

Bandera booleana que permite configurar selinux usando el rol de selinux. Asigna smtp_port_t a los puertos relacionados con smtp. Si la variable se establece en false, el rol postfix no gestiona selinux.

NOTA: postfix_manage_selinux está limitado a agregar políticas. No se puede utilizar para eliminar políticas. Si desea eliminar políticas, deberá usar el rol de sistema de selinux directamente.

Limitaciones

No hay forma de eliminar parámetros de configuración separados. Como solución, puede usar postfix_conf con previous: replaced para eliminar la configuración existente y luego aplicar la configuración deseada sobre una instalación limpia de postfix. Para más información, consulte postfix_conf.

Ejemplo de Playbook

Instalar y habilitar postfix. Configurar relay_domains=$mydestination y relayhost=example.com.

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

Instalar y habilitar postfix. No ejecutar 'postfix check' antes de reiniciar postfix:

---
- name: Gestionar postfix sin verificación
  hosts: all
  vars:
    postfix_check: false
  roles:
    - linux-system-roles.postfix

Instalar y habilitar postfix. Hacer una copia de seguridad única de main.cf (la copia de seguridad anterior será reescrita) y configurar relayhost=example.com:

---
- name: Gestionar postfix con relayhost
  hosts: all
  vars:
    postfix_conf:
      relayhost: example.com
    postfix_backup: true
  roles:
    - linux-system-roles.postfix

Instalar y habilitar postfix. Hacer una copia de seguridad con sello de tiempo de main.cf y configurar relayhost=example.com (si postfix_backup_multiple se establece en verdadero, se ignora postfix_backup):

---
- name: Gestionar postfix con múltiples copias de seguridad
  hosts: all
  vars:
    postfix_conf:
      relayhost: example.com
    postfix_backup_multiple: true
  roles:
    - linux-system-roles.postfix

rpm-ostree

Consulte README-ostree.md

Licencia

Copyright (C) 2017 Jaroslav Škarvada jskarvad@redhat.com

Este programa es software libre: puede redistribuirlo y/o modificarlo bajo los términos de la Licencia Pública General de GNU tal como la publicó la Fundación de Software Libre, ya sea la versión 3 de la Licencia o (a su opción) cualquier versión posterior.

Este programa se distribuye con la esperanza de que sea útil, pero SIN NINGUNA GARANTÍA; sin siquiera la garantía implícita de COMERCIABILIDAD o ADECUACIÓN PARA UN PROPÓSITO PARTICULAR. Consulte la Licencia Pública General de GNU para más detalles.

Debería haber recibido una copia de la Licencia Pública General de GNU junto con este programa. Si no, consulte http://www.gnu.org/licenses/.

Instalar
ansible-galaxy install linux-system-roles.postfix
Licencia
gpl-3.0
Descargas
122.5k
Propietario