GitManager
Что это и зачем?
Изначально была цель дать пользователю простой нитерфейс для работы с 1с по методологии Git Flow. Решение представляет из себя 3 коомпонента:
- GitManager
- GitAgent
- Cli приложение (https://github.com/Untru/pivo-cli)
GitManager и GitAgent Это одна и та жа конфигурация. Идея сделать GitAgent родилась изза того что по сети сборка и разборка исходников работает очень долго, по этому основная база отправляет команды в GitAgent И он уже запускает скрипты.
Общая схема работы:
sequenceDiagram
participant GitManager as GitManager (Сервер 1)
participant GitAgent as GitAgent (Сервер 2)
participant PIVO-CLI as CLI (Сервер 2)
GitManager ->> GitAgent: Отправка команды (pivo-cli)
activate GitAgent
GitAgent ->> CLI: Запуск команды
activate CLI
CLI -->> GitAgent: Результат (stdout/stderr)
deactivate CLI
GitAgent -->> GitManager: Ответ (логи/статус)
deactivate GitAgent
Старт работы
Для удобства работы мы сделали скрипт по разворачиванию базы (РазворачиваниеБазы.bat)
Необходимо заполнить переменные, система сама скачает файл с репозитория и развернет базу на сервере. Основные тесты были с серверной базой, по этому в файловой гарантирвтаь работоспособность нам сложно.
Скрипт
@echo off
chcp 65001 > nul
setlocal enabledelayedexpansion
:: =============================================
:: Установка GitManager
:: =============================================
:: Параметры
set "GITHUB_URL=https://github.com/Untru/gitmanager/releases/latest/download/GitManager.cf"
set "TEMP_FILE=%TEMP%\GitManager.cf"
set "DB_SERVER=localhost" :: Измените на свой сервер СУБД при необходимости
set "DB_NAME=Name" :: Имя новой базы данных
set "DB_USER=postgres" :: Пользователь СУБД
set "DB_PWD=postgres" :: Пароль пользователя СУБД
set "1C_USER=Администратор" :: Пользователь 1С
set "1C_PWD="" :: Пароль 1С (оставьте пустым, если без пароля)
set "V8VER=8.3.27.1508" :: Версия 1С
:: Скачиваем файл
echo Скачивание GitManager.cf...
curl -L -o "%TEMP_FILE%" "%GITHUB_URL%"
if %errorlevel% neq 0 (
echo Ошибка при скачивании файла.
pause
exit /b 1
)
echo OK. 1cv8 найден.
pause
:: Создаём и загружаем базу
echo Создание базы данных...
"%ProgramFiles%\1cv8\%V8VER%\bin\1cv8.exe" createinfobase Srvr=%DB_SERVER%;Ref=%DB_NAME%;SQLSrvr=%DB_SERVER%;DBMS=PostgreSQL;SQLDB=%DB_NAME%;SQLUID=%DB_USER%;SQLPwd=%DB_PWD%;CrSQLDB=y;DB=%DB_NAME% /AddInList %DB_NAME% /UseTemplate "%TEMP_FILE%" /Out"CreateDB-%1.log"
@TYPE "CreateDB-%1.log"
if %errorlevel% neq 0 (
echo Ошибка при создании базы данных.
pause
exit /b 1
)
:: Удаляем временный файл
del "%TEMP_FILE%"
echo База данных "%DB_NAME%" успешно создана и добавлена в список баз.
pause
Запусить и наслаждаться
Для удобста старта работ мы разработали "Начальный помошник", Управление разработкой - > Запуск. Советую пройтись по всем шагам по очередит и заодно изучить что создается,
Предусмотренно заполнение пользователей/создание проекта добавление баз и установка oscript
Если хотим все заполнять сами
Для начала работы необходимо создать пользователя с правами "Администратор", далее необходимо заполнить
Настройки пользователя:
Обязательно необходимо заполнить Проект и токен от внешнего репозитория и так же почту пользователя
Проект
Пример заполнения основных полей
После заполнения базы необходимо создать репозиторий по кнопке
Для работы с гитхаб необходимо установить
GitHub CLI
У службы под которой запужена 1с должны быть права на шару папки
Необходимо запустить RAC как службу Сделать это можно с помощью скрипта
Скрипт запуска скрапта добавления службы RAS
@echo off
rem %1 - полный номер версии 1С:Предприятия
set SrvUserName=.\USR1CV8
set SrvUserPwd="c2o3"
set CtrlPort=1540
set AgentName=localhost
set RASPort=1545
set SrvcName="1C:Enterprise 8.3 Remote Server 26"
set BinPath="\"C:\Program Files\1cv8\8.3.26.1540\bin\ras.exe\" cluster --service --port=%RASPort% %AgentName%:%CtrlPort%"
set Desctiption="1C:Enterprise 8.3 Remote Server 26"
sc stop %SrvcName%
sc delete %SrvcName%
sc create %SrvcName% binPath= %BinPath% start= auto obj= %SrvUserName% password= %SrvUserPwd% displayname= %Desctiption%
Важно, с системе получние настроек для задач
Для вывода логов от 1command (Блиблиотека запуска команд) Мы можем или зададать переменную окружения
set LOGOS_CONFIG=logger.oscript.lib.commands=DEBUG;
Процесс работы
Каждой базе должен соответствовать своя папочка подключенная к репозиторию, это проверить можно по наличию кнопки создания репозитория
Создаем задачу
Новая задача - >
Тут есть 3 варианта:
- Новая задача - создается новая ветка из ветки Develop
- HotFix к задаче - создается новая задача к задаче по ветке main/master, создает новую задачу к текущей
- HotFix новая задача - требует наличие задачи в таск трекере
Таск трекеры
Сейчас поддерживается 2 таск трекера
- 1С (только простая загрузка задач) Передаем параметр - номер задачи
curl --location 'https:/Путь К Базе/hs/tasks/task?id=000000002'
На входе мы ожидаем JSON
{
"Исполнитель": "",
"Трудозатраты_часов": 0,
"Статус": "",
"ДатаПринятияВРаботу": "",
"Описание_Задачи": "",
"Описание_Решения": "",
"Приоритет": ,
"Очередь":
}
- Битрикс
Задача должна появится в списке, прошу обратить внимание
Переходим на ветку
Во время перехода происходит переход в папке базы репозитория на переход на нужную ветку, и загрузка в базу
- Основной конфигурации, если стоит галочка
- Загрузка расширений указанных в задаче
- Компилирование внешних обработок и помещение их в папку проекта. \Repositories\ИмяБазы\build\epf
Зафиксировать изменения
Разбор указанного в задачи на исходники (Конфигурация и расширения). Разбор внешних обработок из папки build\epf
Создание мерд реквеста
В случае если это GITHUB - необходим GITHUB-CLI
Другие возможности
- Создание внешних обработоток по шаблону
- Загрузки обработок в бд
- Подготовка релиза и быстрое обновление баз
ВАЖНО
Так как инзначально инструмент разрабатывался для нужд комапни и подгонялась под требования много функционала сейчас возможно работат не будет. мы старались добавить универсальности решению. Если вы захотите развернуть инструмент у себя. Обращайтесь за помощью, любые ваши вопросы помогут дописать руководство и поправить найденные замечания.
Так же вся чески приветствуются Ишузы.
Использование чужих библиотек
ОГРАНИЧЕНИЯ !!! Некоторый функционал не работает в WEB Клиенте