Настройка подключения микросервиса ecos-notifications

Для отправки писем пользователям необходимо настроить подключение микросервиса ecos-notifications к SMTP-серверу.

Эти параметры задаются в конфигурации сервиса (spring properties) и обычно настраиваются не через интерфейс, а при развертывании приложения: например, через application.yml, переменные окружения, Docker Compose, Helm chart или другой способ конфигурации.

Ниже пример настройки для mail.ru.

spring:
  mail:
    host: smtp.mail.ru
    port: 587
    username: user@mail.ru
    password: 12345
    properties:
      mail:
        smtp:
          auth: true
          starttls:
            enable: true

ecos-notifications:
  email:
    from:
      fixed: user@mail.ru

SPRING_MAIL_HOST=smtp.mail.ru
SPRING_MAIL_PORT=587
SPRING_MAIL_USERNAME=user@mail.ru
SPRING_MAIL_PASSWORD=12345
SPRING_MAIL_PROPERTIES_MAIL_SMTP_AUTH=true
SPRING_MAIL_PROPERTIES_MAIL_SMTP_STARTTLS_ENABLE=true
ECOS_NOTIFICATIONS_EMAIL_FROM_FIXED=user@mail.ru

Параметры, влияющие на повторные отправки

Помимо параметров подключения, поведение микросервиса при сбоях отправки задаётся блоком ecos-notifications.retry — см. повторные попытки отправки.

Значения по умолчанию рассчитаны на типовой сценарий, менять их обычно не требуется.

Предупреждение

Следующие SMTP-параметры важны для корректной работы повторов — переопределять их значения по умолчанию не рекомендуется:

spring:
  mail:
    properties:
      mail:
        smtp:
          connectiontimeout: 10000
          timeout: 10000
          writetimeout: 10000
          sendpartial: true

Параметр

Описание

connectiontimeout, timeout, writetimeout

Таймауты обязательно должны быть конечными: иначе зависшее соединение заблокирует уведомление на всё время ожидания ответа сервера.

sendpartial

Доставлять письмо принявшим его получателям вместо отмены отправки целиком, если часть адресов отклонена сервером.