nb source download

Загружает NocoBase из npm, Docker или Git. --version — общий параметр для всех трёх типов источника: для npm используется версия пакета, для Docker — тег образа, для Git — git ref.

Использование

nb source download [flags]

Параметры

ПараметрТипОписание
--yes, -ybooleanИспользовать значения по умолчанию и пропустить интерактивные запросы
--verbosebooleanПоказать подробный вывод команд
--localestringЯзык подсказок CLI: en-US или zh-CN
--source, -sstringТип источника: docker, npm или git
--version, -vstringВерсия пакета npm, тег образа Docker или git ref
--replace, -rbooleanЗаменить целевой каталог, если он уже существует
--dev-dependencies, -D / --no-dev-dependenciesbooleanУстанавливать ли devDependencies при установке npm/Git
--output-dir, -ostringЦелевой каталог загрузки или каталог для сохранения tarball Docker
--git-urlstringURL Git-репозитория
--docker-registrystringИмя репозитория Docker-образа без тега
--docker-platformstringПлатформа Docker-образа: auto, linux/amd64, linux/arm64
--docker-save / --no-docker-savebooleanСохранять ли загруженный Docker-образ как tarball
--npm-registrystringРеестр для загрузки и установки зависимостей npm/Git
--build / --no-buildbooleanВыполнять ли сборку после установки зависимостей npm/Git
--build-dtsbooleanГенерировать ли файлы объявлений TypeScript при сборке npm/Git
--hook-scriptstringМодуль хука, который запускается после npm-шаблона или git clone и перед установкой зависимостей; применяется только к источникам npm/Git

Примеры

nb source download
nb source download -y --source npm --version alpha
nb source download -y --source npm --version alpha --no-build
nb source download --source npm --version alpha --output-dir=./app
nb source download --source docker --version alpha --docker-registry=nocobase/nocobase --docker-platform=linux/arm64
nb source download -y --source docker --version alpha --docker-save -o ./docker-images
nb source download --source git --version alpha --git-url=git@github.com:nocobase/nocobase.git
nb source download --source git --version fix/cli-v2
nb source download -y --source npm --version alpha --build-dts
nb source download -y --source npm --version alpha --npm-registry=https://registry.npmmirror.com
nb source download -y --source git --version beta --hook-script ./hooks.mjs

Хук перед установкой

--hook-script влияет только на текущий запуск nb source download. Если нужно сохранить хук вместе с окружением и повторно использовать его в nb app upgrade или при локальном восстановлении исходного кода, передайте его через nb init --hook-script.

Файл хука должен экспортировать объект по умолчанию с методом beforeDependencyInstall(context):

export default {
  beforeDependencyInstall: async ({ sourcePath, version, envConfig }) => {
    // Выполняется после git clone / npm-шаблона и перед yarn install.
  },
};

При прямом запуске nb source download --hook-script хук beforeDependencyInstall получает context.phase как source-download и context.command как source:download. Эта команда не запускает beforeAppInstall или afterAppStart; эти хуки относятся к установке, запуску, перезапуску и обновлению приложения.

Псевдонимы версий

При использовании источника Git распространённые теги дистрибуции разрешаются в соответствующие ветки: latestmain, betanext, alphadevelop.

Связанные команды