linux-system-roles.postfix
postfix
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/.
ansible-galaxy install linux-system-roles.postfix