upload

Загрузите готовый пакет конфигурации в базу.

Вывод

CLIJSON

Примеры ответов; пути и длительность зависят от запуска.

upload build/main.cf

v8-runner upload build/main.cf

целиком заменяет основную конфигурацию пакетом .cf или загружает расширение пакетом .cfe с --ref <имя> (11)

Имя в --ref — имя расширения в базе. Набор EXTENSION называет расширение своим именем, как у push.

Классы ответов

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

Класс	Когда возникает и что означает
Пакет загружен	`execution.payload.applied: true`. `update_db_cfg_ran` отдельно сообщает о применении к конфигурации БД.
План подготовлен	`applied: false`; совместимость может оставаться `not_probed`.
Пакет или режим не подходят	Неверный CF/CFE/файл настроек, нет имени расширения; несовместимый режим при supported/absent или состояние совместимости `not_established`.
Загрузка не завершилась	execution.status — failed; пакет мог быть загружен до ошибки следующего шага. `applied` отражает выполненную загрузку, `update_db_cfg_ran` — выполнение обновления конфигурации базы данных. Ошибка следующего шага не отменяет уже выполненные изменения. Если `/UpdateCfg` вернул 0, а рабочая версия осталась прежней, результат остаётся неподтверждённым, `applied` и `update_db_cfg_ran` равны `false`.
Выполнение прервано	execution.status — cancelled / timed_out. В критической фазе прерывание может быть отложено до безопасного завершения.

Причины отказов и различия между ошибкой команды, ошибкой шага и диагностикой запуска — в словаре ответов.

Варианты ответа

Операция завершилась успешно

Фрагмент успешного текстового ответа:

target: configuration
action: load cf
artifact: build/main.cf

Пакет не загружен

Это пример ошибки до применения: applied и update_db_cfg_ran равны false. Если загрузка выполнена до ошибки следующего шага, applied остаётся true: отказ не означает откат.

target: configuration
action: load cf
ERROR: platform error: artifact load failed

upload --mode combine

v8-runner upload build/main.cf --mode combine --settings combine.xml --vendor-name Vendor

объединяет конфигурацию с пакетом по файлу настроек (49)

Варианты ответа

Операция завершилась успешно

Фрагмент успешного текстового ответа:

target: configuration
action: combine cf
artifact: build/main.cf

upload --mode update

v8-runner upload dist/vendor.cfu --mode update --settings update.xml

Обновляет основную конфигурацию на поддержке файлом поставки .cf или обновлением .cfu. Раннер проверяет XML настроек и вызывает /UpdateDBCfg после подтверждённой смены версии рабочей конфигурации.

Для расширения используйте upload <файл.cfe> --mode combine --settings <файл> --ref <имя>.

upload build/main.cf --dry-run

v8-runner upload build/main.cf --dry-run

Превью проверяет настройки и доступность исполнителя. Платформа не запускается; база и выходные файлы не меняются. Без --dry-run выполняется указанная операция.

Варианты ответа

План загрузки пакета подготовлен

Успех превью подтверждает подготовку плана, а не выполнение операции. Фрагмент текстового ответа:

target: configuration
action: load cf
artifact: build/main.cf

Что намеренно не стало метафорой

У гита есть и gc, и bisect: не всё обязано быть аналогией. Имена ниже выглядели подходящими и не взяты.

имя	почему не взято
`checkout` для `upload`	в гите это местное действие, а загрузка пакета меняет базу. Обманывает в опасную сторону
`restore` для отброса непринятого	в гите `restore` возвращает файлы к зафиксированному, но здесь это слово занято образом `.dt`: `infobase restore`. Отброс непринятого назван `reset`, как у платформы и как `reset --hard`
`merge` для объединения конфигураций	объединение по файлу настроек совпадает с трёхсторонним слиянием только в букве; режим назван `combine`
`push --force` для полной пересборки	в гите значит «перезапиши ту сторону», и ровно это он здесь и значит. Полная пересборка — «посчитай заново здесь», у неё другое имя: `push --full`
`remote` отдельной командой	вышло бы два слова для одной вещи. Базы объявляются в местном слое, адреса видны в `status --all`, действия с базой собраны под `infobase`
`export` и `save` для пакета из базы	у платформы «экспорт» — выгрузка в XML, а «сохранить» в Конфигураторе — записать правки в базу. Оба слова обманывают направлением; пакет из базы получает `download`
`stash`, `commit`, `log`	работа с системой версий принадлежит самой системе версий. Раннер её не подменяет и в неё не пишет

push --delete опаснее своего тёзки. Удаление ветки в гите дёшево и достаётся из журнала ссылок. Удаление расширения из базы уводит данные, которые оно добавляло (42), и журнала ссылок там нет. Имя знакомое, цена другая, поэтому команда спрашивает подтверждение жёстче, чем гит. Это единственное место, где словарь сознательно расходится с поведением тёзки, и расходится в сторону осторожности.

Настройка исполнителей и конфигурации проекта.