v8-runner

clone

Начните с clone, если база уже существует, а исходников и проекта раннера ещё нет. Команда создаёт проект и выгружает в него основную конфигурацию базы.

Вывод

clone --connection

v8-runner clone \
  --connection 'Srvr=srv:1541;Ref=demo' \
  --platform-version 8.3.27.2074 \
  --project-dir demo

Создаёт DESIGNER-проект, объявляет базу как origin и выполняет полную выгрузку основной конфигурации. Платформу запускает, базу читает, новую базу не создаёт.

Записывает v8project.yaml, v8project.local.yaml и .gitignore. По умолчанию исходники помещает в src/cf, рабочие файлы — в build. Если --project-dir не задан, использует текущий каталог.

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

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

КлассКогда возникает и что означает
Проект создан и база выгруженаdumped: true; исходники получены.
План подготовленТолько с --dry-run: dumped: false, provider_dispatched: false.
Подготовка отклоненаЦелевые файлы уже существуют, строка подключения содержит пароль или настройки/пути не подходят.
Подготовка или выгрузка сорваласьПосле записи проекта возвращаются его пути и dumped: false. Файлы проекта могли остаться.
Выгрузка завершилась с предупреждениемРезультат выгрузки получен; сопутствующие предупреждения сохраняются в warnings.

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

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

Проект создан, конфигурация выгружена

В ответе перечислены пути проекта и исходников. Пример успешного ответа:

path: demo/v8project.yaml
local path: demo/v8project.local.yaml
gitignore: demo/.gitignore
source dir: demo/src/cf
dumped: yes
provider dispatched: yes

Project cloned successfully

Целевые файлы уже существуют

Без --force команда отказывает, если уже существует основной файл, местный файл или каталог исходников. Наличие других файлов само по себе не запрещает запуск. --force разрешает замену этих целей, включая полную выгрузку поверх исходников.

Выгрузка не завершилась

Команда возвращает ошибку. Файлы проекта, записанные до запуска выгрузки, могут остаться на диске; их наличие ещё не означает успешный clone. Пример ответа при сбое после запуска платформы:

path: demo/v8project.yaml
local path: demo/v8project.local.yaml
gitignore: demo/.gitignore
source dir: demo/src/cf
dumped: no
provider dispatched: yes
error: Dump failed

Project clone failed

clone --dry-run

v8-runner clone \
  --connection 'Srvr=srv:1541;Ref=demo' \
  --platform-version 8.3.27.2074 \
  --project-dir demo \
  --dry-run

Проверяет настройки, ищет утилиту платформы и показывает пути, которые записал бы. Каталог проекта и файлы не создаёт, платформу не запускает. Проверка прав на запись не выполняется.

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

План подготовлен

Ответ перечисляет будущие пути и утилиту выгрузки. Пример ответа:

path: demo/v8project.yaml
local path: demo/v8project.local.yaml
gitignore: demo/.gitignore
source dir: demo/src/cf
dumped: no
provider dispatched: no

Project clone planned, nothing written

Платформа не найдена

Превью тоже отказывает, если утилиту выгрузки найти не удалось. В ошибке указан искомый инструмент; файлов проекта после такого запуска нет.

Параметры подключения и выгрузки

Как исходники соотносятся с конфигурациями базы — на странице Исходники и база. Формат файлов — на странице v8project.yaml.

clone --from План

v8-runner clone --from 'Srvr=srv:1541;Ref=demo'

Объявляет проект и выполняет первую выгрузку в пустой каталог одной командой. Адрес базы из --from записывает как origin; исходники помещает в src/cf.

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

Проект создан, конфигурация выгружена

Каталог исходников — src/cf. Ответ подтверждает запись проекта и завершение выгрузки.

source dir: src/cf
dumped: yes
provider dispatched: yes

Project cloned successfully