Command Palette

Search for a command to run...

Установка платного плагина

В этом руководстве вы подключите реестр пакетов Gorgo с ключом проекта и установите платный плагин. Как зарегистрировать плагин в Medusa и настроить его, описано на странице самого плагина.

Для установки нужны:

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

Шаг 1: Создайте ключ проекта

Откройте проект в кабинете, перейдите на вкладку Ключ и нажмите Создать ключ.

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

Плагины и менеджеры пакетов берут ключ из переменной окружения . Задайте её везде, где ставятся зависимости и работает магазин, то есть на своей машине, в CI/CD и в окружениях бэкенда. В репозиторий проекта ключ при этом не попадает.

.env
GORGO_LICENSE=gorgo_live_...

Шаг 2: Подключите реестр

Платные плагины опубликованы не в общем реестре npm, а в реестре . Укажите менеджеру пакетов этот реестр для пакетов . Yarn 2 и новее читает настройки из , npm и pnpm из :

.yarnrc.yml
1npmScopes:
2 gorgo-store:
3 npmRegistryServer: "https://registry.gorgojs.com"
4 npmAuthToken: "${GORGO_LICENSE}"
pnpm 11.5.3 и новее: 

Начиная с версии 11.5.3, pnpm не подставляет переменные окружения в токены авторизации из проекта, и без отдельного шага установка не пройдёт авторизацию в реестре. Поэтому для pnpm в указан только адрес реестра, а ключ сохраните в пользовательских настройках pnpm.

Для pnpm выполните эту команду на своей машине и в CI до установки зависимостей:

pnpm config set //registry.gorgojs.com/:_authToken "$GORGO_LICENSE"

Шаг 3: Установите плагин

Установите пакет так же, как пакет из общего реестра npm, например плагин 1С:Предприятие:

yarn add @gorgo-store/medusa-erp-1c

Дальше зарегистрируйте плагин в по руководству на его странице, например Начало работы с 1С:Предприятием.


Шаг 4: Проверьте лицензию

Запустите магазин и откройте в панели администратора Medusa раздел Настройки → Интеграции. Там виден результат проверки лицензии по каждому платному плагину. Проверка идёт в фоне, магазин её не ждёт, поэтому статус может появиться через несколько секунд после запуска.

На и проверка проходит всегда. В продакшене и на стейджинге домен бэкенда должен быть в одном из окружений проекта.


Если что-то не работает

  • 403 при установке – у проекта нет подписки на этот пакет, или подписка закончилась раньше, чем вышла эта версия. Оплаченные пакеты перечислены на вкладке Ключ проекта.
  • 401 при установке – ключ не подставился или отозван. Проверьте или и значение .
  • Отказ по домену – домена бэкенда нет в окружениях проекта. Добавьте его в настройках окружения, и плагин увидит его после перезапуска магазина или при следующей суточной проверке.

Если ответа здесь нет, напишите нам, как описано на странице Поддержка.

Изменено 31 октября 2026 г.·Редактировать страницу