OneScript
Требования
Для работы с пакетами 1C требуется утилита OneScript и менеджер пакетов opm.
Windows
Cкачать c официального сайта https://oscript.io/downloads установщик и запустить его. Далее следуйте подсказкам по установке на экране.
Linux
Cкачать нужный пакет с официального сайта https://oscript.io/downloads и установить его.
sudo dpkg --install onescript-engine_1.9.1_all.deb
MacOS
Интерактивного установщика нет, но движок можно установить из командной строки:
- установить homebrew
- установить mono командой
brew install mono
- скачать ovm
- выполнить команду
mono ovm.exe install stable
- выполнить команду
mono ovm.exe use stable
- перезапустить терминал
Донастройка Self-Contained варианта поставки (не требующего инсталляции dotnet):
chmod +x ./oscript
xattr -d com.apple.quarantine *.dylib oscript
codesign -s - ./oscript
Обновление
После установки OneScript, для корректной работы необходимо обновить менеджер пакетов:
opm update opm
Регистрация реестра GitFlic
Для добавления пакетов OneScript, необходимо получить транспортный токен Gitflic. С инструкцией по получению токена можно ознакомиться на странице.
В документации ниже встречается атрибут <домен_gitflic>
На его место необходимо указать домен, в зависимости от версии:
-
для SaaS версии
registry.gitflic.ru
-
для self-hosted
localhost:8080
Домен и порт для self-hosted версии может отличаться.
Значение атрибута url
зависит от уровня доступа:
Уровень | URL |
---|---|
Проект | /project/{ownerAlias}/{projectAlias}/package/-/opm/ |
Компания | /company/{companyAlias}/package/-/opm/ |
Инстанс | /package/-/opm/ |
Переменная в URL | Описание |
---|---|
ownerAlias |
Псевдоним владельца проекта |
projectAlias |
Псевдоним проекта |
companyAlias |
Псевдоним компании |
Настройка производится с помощью создания служебного файла opm.cfg. Данный файл настроек можно расположить по таким путям (список приведен в порядке убывания приоритета):
- ./opm.cfg - текущий каталог запуска + /opm.cfg
- каталог настроек пользователя
- linux: ~/.opm.cfg, внимание файла должен называться с точкой .opm.cfg
- windows: %USERPROFILE%\opm.cfg
- системная настройка:
- linux: /etc/opm.cfg
- windows: c:\ProgramData\opm.cfg
- OSCRIPT/lib/opm/opm.cfg - каталог установки opm, для совместимости.
Шаблон конфигурационного файла:
{
"СервераПакетов": [
{
"Имя":"СерверУдаленногоХранилища",
"Сервер": "<домен_gitflic>,
"Порт": 8080,
"Авторизация": "OAUTH_TOKEN <транспортный токен>",
"ПутьНаСервере": "<выбранный url>",
"РесурсПубликацииПакетов": "<выбранный url>"
}
]
}
Скачивание и установка пакета
Для установки пакета выполните команду:
opm install <имя_пакета>
Публикация пакета
Для публикации пакета выполните команду:
opm push --channel stable <путь_к_файлу>