hybris/email-resource

Name: email-resource

Owner: hybris GmbH

Description: A Concourse resource that sends emails

Created: 2016-08-30 19:25:52.0

Updated: 2016-08-30 19:25:53.0

Pushed: 2016-08-31 02:11:40.0

Homepage:

Size: 314

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Email Resource

A Concourse resource that sends emails.

Getting started

Add the following Resource Type to your Concourse pipeline

urce_types:
name: email
type: docker-image
source:
  repository: pcfseceng/email-resource

Look at the demo pipeline for a complete example.

This resource acts as an SMTP client, using PLAIN auth over TLS. So you need an SMTP server that supports all that.

For development, we've been using Amazon SES with its SMTP support

Source Configuration

An example source configuration is below. None of the parameters are optional.

urces:
me: send-an-email
pe: email
urce:
smtp:
  host: smtp.example.com
  port: "587" # this must be a string
  username: a-user
  password: my-password
from: build-system@example.com

Note that port is a string. If you're using fly configure with the --load-vars-from (-l) substitutions, every {{ variable }} automatically gets converted to a string. But for literals you need to surround it with quotes.

Behavior

This is an output-only resource, so check and in actions are no-ops.

out: Send an email

Parameters

• headers: Optional. Path to plain text file containing additional mail headers
• subject: Required. Path to plain text file containing the subject
• body: Required. Path to file containing the email body.
• send_empty_body: Optional. If true, send the email even if the body is empty (defaults to false).
• to: Required. Recipients list
• cc: Optional. Recipients list
• bcc: Optional. Recipients list Note that to, cc and bcc are arrays

For example, a build plan might contain this:

put: send-an-email
params:
  to: [ "dev-team@example.com", "product@example.net" ]
  subject: demo-prep-sha-email/generated-subject
  body: demo-prep-sha-email/generated-body

HTML Email

To send HTML email set the headers parameter to a file containing the following:

-version: 1.0
ent-Type: text/html; charset="UTF-8"