@runnerty/executor-mail
v3.1.4
Published
Runnerty module: Mail executor
Downloads
44
Readme
Mail executor for Runnerty:
Email notification module with ejs template support.
Installation:
npm i @runnerty/executor-mailYou can also add modules to your project with runnerty
npx runnerty add @runnerty/executor-mailThis command installs the module in your project, adds example configuration in your config.json and creates an example plan of use.
If you have installed runnerty globally you can include the module with this command:
runnerty add @runnerty/executor-mailConfiguration samples:
Add in config.json:
{
"id": "mail_default",
"type": "@runnerty-executor-mail",
"disable": false,
"from": "Runnerty Notificator <[email protected]>",
"transport": "smtp://my%mailsender.com:[email protected]/?pool=true",
"bcc": ["[email protected]"],
"templateDir": "/etc/runnerty/templates",
"template": "alerts",
"ejsRender": true
}{
"id": "mail_aws_ses_iam_smtp",
"type": "@runnerty-executor-mail",
"disable": false,
"from": "Runnerty <[email protected]>",
"transport": {
"host": "email-smtp.eu-west-1.amazonaws.com",
"port": 465,
"secure": true,
"auth": {
"user": "aws_ses_user",
"pass": "aws_ses_pass"
}
},
"templateDir": "/etc/runnerty/templates",
"template": "alerts",
"ejsRender": true
}To use AWS SES transport:
{
"id": "mail_aws_ses_role",
"type": "@runnerty-executor-mail",
"from": "Runnerty <[email protected]>",
"transport": {
"service": "SES",
"region": "us-east-1",
"ses": {
// optional extra arguments for SendRawEmail
"Tags": [
{
"Name": "tag_name",
"Value": "tag_value"
}
]
}
},
"templateDir": "/etc/runnerty/templates",
"template": "alerts",
"ejsRender": true
}Plan sample:
Add in plan.json:
{
"id": "mail_default",
"to": ["[email protected]"],
"title": "Runnerty Mailer",
"message": "My message from Runnerty!",
"attachments": [
{
"filename": "sample.png",
"path": "/etc/runnerty/templates/alerts/images/sample.png",
"cid": "[email protected]"
}
]
}EJS Template sample:
Plan:
{
"id": "mail_default",
"to": ["[email protected]"],
"title": "Runnerty Mailer",
"message": "My message from Runnerty!",
"args": { "value_one": "Hello", "value_two": "world!", "value_three": ":YYYY" }
}HTML Template:
<html>
<head>
<title><%= value_one %> <%= value_two %></title>
</head>
<body>
<%= value_three %>
</body>
</html>Want to help?
Want to file a bug, contribute some code, or improve documentation? Excellent! Read up on our guidelines for contributing.