Внедрение CI/CD для 1С

Инструкция и необходимые наборы скриптов и файлов для работы с CI/CD для 1С.

1. Подготовка окружения

Установка ovm

• Скачать ovm.exe со страницы страницы релизов GitHub
• Прописать путь к ovm.exe в переменной окружения PATH

Установка OneScript

ovm install stable
ovm use stable

Установка vanessa-runner

opm install vanessa-runner

Установка vanessa-add

opm install add

Установка gitsync

opm install gitsync
gitsync plugins init
gitsync plugins enable check-authors
gitsync plugins enable sync-remote

2. Развертывание шаблона проекта

Скриптом

project-init.cmd — инициализация проекта

Создает папку проекта, клонирует шаблон Vanessa Bootstrap и подключает ваш git репозиторий из ветки, по умолчанию master.

./project-init.cmd <папка> <git-repo-url> [ветка]

Пример:

./project-init.cmd test-project http://gitlab.local/root/test-project.git main

Создание и настройка шаблона проекта командами

В пустом каталоге создать необходимую структуру проекта

vrunner init-project

подпишитесь на обновление шаблона

git remote add -f --no-tags -m --mirror bootstrap https://github.com/vanessa-opensource/vanessa-bootstrap.git

Далее отключим локальный репозиторий от удаленного

git remote remove origin

Подключить репозиторий к своему git серверу

git remote add origin <git-repo-url>

Получить изменения из своего репозитория

git pull origin [ветка] --allow-unrelated-histories

исправьте полученные конфликты, если вы меняли те же файлы, что есть в шаблоне

Порядок обновления

В дальнешем, чтобы получить изменения шаблона bootstrap

git pull bootstrap ваша-текущая-ветка-разработки

3. Настройка CI/CD

Добавить в корень проекта файлы

.gitlab-ci.yml — Файл конфигурации для GitLab CI/CD.

Файл конфигурации для автоматического запуска тестов и анализа кода в GitLab.

Как использовать:

• Скопируйте .gitlab-ci.yml в корень вашего проекта
• Добавьте в GitLab переменные: SONAR_TOKEN, SONAR_HOST_URL
• При необходимости измените ветки в секции only

sonar-project.properties — настройка SonarQube

Файл конфигурации для анализа 1С кода в SonarQube.

Инструкция:

• Скопируйте sonar-project.properties в корень вашего проекта
• Измените в файле в корне вашего проекта после копирования
• Измените sonar.projectKey на уникальный идентификатор
• Измените sonar.projectVersion при необходимости

Настройка gitsync

Добавить в папку tools файлы:

Инициализация репозитория(однократно)

gitsync-init.cmd - файл для инициализации работы с хранилищем, внутри уже указаны параметры:

set GITSYNC_STORAGE_USER=gitsync
set GITSYNC_STORAGE_PWD=gitsync
set GITSYNC_STORAGE_PATH=.\storage
set GITSYNC_WORKDIR=.\src\cf

gitsync init

Установка соответствия пользователей хранилища

В файле AUTHORS настроить соответствия между пользователями хранилища 1С и git-сервера.

Синхронизация репозитория(многократно)

gitsync-sync.cmd - Файл для синхронизации

set GITSYNC_V8VERSION=8.5.1
set GITSYNC_STORAGE_USER=gitsync
set GITSYNC_STORAGE_PWD=gitsync
set GITSYNC_STORAGE_PATH=.\storage
set GITSYNC_WORKDIR=.\src\cf
set GITSYNC_REPO_URL=<git-repo-url>
set GITSYNC_REMOTE_PULL=true
set GITSYNC_REMOTE_BRANCH=master
set GITSYNC_REMOTE_PUSH=true

gitsync sync