dblenkus.postfix-aws
ansible-postfix-aws
Postfixをインストールし、Amazon SESサービスを通じてメールを送信するために設定するAnsibleロールです。
このロールは、冪等性を確保するために一部変更を加えつつ、公式の『Amazone documentation for SES』に従っています。
要件
現在、このロールはCentOS
、Red Hat Enterprise Linux (RHEL)
EL7、およびUbuntu
18.04 LTSのディストリビューションのみをサポートしています。
他のディストリビューションのサポートが必要な場合は、プルリクエストを送信してください
。
このロールを使用するには、Amazon AWSアカウント
が必要です(作成するにはオンラインの指示に従ってください)と、SES用のSMTP認証のためのIAMユーザーが必要です。作成手順はSMTP資格情報の取得
をオンラインで確認してください。取得したSMTPユーザー名とパスワードは、IAMユーザーのアクセスキーIDやシークレットアクセスキーとは異なることに注意してください。
ロールが正しく機能するためには、「From」のメールアドレスがSESで確認されている必要があります。もしアカウントがサンドボックスモードのままの場合、「To」メールもすべて確認されている必要があります。詳細は、メールアドレスの確認に関するAmazonの指示
を確認してください。
ロールの変数
+---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+
| 名称 | タイプ | 説明 | 必須 | デフォルト |
+=======================================+==========+===========================================+===========+=========================================================================+
| postfix_aws_ses_host
| 文字列 | Amazon SESサーバーのホスト名。 | いいえ | email-smtp.eu-west-1.amazonaws.com
|
+---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+
| postfix_aws_ses_port
| 整数 | Amazon SESサーバーのポート。 | いいえ | 25
|
+---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+
| postfix_aws_ses_username
| 文字列 | Amazon SESサーバーのSMTP認証用ユーザー名。| はい | |
+---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+
| postfix_aws_ses_password
| 文字列 | Amazon SESサーバーのSMTP認証用パスワード。| はい | |
+---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+
| postfix_aws_default_from_email
| 文字列 | デフォルトのFromメールアドレス。 | はい | |
+---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+
| postfix_aws_sender_canonical_maps
| リスト | 封筒およびヘッダー送信者アドレスの正規化マッピングのリスト。 | いいえ | .. code-block:: yaml |
| | | | | |
| | | | | pattern: "/.+/" |
| | | .. code-block:: yaml | | address: "{{ postfix_aws_default_from_email }}" |
| | | | | comment: デフォルトのFromメールアドレスにすべての送信者アドレスをマップ |
| | | pattern: 文字列 | | |
| | | address: 文字列 | | |
| | | comment: 文字列 | | |
| | | | | |
| | | pattern
は元の送信者アドレスにマッチする正規表現を表します。 | | |
| | | address
は元のアドレスを置き換える送信者アドレスを表します。 | | |
| | | 詳細はPostfixのpostconf.5マニュアルページ
を参照してください。 | | |
| | | comment
は/etc/postfix/sender_canonical
ファイルにコメントとして追加するオプションのテキストを表します。| | |
+---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+
依存関係
依存関係なし。
例プレイブック
このロールを使用するには、次のようにプレイブックに追加します:
.. code-block:: yaml
- hosts: servers
become: true
roles:
- { role: dblenkus.postfix-aws }
ライセンス
GPLv3ライセンスの下でライセンスされています。詳細はCOPYINGファイルを参照してください。
著者情報
| Domen Blenkuš | Tadej Janež