СервисПульс

СервисПульс

ServicePulse обеспечивает производственный мониторинг распределенных приложений в реальном времени. Он контролирует состояние конечных точек системы, обнаруживает ошибки обработки, отправляет сообщения об ошибках на повторную обработку и обеспечивает удовлетворение потребностей конкретной среды — и все это на одной консолидированной информационной панели.

ServicePulse является частью специальной сервисной платформы, которая включает NServiceBus и инструменты для создания, мониторинга и отладки распределенных систем.

Дополнительную информацию см. в документации ServicePulse.

Настройка проекта на разработку

Настройка экземпляров ServiceControl Main и ServiceControl Monitoring

ServicePulse в основном представляет данные, предоставленные экземплярами ServiceControl и ServiceControl Monitoring.

URL-адреса для обеих служб можно установить в src/Frontend/public/js/app.constants.js .

Настройка менеджеров пакетов

ServicePulse использует npm и Bower в качестве менеджеров пакетов. Чтобы решение работало, перед запуском сайта ServicePulse необходимо загрузить зависимости.

Установить зависимости

Установите следующие зависимости, если они еще не установлены.

• Git для Windows
• Node.js
  • ПРИМЕЧАНИЕ. При установке или обновлении node.js в локальной среде рекомендуется также проверить и убедиться, что версия node.js для рабочих процессов ci.yml и release.yml соответствует версии вашей локальной среды. Найдите name: Set up Node.js

Установить среду разработки

Шаг 0. Использование подходящей IDE для разработки внешнего интерфейса.

Несмотря на то, что Visual Studio или Rider кажутся подходящими IDE для фронтенд-разработки, они, как правило, ненадежны при работе с новейшими интерфейсными платформами, линтингом и форматированием. Поэтому у нас есть дополнительные рекомендации, которые помогут вам добиться еще большего успеха во фронтенд-разработке.

Шаг 1. Запустите сервер разработки Vue.js.

Перейдите в ServicePulsesrcFrontend и:

• запустите npm install чтобы установить все зависимости npm
• выполните следующую команду: npm run dev (при этом сервер разработки будет размещен на порту 5173 и начнет отслеживать изменения в каталоге /Frontend )

Если npm run dev завершается сбоем из-за ошибки, связанной с неправильной настройкой подмодулей git, снова запустите команду npm install , чтобы убедиться, что все необходимые зависимости доступны, а затем запустите npm run dev .

Шаг 2 – откройте браузер

После выполнения вышеуказанных шагов перейдите по URL-адресу, представленному при выполнении приложения Vue.js, чтобы увидеть приложение ServicePulse.

Запуск автоматических тестов

Автоматизированные тесты внешнего интерфейса используют Vitest в качестве среды тестирования и библиотеки тестирования для тестирования утилит. Vitest предоставляет два режима: watch mode в среде разработки и run mode в среде CI по умолчанию. Watch mode мгновенно повторно запускает соответствующие тесты при сохранении файла, обеспечивая немедленную обратную связь во время разработки.

Перед запуском теста убедитесь, что вы настроили сервер разработки. Перейдите в ServicePulsesrcFrontend и запустите npm install чтобы установить все зависимости npm.

Запуск тестов компонентов

Перейдите в ServicePulsesrcFrontend и запустите:

 npm run test:component

Эта команда запускает все файлы тестирования компонентов *.spcs.ts в каталоге ServicePulsesrcFrontendsrc и его подкаталогах. Включенный watch mode позволяет эффективно разрабатывать тесты, поскольку при сохранении файла повторно запускаются только соответствующие тесты.

Запуск тестов приложения

Перейдите в ServicePulsesrcFrontend и запустите:

 npm run test:application

Подобно тестам компонентов, эта команда запускает все файлы тестов приложения *.spcs.ts в каталоге ServicePulsesrcFrontendtest и его подкаталогах.

Запуск тестового покрытия

Перейдите в ServicePulsesrcFrontend и запустите:

 npm run test:coverage

Эта команда генерирует отчет, указывающий процент операторов, ветвей, функций и строк, охваченных тестами. Кроме того, он идентифицирует непокрытые номера строк.

Предоставлены скрипты npm

Vue.js

• dev — запускает vite , который запускает сервер разработки и выполняет горячую перезагрузку исходных файлов.
• build — запускает скрипт сборки, который выводит файлы в папку ..app
• lint — проверяет с помощью eslint все файлы vue, ts и js.
• type-check — запускает TypeScript в режиме без генерации

Витест

• test:application — запускает все тесты приложения, расположенные в папке Frontend/test .
• test:component — запускает тесты всех компонентов, расположенных в папке Frontend/src и любых подкаталогах.
• test:coverage — запускает отчет о тестовом покрытии для файлов, определенных в vitest.config.ts

Запуск из ServicePulse.Host.exe

ServicePulse можно запустить напрямую через ServicePulse.Host.exe .

Шаг 1. Зарезервируйте список управления доступом для URL-адресов.

ServicePulse.Host.exe зависит от локального веб-сервера. Прежде чем проект сможет запуститься, необходимо настроить резервирование URL-адресов ACL. Либо запустите Visual Studio с правами администратора, либо выполните следующую команду, чтобы добавить необходимое резервирование URL-адресов ACL:

add urlacl url=URL

Где URL — это настроенный URL-адрес на локальном компьютере.

Шаг 2. Создайте сайт ServicePulse

Запустите скрипт сборки из командной строки:

 PowerShell -File .build.ps1

Примечание

Возможно, потребуется изменить политику выполнения PowerShell с помощью Set-ExecutionPolicy Unrestricted -scope UserPolicy

Шаг 3 — запустите ServicePulse.Host.exe

Создайте и запустите проект ServicePulse.Host в IDE.

Поддерживаемые версии браузера

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

• Последняя основная версия Chrome
• Edge с EdgeHTML v17+
• Текущая версия Firefox ESR
• Последняя основная версия Safari

Разработка образа контейнера

Dockerfile для ServicePulse находится в папке src/ServicePulse . Все образы контейнеров создаются в рамках рабочего процесса выпуска и помещаются в реестр контейнеров Github. Для филиалов с PR изображение будет помечено номером PR, например pr-1234 .