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

• Описание
• Параметры
• Примеры
  • Статус

Описание

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

Параметры

Примеры

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

# 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

# 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/pavatar2.png
    headers: 'Reply-To=john@example.com|X-Special="Something or other"'
    charset: utf8
  delegate_to: localhost

# 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.'

# 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

 # 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, что означает, что разработчики этого модуля гарантируют, что не будут вноситься обратные изменения в интерфейс.

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