Прокси-сервер для проверки формата комментариев в хранилище конфигураций 1С

Назначение

Простой инструмент для контроля формата комментариев, которые разработчики указывают при помещении изменений в хранилище. Это прокси-сервер nginx, который с помощью кода на Lua анализирует запросы и выдает 400 Bad Request в случае, если комментарий к версии хранилища не указан или указан не по формату. Проверка осуществляется не только при помещении изменений, но и при редактировании версий хранилища "задним числом".

По умолчанию реализована одновременно строгая и наивная проверка комментария. Корректный комментарий:

• не пустой
• начинается на #, после чего должны следовать либо 5 цифр, либо строка "нетзадачи"
• содержит два перевода строки

Примеры корректных комментариев:

#12345 Обработка заполнения ТЧ "Товары"

Добавлена обработка заполнения ТЧ "Товары" документа "Реализация товаров и услуг"

#нетзадачи

Тех. долг

Код проверки комментария на соответствие формату можно модифицировать под свои потребности в conf.d/crserver-filter.conf.

Работоспособность решения проверена на конфигурациях размера ERP 2.4 при активной работе 10+ разработчиков, в том числе в режиме подключения пустой конфигурации к хранилищу.

Использование

• внести изменения в conf.d/crserver-filter.conf
  • указать адрес прокси-сервера и адрес сервера хранилища
  • уточнить формат комментария к версии хранилища
• внести изменения в docker-compose.yml
  • указать порт прокси-сервера (по умолчанию 3333)
• выполнить docker-compose up -d
• открыть Конфигуратор, закрыть хранилище, открыть хранилище, вместо адреса реального хранилища указать прокси:порт

БЫЛО: http://srv-app-01/CRServer/repository.1ccr/ERP_Master

СТАЛО: http://srv-ci-01:3333/CRServer/repository.1ccr/ERP_Master

После проверки работоспособности необходимо изменить порт основного http-сервера хранилища, обновить его в conf.d/crserver-filter.conf, перезапустить контейнер.

Ссылки

• commitHook
• OpenResty