在线时间:8:00-16:00
迪恩网络APP
随时随地掌握行业动态
扫描二维码
关注迪恩网络微信公众号
开源软件名称:oscript-library/gitsync开源软件地址:https://github.com/oscript-library/gitsync开源编程语言:1C Enterprise 89.0%开源软件介绍:Синхронизация хранилища 1С с репозиторием gitОглавление
ВведениеПроект gitsync представляет собой:
Документация и описание публичного API библиотеки УстановкаЧерез пакетный менеджер opm
Вручную
Требования
Особенности
Отличия от |
Имя | Описание |
---|---|
GITSYNC_V8VERSION |
маска версии платформы (8.3, 8.3.5, 8.3.6.2299 и т.п.) |
GITSYNC_V8_PATH |
путь к исполняемому файлу платформы 1С (Например, /opt/1C/v8.3/x86_64/1cv8) |
GITSYNC_VERBOSE |
вывод отладочной информации в процессе выполнения |
GITSYNC_TEMP |
путь к каталогу временных файлов |
GITSYNC_EMAIL |
домен почты для пользователей git |
Имя | Описание |
---|---|
GITSYNC_WORKDIR |
рабочий каталог для команды |
GITSYNC_STORAGE_PATH |
путь к хранилищу конфигурации 1С. |
GITSYNC_STORAGE_USER |
пользователь хранилища конфигурации |
GITSYNC_STORAGE_PASSWORD |
пароль пользователя хранилища конфигурации |
WORKDIR | текущая рабочая директория |
-u, --storage-user | пользователь Администратор |
Примитивный вариант
gitsync sync C:/Хранилище_1С/ C:/GIT/src
Команда выполнит выгрузку версий хранилища 1С из C:/Хранилище_1С/
в репозиторий git в каталоге C:/GIT/src
. Пример учебный, на практике обычно требуется указать также имя пользователя хранилища и пароль.
Вариант вызова команды в текущем рабочем каталоге
переменная окружения
GITSYNC_WORKDIR
не должна быть задана
cd C:/work_dir/
gitsync sync C:/Хранилище_1С/
Команда выполнит выгрузку версий хранилища 1С из C:/Хранилище_1С/
в репозиторий git в каталоге C:/work_dir
Вариант с указанием пользователя хранилища и пароля
gitsync sync --storage-user Admin --storage-pwd Secret C:/Хранилище_1С/ C:/work_dir/
Имя пользователя = Admin, пароль = Secret.
Использование синонимов (короткая версия предыдущего примера)
gitsync s -u Admin -p Secret C:/Хранилище_1С/ C:/work_dir/
# возможны варианты
# gitsync s -uAdmin -pSecret C:/Хранилище_1С/ C:/work_dir/
# gitsync s -u=Admin -p=Secret C:/Хранилище_1С/ C:/work_dir/
Указание исполняемого файла нужной версии платформы
gitsync --v8-path /opt/1C/v8.3/x86_64/1cv8 s -uAdmin -p=Secret C:/Хранилище_1С/ C:/work_dir/
Команда синхронизации будет выполнена с использованием исполняемого файла платформы /opt/1C/v8.3/x86_64/1cv8
(приведен синтаксис для linux; вариант для Windows см. ниже).
Вызов команды без указания параметров, с использованием переменных окружения
linux:
export GITSYNC_WORKDIR=./work_dir/
export GITSYNC_STORAGE_PATH=./Хранилище_1С/
export GITSYNC_STORAGE_USER=Admin
export GITSYNC_STORAGE_PASSWORD=Secret
export GITSYNC_V8VERSION=8.3.7
# Указание конкретного исполняемого файла платформы 1С. Путь надо обернуть в кавычки если он содержит пробелы.
#export GITSYNC_V8_PATH=/opt/1C/v8.3/x86_64/1cv8
export GITSYNC_VERBOSE=true #Можно использовать Да/Ложь/Нет/Истина
export GITSYNC_TEMP=./temp/sync
gitsync s
windows:
set GITSYNC_WORKDIR=./work_dir/
set GITSYNC_STORAGE_PATH=./Хранилище_1С/
set GITSYNC_STORAGE_USER=Admin
set GITSYNC_STORAGE_PASSWORD=Secret
set GITSYNC_V8VERSION=8.3.7
# Указание конкретного исполняемого файла платформы 1С. Путь надо обернуть в кавычки если он содержит пробелы.
#set GITSYNC_V8_PATH="C:\Program Files (x86)\1cv8\8.3.12.1567\bin\1cv8.exe"
set GITSYNC_VERBOSE=true #Можно использовать Да/Ложь/Нет/Истина
set GITSYNC_TEMP=./temp/sync
gitsync s
Данный пункт можно пропустить, если Вам не требуется дополнительная функциональность синхронизации
Для расширения функциональности синхронизации предлагается механизм плагинов. Данный механизм реализован через подписки на события синхронизации, с возможностью переопределения стандартной обработки.
Для обеспечения управления плагинами реализована подкоманда plugins
, а так же ряд вложенных команд:
init
- Инициализация предустановленных плагинов (установка из поставляемого пакета)list
- Вывод списка плагиновenable
- Активизация установленных плагиновdisable
- Деактивизация установленных плагиновinstall
- Установка новых плагиновclear
- Удаление установленных плагиновhelp
- Вывод справки по выбранным плагинамПример использования:
gitsync plugins enable limit
- будет активирован плагин limit
gitsync plugins enable -a
- будут активированы все предустановленные плагиныgitsync plugins enable
- будет выведен список всех установленных плагинов для интерактивного выбора и активации выбранныхgitsync plugins list
- будет выведен список всех активированных плагиновgitsync plugins list -a
- будет выведен список всех установленных плагиновСправка по команде: gitsync plugins --help
Для удобства использования команда plugins
имеет короткое название p
.
Больше примеров: gitsync usage plugins
Для хранения установленных плагинов и списка активных плагинов используется каталог
локальных данных приложения
- для Windows это C:\Users\UserName\AppData\Local\gitsync\plugins
Список предустановленных плагинов:
Для инициализации предустановленных плагинов необходимо выполнить команду
gitsync plugins init
. Описание используемых плагинами опций см. в справке к команде sync.
increment
- включает режим инкрементальной выгрузки конфигурации в исходники.sync-remote
- добавляет опции команды sync
для синхронизации с удаленным репозиторием git (команды git pull
и git push
)limit
- позволяет ограничить количество выгружаемых версий за один запуск, а так же указать минимальную и/или максимальную версию хранилища для выгрузкиcheck-authors
- блокирует выгрузку версии, если автор версии хранилища отсутствует в файле AUTHORS
check-comments
- добавляет опции команды sync
для проверки наличия комментария у версии хранилища, а также для проверки заполнения комментарияsmart-tags
- устанавливает тег равный версии конфигурации при смене версии конфигурации (не путать с версией хранилища). А также добавляет опции команды sync
для автоматической установки метки git (команда git tag
) равной версии хранилища (в формате "v.номер").unpackForm
- выполняет распаковку обычных форм на исходники. Добавляет опции команды sync
для переименования объектов обычных форм.tool1CD
- заменяет использование штатных механизмов 1С на приложение tool1CD
при выгрузкеdisable-support
- снимает конфигурацию с поддержки перед выгрузкой в исходникиedtExport
- добавляет возможность выгрузки в формате EDT. Для работы плагина необходимо установить EDT.gitsync
Раздел документации в разработке
Раздел документации в разработке
Проект gitsync
поддерживает ряд подписок на события
Сборка производится в 2-х режимах:
Сборка обычного пакета (без зависимостей)
opm build .
В этом варианте в сборку не добавляются предустановленные пакеты. Их надо будет устанавливать отдельно.
Сборка пакета с зависимостями
opm build -mf ./build_packagedef .
В сборку будут добавлены пакеты из репозиториев:
opm
- из ветки developgitsync-pre-plugins
- из ветки developДоработка проводится по git-flow. Жду ваших PR.
Смотри файл LICENSE
.
2023-10-27
2022-08-15
2022-08-17
2022-09-23
2022-08-13
请发表评论