Back to Argo Cd

Email

docs/operator-manual/notifications/services/email.md

3.4.01.9 KB
Original Source

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:

yaml
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:

yaml
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:

yaml
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 .