Список пакетов

Синхронизация хранилища 1С с репозиторием git

Введение

Проект является глубоким рефакторингом утилиты v83unpack (https://github.com/xDrivenDevelopment/v83unpack).

Изначально данный механизм представляет собой внешнюю обработку 1С:Предприятия, которая впоследствии была портирована на OneScript. Исходные коды порта доступны в том же репозитории v83unpack.

Приложение gitsync представляет собой отдельное (standalone) приложение на 1Script, и предназначено для синхронизации хранилища конфигураций 1С с репозитарием git.

Установка

Вручную

  1. Вручную - Скопировать каталог gitsync/src на жесткий диск
  2. Запустить приложение командой oscript.exe <каталог gitsync>\gitsync.os

Через пакетный менеджер opm

  1. командой opm install gitsync
  2. Запустить командой gitsync

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

Подготовка нового репозитария

Запустить gitsync с параметрами gitsync init <каталог или файл хранилища> <локальный каталог git> [-email домен почты пользователей]

Буден инициализирован новый репо и созданы необходимые файлы для синхронизации.

Клонирование существующего пустого репо

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

Запустить gitsync с параметрами gitsync clone <каталог или файл хранилища> <url-git> [локальный каталог git] [-email домен почты пользователей]

Буден клонирован удаленный репо и созданы необходимые файлы для синхронизации, если их там еще нет.

Синхронизация

Основной режим работы. Аргументы командной строки для запуска:

  • <каталог или файл хранилища>
  • <адрес (url) репозитария>
  • [локальный каталог git]
  • [-email домен почты пользователей]
  • [-v8version маска версии 1С] - маска версии в стиле стартера (8.3 или 8.3.5 или 8.2.19.109)

Пример:

cd local-git-repo
gitsync c:\storage\zup http://github.com/myAccount/zup.git -v8version 8.3.6

Получение справки

Справку по синтаксису команды можно получить, запустив gitsync help <команда>. Например:

gitsync help clone
gitsync help init

Синхронизация по нескольким хранилищам

Зачастую удобно настроить регламентную (по расписанию) синхронизацию сразу по нескольким хранилизам 1С. Для этого необходимо подготовить конфигурационный файл с параметрами синхронизации (пример файла)

Далее, необходимо запустить gitsync с командой all

gitsync all <путь к xml-файлу конфигурации>

Подробнее о параметрах команды all можно прочитать, запустив gitsync help all