В этой статье мы рассмотрим процесс подключения GitLab к 1С Элементу и настройку групповой разработки в проекте.
Благодаря этому мы получим полный функционал: формирование задач, веток разработки и релиза, историю изменений.
Версия 1С Элемент: 8.0 и выше.
Тип установки 1С Элемент: Локальный
Версия Git: 2.45 и выше
Подключение GitLab
Так как мы используем локальную установку 1С Элемент на своем сервере, то первое, что требуется сделать - это на сервере с 1С Элементом установить и настроить Git (система контроля версий).
Как его устанавливать и настраивать - есть отдельная инструкция, которая доступна в справке 1С Элемента в разделе «Руководстве разработчика» → «Среда разработки» → «Git».
Ссылка на справку из 8.0 - https://1cmycloud.com/console/help/element/8.0/docs/topics/git-installation/
После установки Git, в панели управления 1С Элемента станет доступно Хранилище репозиториев.
Чтобы добавить репозиторий GitLab, необходимо:
Зарегистрировать аккаунт на https://gitlab.com.
В настройках аккаунта добавить Токен
3. Задать имя токена, описание, срок годности и установить роли на чтение, запись и API.
4. Нажать кнопку «Generate token».
Сгенерируется Токен доступа и будет отображаться вверху страницы. Его необходимо, скопировать и сохранить, т.к. после обновления страницы содержание токена более не будет доступно.
Примечание: Там же в профиле можно в меню Preferences переключить язык интерфейса на русский, в скобочках будет указано на сколько процентов интерфейс переведен на данный момент.
Аккаунт готов, Токен доступа готов. Теперь можно подключить к 1С Элементу:
В панели управления 1С Элемент находим меню Инфраструктура и выбираем пункт Репозитории. В открывшемся окне, нажимаем кнопку Новое Хранилище
2. В окне подключения указываем произвольное имя хранилища, указываем адрес https://gitlab.com и вставляем сгенерированный ранее Токен доступа.
3. Репозиторий подключен.
Настройка репозитория в проекте
Теперь в проекте настроим репозиторий через меню:
Откроется окно настройки:
Выбираем вариант - Создать новый внутренний git-репозиторий.
Использовать ветки при разработки - да
Использовать задачи при разработке - да
Задаем префикс задач.
После сохранения 1С Элемент уведомит, что начинает настройку репозитория проекта.
Будет создана ветка main, и связана со сборкой проекта.
Теперь проект готов к групповой разработке - доступно создание задач, веток, выпуск релиза.
Если заглянуть на сайт GitLab, то в разделе проектов мы увидим, что появился новый проект.
Как видим имена файлов проекта соответствуют имени в 1С Элементе, но вот наименование проекта указано ввиде уникального идентификатора UUID.
В свойствах проекта на GitLab, это можно поправить и задать читабельное имя, чтобы визуально проще идентифицировать проект на GitLab.
Стоит упомянуть, что 1С Элемент позволяет настроить подключение к уже существующему проекту на GitLab. Либо у вас уже есть проект на GitLab, ранее созданный (переподключение на случай сбоев 1С Элемента и иные случаи). Либо вы хотите создать новый проект на GitLab, детально настроить приватность, права и прочее.
Тогда необходимо в 1С Элементе в проекте настройках репозитория выбрать Использовать существующий внешний git-репозиторий.
И заполнить данные на подключение, указать основную ветку, указать адрес git-репозитория.
Адрес git-репозитория, можно взять на GitLab в проекте, по кнопке Code
Можно выбрать один из вариантов протокола работы: SSH или HTTPS.
Если у вас проект подключен к внешнему git-репозиторию, и вы отключите проект от репозитория и тут же настроите подключение к в внутреннему репозиторию
1С Элемент не будет создавать новый проект на GitLab, а использует тот самый внешний git-репозиторий и получит всю его историю, ветки. Если не найдет - то, конечно, создаст новый.
Артур Корякин
Руководитель проектов ООО КРОН
