mail - Отправка электронного письма

• Обзор
• Параметры
• Примеры
• Статус
• Техническое обслуживание
  • Автор

Обзор

• Этот модуль полезен для отправки электронных писем из плейбуков.
• Можно задаться вопросом, зачем автоматизировать отправку электронных писем? В сложных средах иногда встречаются процессы, которые невозможно автоматизировать, либо из-за отсутствия полномочий, либо из-за того, что не все согласны с общим подходом.
• Если конкретный шаг нельзя автоматизировать, но он не блокирующий, отправка электронного письма уполномоченному лицу для выполнения его части соглашения — элегантный способ переложить ответственность на кого-то другого.
• Конечно, отправка письма может быть так же полезна, как способ уведомить одного или нескольких человек в команде о том, что определенное действие было (успешно) выполнено.

Параметры

Примеры

- name: Example playbook sending mail to root
  mail:
    subject: System {{ ansible_hostname }} has been successfully provisioned.
  delegate_to: localhost

- name: Sending an e-mail using Gmail SMTP servers
  mail:
    host: smtp.gmail.com
    port: 587
    username: username@gmail.com
    password: mysecret
    to: John Smith <john.smith@example.com>
    subject: Ansible-report
    body: System {{ ansible_hostname }} has been successfully provisioned.
  delegate_to: localhost

- name: Send e-mail to a bunch of users, attaching files
  mail:
    host: 127.0.0.1
    port: 2025
    subject: Ansible-report
    body: Hello, this is an e-mail. I hope you like it ;-)
    from: jane@example.net (Jane Jolie)
    to:
    - John Doe <j.d@example.org>
    - Suzie Something <sue@example.com>
    cc: Charlie Root <root@localhost>
    attach:
    - /etc/group
    - /tmp/avatar2.png
    headers:
    - Reply-To=john@example.com
    - X-Special="Something or other"
    charset: us-ascii
  delegate_to: localhost

- name: Sending an e-mail using the remote machine, not the Ansible controller node
  mail:
    host: localhost
    port: 25
    to: John Smith <john.smith@example.com>
    subject: Ansible-report
    body: System {{ ansible_hostname }} has been successfully provisioned.

- name: Sending an e-mail using Legacy SSL to the remote machine
  mail:
    host: localhost
    port: 25
    to: John Smith <john.smith@example.com>
    subject: Ansible-report
    body: System {{ ansible_hostname }} has been successfully provisioned.
    secure: always

- name: Sending an e-mail using StartTLS to the remote machine
  mail:
    host: localhost
    port: 25
    to: John Smith <john.smith@example.com>
    subject: Ansible-report
    body: System {{ ansible_hostname }} has been successfully provisioned.
    secure: starttls

Статус

Этот модуль помечен как stableinterface, что означает, что авторы этого модуля гарантируют, что не будут вноситься несовместимые изменения в интерфейс.

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в Техническое обслуживание модулей и поддержка.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

• Dag Wieers (@dagwieers)