Email report

Overview

email-report renders a named sitegen report and sends it through Azure Communication Services Email.

Example configuration

sitegen: /etc/site.yaml               # Required: example sitegen config path.
report: daily                        # Required: name in its reports map.
endpoint_env: ACS_EMAIL_ENDPOINT      # Required: name of the endpoint variable.
access_key_env: ACS_EMAIL_ACCESS_KEY  # Required: name of the secret variable.
recipient_env: REPORT_RECIPIENT       # Required: name of the recipient variable.
sender: reports@example.invalid      # Required: replace with an authorized sender.
subject: Daily report                # Required: example subject.
reply_to: null                       # Default: no Reply-To override.
timeout: 300s                        # Effective default when omitted or null.

Use and behavior

Install with pond mknod email-report /etc/email --config-path email.yaml, then run pond run /etc/email -- send.

The _env fields are environment variable names, not ${env:NAME} substitutions. Missing or empty values fail. A configured service, authorized sender and recipient, and an existing sitegen report are required. Retrying can send duplicate email.

Full configuration

Settings

FieldAccepted typeRequiredDefaultDescription
access_key_envstringyesnot specified
endpoint_envstringyesnot specified
recipient_envstringyesnot specified
reply_tostring | nullnonull
reportstringyesnot specified
senderstringyesnot specified
sitegenstringyesnot specified
subjectstringyesnot specified
timeoutstring | nullnonull