Настройка SMTP-сервера и настройка электронной почты для оповещений и запросов отзывов

Azure DevOps Server 2022 | Azure DevOps Server 2020 | | Azure DevOps Server 2019 г. TFS 2018

Чтобы запросы на отзывы и оповещения работали, необходимо настроить SMTP-сервер для Azure DevOps Server, ранее названный Visual Studio Team Foundation Server (TFS). SMTP-сервер поддерживает следующие функции:

Предварительные требования

  • Для выполнения этих процедур необходимо быть членом группы безопасности "Администраторы" на сервере уровня приложений Azure DevOps.

Настройка SMTP-сервера

  1. Если вы не администратор Azure DevOps, добавьте его как один.

  2. Откройте консоль администрирования Azure DevOps Server в меню "Пуск". Или в командной строке введите TFSMgmt.exe. Дополнительные сведения см. в разделе "Открыть консоль администрирования".

  3. Выберите параметры оповещений.

    Открытие оповещений по электронной почте для уровня приложений

    Открытие оповещений по электронной почте для уровня приложений

  4. Включите оповещения по электронной почте и укажите сервер SMTP и адрес электронной почты, используемый для отправки почты.

    Включение и настройка SMTP-сервера

    Включение и настройка SMTP-сервера

    Если в развертывании настроено использование SSL, установите второй флажок и введите сертификат. См. также инструкции по настройке HTTPS с помощью протокола SSL.

    Совет

    • Убедитесь, что брандмауэр настроен, чтобы разрешить обмен данными между Azure DevOps и SMTP-сервером.
    • SMTP-сервер должен разрешать анонимным отправителям отправлять электронную почту; в противном случае необходимо предварительно создать учетную запись специально для использования в качестве учетной записи электронной почты для оповещений. Если указать учетную запись службы Azure DevOps (TFSService), эта учетная запись должна быть учетной записью домена с разрешением на отправку электронной почты.
    • Если вы использовали системную учетную запись (например, сетевую службу) в качестве учетной записи службы Azure DevOps, оставьте поля "Пользователь и пароль" пустыми для расширенной конфигурации и убедитесь, что SMTP-сервер настроен таким образом, чтобы разрешить анонимным пользователям отправлять почту. Другой вариант — указать в качестве учетной записи электронной почты для оповещений доменную учетную запись с поддержкой электронной почты. Если этого не сделать, уведомления по электронной почте отправляться не будут.
  5. Чтобы проверить конфигурацию, откройте личные уведомления. Если SMTP-сервер был включен только что, для того чтобы увидеть этот раздел может потребоваться обновить браузер.

    Открытие параметров личного уведомления

    Открытие отдельных оповещений

    Создайте оповещение, а затем выполните действие, которое активирует оповещение.

Настройка формата оповещений по электронной почте

Формат отправляемых по электронной почте уведомлений или оповещений, на которые подписываются члены команды, можно настраивать. Эти уведомления отправляются, когда в рабочих элементах, проверках кода, файлах системы управления версиями и сборках происходят изменения. Для настройки их формата достаточно внести изменения в соответствующие им файлы XSL-преобразования. Кроме того, участники команды могут настроить оповещения проекта в Team Web Access (TWA) для различных уведомлений и указать, нужны ли они HTML или обычный текст в качестве формата.

Файлы преобразования формата оповещений хранятся в следующей папке на сервере уровня приложений:

Диск:\%programfiles%\Azure DevOps Server 2019\Application Tier\TFSJobAgent\Transforms\1033

Диск:\%programfiles%\Team Foundation Server 2018\Application Tier\TFSJobAgent\Transforms\1033

Вы можете использовать редактор XML, например Visual Studio, для изменения любого из файлов преобразования. В следующей таблице приведены два файла преобразования, используемые при отправке по электронной почте уведомлений о событиях изменения рабочих элементов:

Файл преобразования Формат
WorkItemChangedEvent.xsl Электронная почта HTML
WorkItemChangedEvent.plaintextXsl электронная почта с открытым текстом

Служба событий использует XSL-файлы и файлы plaintextXsl для преобразования XML-данных для события в сообщение электронной почты. Отредактировав XSL-файл, можно получить другой формат отправляемого по электронной почте уведомления. Для сообщений электронной почты в формате HTML основной макет для всех событий хранится в файле TeamFoundation.xsl. Необходимо сделать резервные копии всех файлов, которые планируется изменить, а затем протестировать изменения. После внесения изменений при следующем создании уведомления для события TFS будет использовать обновленное преобразование.

Примечание

Содержимое сообщений электронной почты формируется автоматически по файлу TeamFoundation.xsl и упомянутым выше XSL-файлам WorkItemChangedEvent. Не рекомендуется изменять файл TeamFoundation.xsl. Если изменяется содержимое этого файла, необходимо тщательно протестировать изменения. Неправильное внесение изменений в этот файл может привести к сбою отправки оповещений TFS по электронной почте, а также к невозможности просмотра рабочих элементов, наборов изменений или файлов в веб-браузере.

Изменение формата оповещений об изменениях рабочего элемента

  1. На сервере уровня приложений откройте папку для используемой версии, например:

    Диск:\%programfiles%\Azure DevOps Server 2019\Application Tier\TFSJobAgent\Transforms\1033

    Диск:\%programfiles%\Team Foundation Server 2018\Application Tier\TFSJobAgent\Transforms\1033

  2. Откройте Файл WorkItemChangedEvent.xsl в Блокноте или другом текстовом редакторе.

  3. Отредактируйте файл, чтобы в уведомлении по электронной почте отображалось нужное сообщение.

    Примечание

    Аналогичные изменения следует внести в файл WorkItemChangedEvent.plaintextXsl для любых пользователей, запросивших сообщения в формате открытого текста.

  4. Сохраните файл WorkItemChangedEvent.xsl.