ansible-postfix-aws

Rola Ansible do instalacji Postfix i skonfigurowania go do wysyłania e-maili za pośrednictwem usługi Amazon SES.

Ta rola opiera się na oficjalnej dokumentacji Amazona dla SES_ z pewnymi modyfikacjami, aby zapewnić idempotencję.

.. _dokumentacja Amazona dla SES: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/postfix.html

Wymagania

Obecnie rola obsługuje tylko dystrybucje CentOS, Red Hat Enterprise Linux (RHEL) EL7 i Ubuntu_ 18.04 LTS.

Jeśli potrzebujesz wsparcia dla innych dystrybucji, poczuj się swobodnie, aby zgłosić zapytanie_.

Aby używać tej roli, musisz mieć konto Amazon AWS_ (aby je utworzyć, postępuj zgodnie z instrukcjami dostępnymi online) oraz użytkownika IAM do autoryzacji SMTP z SES. Aby go utworzyć, postępuj zgodnie z instrukcjami online dotyczącymi Pozyskiwania poświadczeń SMTP_. Należy zauważyć, że uzyskana nazwa użytkownika i hasło SMTP nie są tymi samymi danymi co klucz dostępu i klucz tajny użytkownika IAM.

Aby rola działała poprawnie, adres e-mail "od" musi być zweryfikowany w SES. Jeśli Twoje konto jest nadal w trybie testowym, wszystkie adresy e-mail "do" również muszą być zweryfikowane. Więcej informacji znajdziesz w instrukcjach Amazona dotyczących weryfikacji adresów e-mail_.

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

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

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

.. _zgłosić zapytanie: https://github.com/dblenkus/ansible-postfix/aws/pull/new/master

.. _konto Amazon AWS: https://aws.amazon.com/

.. _Pozyskiwanie poświadczeń SMTP: https://docs.aws.amazon.com/ses/latest/DeveloperGuide/smtp-credentials.html

.. _instrukcje Amazona dotyczące weryfikacji adresów e-mail: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-email-addresses.html

Zmienne roli

+---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | Nazwa | Typ | Opis | Obowiązkowa | Domyślna | +=======================================+==========+===========================================+===========+=========================================================================+ | postfix_aws_ses_host | string | Nazwa hosta serwera Amazon SES. | nie | email-smtp.eu-west-1.amazonaws.com | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_port | integer | Port serwera Amazon SES. | nie | 25 | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_username | string | Nazwa użytkownika do autoryzacji SMTP z | tak | | | | | serwerem Amazon SES. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_password | string | Hasło do autoryzacji SMTP z serwerem | tak | | | | | Amazon SES. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_default_from_email | string | Domyślny adres e-mail "od". | tak | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_sender_canonical_maps | lista | Lista mapowań kanonicznych dla adresów | nie | .. code-block:: yaml | | | | nadawcy w formie: | | | | | | | | wzorzec: "/.+/" | | | | .. code-block:: yaml | | adres: "{{ postfix_aws_default_from_email }}" | | | | | | komentarz: Mapuj wszystkie adresy nadawców do domyślnego adresu | | | | wzorzec: string | | | | | | adres: string | | | | | | komentarz: string | | | | | | | | | | | | gdzie wzorzec reprezentuje wyrażenie | | | | | | regularne, które pasuje do oryginalnego | | | | | | adresu nadawcy, a adres reprezentuje | | | | | | adres nadawcy, którym należy zastąpić | | | | | | oryginalny. | | | | | | Więcej informacji znajdziesz w podręczniku | | | | | | postconf.5 Postfixa_. | | | | | | komentarz to opcjonalny tekst do | | | | | | umieszczenia jako komentarz w pliku | | | | | | /etc/postfix/sender_canonical. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+

.. _podręcznik postconf.5 Postfixa: http://www.postfix.org/postconf.5.html#sender_canonical_maps

Zależności

Brak zależności.

Przykład playbooka

Aby użyć tej roli, dodaj to do swojego playbooka:

.. code-block:: yaml

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

Licencja

Licencjonowane na warunkach licencji GPLv3. Szczegóły w pliku COPYING.

Informacje o autorze

| Domen Blenkuš | Tadej Janež