Установка

Установка C3DService

пакет RPM

Доступен для семейства ОС Red Hat

Команда установки:

rpm -i {C3DSERVICE_PACKAGE}.rpm

Команда обновления:

rpm -U {C3DSERVICE_PACKAGE}.rpm

Пакет DEB

Доступен для семейства ОС Debian/Ubuntu

Команда установки/обновления

dpkg -i {C3DSERVICE_PACKAGE}.deb

Архив Linux

  1. Распакуйте архив

  2. Отредактируйте файл “config.json”

  3. Запустите сервис командой:

./c3dservice run --log-level=trace --config=./config.json

Архив Windows

  1. Распакуйте архив

  2. Отредактируйте файл “config.json”

  3. Запустите сервис в командной оболочке cmd.exe

c3dservice.exe run --log-level=trace --config=.\config.json

Образ Docker

Установка образа Docker командой:

docker load < {C3DSERVICE_DOCKER}.tar.gzip

Теперь образ webservice можно использовать для запуска контейнера или docker-compose.

Добавление репозитория

Пакет API веб-просмотрщика C3D распространяется через закрытый репозиторий npm. Для установки пакета сначала необходимо настроить реестр @c3dlabs.

Доступны два репозитория npm.

Классический NPM

Установка:

npm config set @c3dlabs:registry https://npm.c3dlabs.com/

Если вы используете npm версии выше 9.x.x, то необходимо запустить:

npm login --registry https://npm.c3dlabs.com/ --auth-type=legacy

Если вы используете npm версии ниже 9.x.x, то необходимо выполнить следующую команду:

npm login --registry https://npm.c3dlabs.com/

GitLab NPM

У некоторых клиентов возникают проблемы с аутентификацией классического npm, срок действия которой быстро истекает. Это особенно актуально для проблем непрерывной интеграции с контейнерными системами.

В альтернативном репозитории NPM через GitLab используются ключи, срок действия которых не истекает.

Установка производится с помощью команд:

npm config set @c3dlabs:registry https://gitlab.c3d.ascon.ru/api/v4/projects/48/packages/npm
npm config set //gitlab.c3d.ascon.ru/api/v4/projects/48/packages/npm:_authToken {GITLAB_ACCESS_TOKEN}

Установка пакета

Теперь вы можете просто добавить пакет ‘c3dviewer-api’ в свой проект следующим образом:

npm install --save @c3dlabs/c3dviewer-api

Если вы установите любую из предварительных версий пакета, например:

npm install --save @c3dlabs/c3dviewer-api@1.4.0-alpha.1

Вы можете столкнуться со следующей проблемой:

Could not resolve dependency (Не удалось разрешить зависимость): … Conflicting peer dependency (Противоречивая зависимость): …

Это вызвано зависимостями, которых нет в предварительных версиях. В таких случаях просто принудительно установите пакет, используя:

npm install --save -f @c3dlabs/c3dviewer-api@1.4.0-alpha.1