Email¶

Parameters¶

The Email notification service sends email notifications using SMTP protocol and requires specifying the following settings:

host - the SMTP server host name
port - the SMTP server port
username - username
password - password
from - from email address
html - optional bool, true or false
insecure_skip_verify - optional bool, true or false

Using Gmail¶

When configuring Gmail as the SMTP service:

username - Must be your Gmail address.
password - Use an App Password, not your regular Gmail password.

To Generate an app password, follow this link https://myaccount.google.com/apppasswords

Note

This applies to personal Gmail accounts (non-Google Workspace). For Google Workspace users, SMTP settings and authentication methods may differ.

Example¶

The following snippet contains sample Gmail service configuration:

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
data:
  service.email.gmail: |
    username: $username
    password: $password
    host: smtp.gmail.com
    port: 465
    from: $email-address

Without authentication:

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
data:
  service.email.example: |
    host: smtp.example.com
    port: 587
    from: $email-address

Template¶

Notification templates support specifying subject for email notifications:

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
data:
  template.app-sync-succeeded: |
    email:
      subject: Application {{.app.metadata.name}} has been successfully synced.
    message: |
      {{if eq .serviceType "slack"}}:white_check_mark:{{end}} Application {{.app.metadata.name}} has been successfully synced at {{.app.status.operationState.finishedAt}}.
      Sync operation details are available at: {{.context.argocdUrl}}/applications/{{.app.metadata.name}}?operation=true .