ansible-postfix-aws

Роль Ansible для установки Postfix и его настройки для отправки электронных писем через сервис Amazon SES.

Эта роль основывается на официальной документации Amazon для SES_ с некоторыми изменениями, обеспечивающими идемпотентность.

.. _документация Amazon для SES: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/postfix.html

Требования

В настоящее время роль поддерживает только дистрибутивы CentOS, Red Hat Enterprise Linux (RHEL) EL7 и Ubuntu_ 18.04 LTS.

Если вам нужна поддержка других дистрибутивов, не стесняйтесь отправить запрос на изменение_.

Для использования этой роли вам необходимо иметь аккаунт Amazon AWS_ (следуйте онлайн-инструкциям для его создания) и пользователя IAM для SMTP аутентификации с SES. Чтобы его создать, следуйте онлайн-инструкциям на странице Получение SMTP учетных данных_. Обратите внимание, что полученное имя пользователя и пароль SMTP не совпадают с идентификатором доступа и секретным ключом пользователя IAM.

Чтобы роль работала корректно, email-адрес "отправителя" должен быть подтвержден в SES. Если ваш аккаунт все еще находится в песочнице, все email-адреса "получателей" также должны быть подтверждены. Для получения дополнительной информации ознакомьтесь с инструкциями Amazon по подтверждению email-адресов_.

.. _CentOS: https://www.centos.org/

.. _Red Hat Enterprise Linux (RHEL): https://www.redhat.com/en/technologies/linux-platforms/enterprise-linux

.. _Ubuntu: https://ubuntu.com/

.. _отправить запрос на изменение: https://github.com/dblenkus/ansible-postfix/aws/pull/new/master

.. _аккаунт Amazon AWS: https://aws.amazon.com/

.. _Получение SMTP учетных данных: https://docs.aws.amazon.com/ses/latest/DeveloperGuide/smtp-credentials.html

.. _инструкции Amazon по подтверждению email-адресов: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-email-addresses.html

Переменные роли

+---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | Название | Тип | Описание | Обязательно| По умолчанию | +=======================================+==========+===========================================+===========+=========================================================================+ | postfix_aws_ses_host | строка | Имя хоста сервера Amazon SES. | нет | email-smtp.eu-west-1.amazonaws.com | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_port | целое число | Порт сервера Amazon SES. | нет | 25 | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_username | строка | Имя пользователя для SMTP аутентификации | да | | | | | с сервером Amazon SES. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_password | строка | Пароль для SMTP аутентификации с | да | | | | | сервером Amazon SES. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_default_from_email | строка | Адрес электронной почты "отправителя" по умолчанию. | да | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_sender_canonical_maps | список | Список канонических соответствий для адресов отправителя в конверте и заголовке: | нет | .. code-block:: yaml | | | | | | | | | | | | pattern: "/.+/" | | | | .. code-block:: yaml | | address: "{{ postfix_aws_default_from_email }}" | | | | | | comment: Привязать все адреса отправителей к адресу "отправителя" | | | | pattern: строка | | | | | | address: строка | | | | | | comment: строка | | | | | | | | | | | | где pattern — это регулярное выражение, | | | | | | соответствующее оригинальному адресу | | | | | | отправителя и address — это адрес | | | | | | для замены оригинального. | | | | | | Для получения дополнительной информации см. руководство Postfix по | | | | | | postconf.5_. | | | | | | comment — это необязательный текст для | | | | | | комментария в файле /etc/postfix/sender_canonical. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+

.. _руководство Postfix по postconf.5: http://www.postfix.org/postconf.5.html#sender_canonical_maps

Зависимости

Нет зависимостей.

Пример плейбука

Чтобы использовать эту роль, добавьте это в ваш плейбук:

.. code-block:: yaml

- hosts: servers
  become: true
  roles:
     - { role: dblenkus.postfix-aws }

Лицензия

Лицензировано под лицензией GPLv3. См. файл COPYING для подробностей.

Информация об авторах

| Domen Blenkuš | Tadej Janež