Сборка, тестирование, доставка приложения на onescript с помощью gitlab-ci

Будем использовать:

onescript

gitlab-ci

docker (как вариант раннера в gitlab-ci)

Функция daСклонение не раз была использована для печатных форм, в которых необходимо склонять ФИО, должности, ect…Основная причина использования именно этого метода была в том, что ВПФ должны были выполняться в безопасном режиме, а в нем ни NameDecl, ни morpher ни могут быть использованы.

При портировании пришлось заменить методы Вычислить и ЧислоПрописью, метод ЧислоПрописью «временно» взят из этой публикации. Реализованы тесты из примеров описания функции.

Итак, к делу. Исходники будем держать на github (куда без него), а ci будет на gitlab. По сути на gitlab будет зеркало нашего репозитория из github. Для связи репозиторие создадим новый проект на gitlab, и выберим вариант CI/CD for external repo. Инструкция по интеграции с github

После интеграции сервисов нажмем кнопку Connect repositories from GitHub, и выбираем наш репозиторий из github.

Для запуска CI/CD в gitlab необходимо наличие файла .gitlab-ci.yml в корне репозитория. Для начала создадим файл следующего содержания

image: "evilbeaver/onescript:latest" # для всех этапов укажем что будем использовать образ контейнера с последней версией oscript

stages: # здесь указываются этапы нашего конвеера
- test

test: # задача - имя задачи, тут можно указать даже на кириллице, например: 'Тесты'
stage: test # к какому типу этапов относится задача
script: # что будем выполнять в задаче
- opm install 1testrunner # установим библиотеку для тестирования
- 1testrunner -runall ./tests # запустим тесты

После коммита, в gitlab можно понаблюдать за запуском теста по ссылке https://gitlab.com/myprofile/myproject/-/jobs/

Для себя решаем, что подобная задача подойдет только для dev ветки и features веток. Конвейер для релизной ветки должен содержать задачи для сборки пакета, установки и тестирования, доставки пакета.

Содержание файла .gitlab-ci.yml:

image: "evilbeaver/onescript:latest"

# добавляем еще два типа этапов
stages:
- build
- test
- deploy

test:
stage: test
script:
- opm install 1testrunner
- 1testrunner -runall ./tests
except: # исключаем эту задачу из мастер ветки или тегов
- master
- tags

build:
stage: build
script:
# в файле packagedef устанавливаем имя тега как версию пакета
- grep '%ver' -P -R -I -l packagedef | xargs sed -i 's/%ver/'$CI_COMMIT_REF_NAME'/g'
- mkdir ./build
- opm build . -out ./build # собираем пакет
artifacts:
paths:
- build/*.ospx # говорим что из задачи надо забрать все файлы с расширением .ospx из папки  build
expire_in: 1 day # храним артефактов этой задачи 1 день
only: # говорим что задача только для тегов
- tags

test-master:
stage: test
script:
# изменяем Использовать ".." на Использовать далее устанавливаемый пакет daSklonenie в файле с тестами
- grep '#Использовать ".."' -P -R -I -l ./tests/Тесты_daСклонение.os | xargs sed -i 's/#Использовать ".."/#Использовать daSklonenie/g'
# ставим наш пакет, в эту задачу он был передан как артефакт
- opm install -f ./build/daSklonenie-$CI_COMMIT_REF_NAME.ospx
# далее все как и в первом тесте
- opm install 1testrunner
- 1testrunner -runall ./tests
only: # говорим что задача только для тегов
- tags

daSklonenie:
stage: deploy
variables:
GIT_STRATEGY: none # скажем что не надо получать данные из репозитория, работать будем только с артефактов
script:
# переместим файл в основной каталог - для красоты
- mv ./build/daSklonenie-$CI_COMMIT_REF_NAME.ospx ./daSklonenie-$CI_COMMIT_REF_NAME.ospx
artifacts:
name: "daSklonenie-$CI_COMMIT_REF_NAME" # укажем имя архива артефактов
paths:
- daSklonenie-$CI_COMMIT_REF_NAME.ospx # укажем какой файл будем забирать как артефактов задачи
only:
- tags

Сделаем коммит с тегом версии и проследим за нашим конвеером.

Cборка

Установка и тестирования

Доставка пакета

В данном случае описан простой пример доставки, но можно добавить сообщение в месседжеры, отправка пакета по почте, на ftp или обновление файла в публикации на infostart по api

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

Как быстро попробовать

1. форкаем репозиторий на github
2. настраиваем интеграцию gitlab и github
3. создаем проект на gitlab c вариантом CI/CD for external repo
4. указываем, какой проект из github будем подключать
5. делаем изменения в проекте, коммит
6. устанавливаем тег
7. ждем завершения конвейера, смотрим артифакты