Веб-приложение для администрирования Pilot. Управляет выкладкой автоматизаций, отчётов, модулей и типов по контурам. Сервис PilotMigration переносит базы и файловые архивы.
Документация · Быстрый старт · Скачать релиз
Подключите существующие Pilot, GitLab, PostgreSQL и S3 или разверните стенд из установочного комплекта. Рядом лежат шаблоны CI и исходники клиентских и серверных расширений.
Обычный путь изменения: ветка в GitLab / проверки CI / тест / стейдж / прод. Он зависит от вида содержимого и настроек: у отчётов стейджа по умолчанию нет, у автоматизаций тест и стейдж можно объединить, а если адрес стейджа не задан, перенос идёт из dev в прод. Запись на серверы Pilot идёт через веб-админку (выкладка из CI подтверждается токеном задания и ключом контура), статистика и логи собираются в Grafana.
- Git-хостинг. Полный CI/CD работает с GitLab. GitHub.com поддерживает публикацию типов на тест. Матрица Git-хостингов.
- Pilot-Server. Админка подключается к существующему монолиту или кластеру. Основной установщик разворачивает монолит. Для кластера на разных машинах предусмотрен отдельный комплект Compose. Варианты развёртывания.
Папка stack/Install передаётся на сервер целиком. Инструкции опубликованы на сайте и доступны там для скачивания в PDF.
| Документ | Для кого |
|---|---|
| Установка стенда | администратор, устанавливающий стенд на одну или несколько машин |
| Безопасность | служба ИБ |
| GitLab без интернета | администратор GitLab и разработчики в закрытом контуре |
Заполняет папку перед передачей скрипт stack/build/build.ps1, заказчику он не нужен. В git лежат скрипты, compose и документы; каталоги images/, data/, monitoring/, modules/, файлы IMAGES.txt и PASSWORDS.md заполняет сборка, в git они не попадают, поэтому установить стенд из чистого клона без собранного комплекта нельзя. Для закрытого контура нужен комплект без интернета (ключ -Offline у сборки).
stack/ - контуры и инфраструктура
Здесь Docker Compose и скрипты; исходники .NET есть только у сборщика статистики отчётов и модулей (metrics/report-collector, решение ReportMetrics.Collector.sln с тестами), у сборщика автоматизаций исходники на Python.
| Папка | Что делает |
|---|---|
prod/, test/, stage/ |
Контуры Pilot: Pilot-Server, PostgreSQL и RustFS (S3-хранилище файлов), на проде ещё Pilot-myAdmin Web (в Install для test и stage он ставится ключом -WithMyAdmin) |
metrics/ |
Мониторинг: Prometheus, Loki, Grafana и сервисы статистики автоматизаций и отчётов |
backup/ |
Ежедневные резервные копии в D:\Backups, проверка и восстановление |
Install/ |
Установочный комплект для другого сервера |
shared/ |
Запуск всего стека и смена паролей контуров |
proadmin/ - веб-админка и миграция
| Решение | Что делает |
|---|---|
PilotProAdmin.sln |
Веб-админка (:5300). Через неё автоматизации, отчёты, клиентские и серверные модули, типы и настройки серверов проходят путь от веток GitLab до серверов Pilot |
migration/PilotMigration.sln |
Сервис миграции (:5320, по умолчанию только на 127.0.0.1): перенос данных между контурами, импорт присланных файловых баз и выгрузка в файлы |
gitlab/ - GitLab и CI
GitLab и Runner в Docker. Папка ci-checks/ содержит общие проверки автоматизаций и отчётов, которые запускаются в CI этих репозиториев. Решений .NET здесь нет.
client-modules/ - модули клиента Pilot
| Решение | Что делает |
|---|---|
Pilot.ClientSdk/Pilot.ClientSdk.sln |
Общий клиентский модуль и NuGet-пакет: статистика модулей в Grafana и общие функции |
Test-module/TestModule.sln |
Тестовый модуль для проверки CI/CD и ошибок в Grafana |
Папка ci-template/ содержит шаблон CI для репозитория клиентского модуля.
Reports/ - модуль отчётов
Клиентский модуль: проект Reports.csproj и решение Reports.sln (проект плюс тесты). Даёт скриптам отчётов общие функции и доступ к Pilot SDK, считает статистику построений и отправляет отчёты в GitLab при сохранении.
server-extensions/ - модули Pilot-Server
| Решение | Что делает |
|---|---|
ServerHost/ServerHost.sln |
Загрузчик серверных модулей и его тесты: ставится в Pilot один раз, остальные модули обновляет без перезапуска сервера |
Debug/Debug.sln |
Утилита для запуска серверного модуля под отладчиком на машине разработчика, на реальных данных |
TestServerAction/TestServerAction.sln |
Пример обычного серверного модуля, образец для новых |
Папка ci-template/ содержит шаблон CI для репозитория серверного модуля.
.\stack\shared\stack.ps1 up|down|ps|build [prod|test|stage|admin|metrics]Цель admin в stack.ps1 включает и GitLab, и админку с миграцией (down admin остановит оба). В stack/Install роль admin - только админка и миграция, GitLab ставится отдельной ролью gitlab.
В GitLab стенда модули ведутся отдельными проектами. Вложенные .gitlab-ci.yml повторяют шаблоны из папок ci-template.
