После Generate вы работаете с двумя наборами команд. admingen-cli меняет модель и выпускает файлы. Команды созданного приложения запускают процессы, применяют SQL и обслуживают данные. Например, admingen-cli generate не заменяет make migrate.
Где выполнять команды
Настройте модель в Generator UI → Content, просмотрите Generate → Preview changes и выполните Generate. Затем перейдите в каталог созданного приложения. Make объединяет обычные шаги запуска; отдельные Go-команды позволяют выполнить конкретную операцию.
После запуска записи, связи и изображения редактируются через формы и таблицы системы администрирования.
Команды Make
| Команда | Что делает |
|---|---|
make dev |
Основной локальный запуск: окружение, база, миграции, первый администратор и процессы приложения. |
make local-environment |
Подготавливает локальную конфигурацию, сохраняя существующую. |
make dev-inner |
Внутренний этап локального запуска; обычно вызывается через dev. |
make setup |
Подготовка frontend-зависимостей через admin-install. |
make build |
Сборка backend и admin. |
make test |
Проверки backend и admin. |
make up |
Подъём локальной инфраструктуры; не равен полной процедуре deployment. |
make down |
Остановка локальной инфраструктуры с сохранением постоянных данных. |
make wait-db |
Ожидание готовности PostgreSQL. |
make bootstrap-superadmin |
Первоначальное создание администратора через терминал. |
make migrate |
Применение миграций. |
make backend-build |
Сборка Go backend. |
make backend-test |
Тесты Go backend. |
make admin-install |
Установка frontend-зависимостей по проектному контракту. |
make admin-build |
Подготовка зависимостей и сборка admin. |
make admin-test |
Подготовка зависимостей и проверки admin. |
make constraints-list |
Список ограничений, требующих внимания. |
make constraint-validate NAME=... |
Проверка одного именованного ограничения. |
make constraints-validate |
Проверка всех ожидающих ограничений. |
Для обычной работы используйте готовые dev/build/test. Внутренние этапы нужны главным образом для диагностики: запускать их в произвольном порядке вместо полного сценария не стоит.
Команды backend
Из backend/ можно запускать go run ./cmd/api, go run ./cmd/localsetup ensure-env, go run ./cmd/admin bootstrap-superadmin, go run ./cmd/migrate, go run ./cmd/constraints .... Если проект использует изображения, доступны также очистка и снимки медиа.
Команды читают окружение приложения. До запуска проверьте, к какой БД и профилю они подключатся.
Для первого администратора bootstrap принимает --login, --password-file и --if-needed. Строковые параметры по умолчанию пусты, --if-needed выключен. Пароль вводится через TTY либо защищённый файл, а не обычное значение CLI-флага. Порядок действий — первый вход.
У migrate есть --check, --verify и обычное применение без этих флагов. У constraints — list/validate/validate-all, --output text|json и --name. Их результаты и ошибки разобраны в миграциях.
Снимок изображений
Снимок медиа нужен для согласованной резервной копии. Прежде чем передавать --writers-frozen, остановите API и процессы очистки. Во время снимка никто не должен изменять записи или файлы.
| Параметр | Значение по умолчанию | Смысл |
|---|---|---|
--mode |
пусто | export, restore или verify-empty. |
--stage |
пусто | Абсолютный чистый путь к существующему каталогу; для export он пустой. |
--env |
пусто | Имя окружения, обязательное. |
--writers-frozen |
false | Явное подтверждение остановки процессов записи. |
--confirm-restore |
пусто | Для restore совпадает с именем окружения. |
--expected-identity |
пусто | Для restore — идентификатор медиа из точки восстановления: 64 шестнадцатеричных символа. |
--timeout |
30m | Положительное время ожидания, не более 24h. |
Verify-empty не принимает stage/restore-параметры; export — подтверждение restore. Очистка запускается отдельно с --limit от 1 до 100, по умолчанию 100. Не совмещайте её с созданием согласованного снимка.
Обычно согласование БД и файлов выполняет контроллер развёртывания. Ручное сочетание низкоуровневых команд требует самостоятельно выдержать этот порядок.
Связанные инструкции
Структура приложения настраивается в Generator UI, контент — в системе администрирования. Терминальные команды этой статьи нужны для процессов и обслуживания, а не для обычного редактирования записей.