Установка Admingen

Admingen устанавливается как готовая программа. В поставке два файла: admingen открывает визуальный редактор в браузере, а admingen-cli позволяет работать с той же моделью из терминала. Собирать генератор из исходников не нужно.

Быстрая установка через curl

Откройте терминал в любой удобной папке и выполните:

curl -fsSL https://downloads.admingen.dev/install.sh -o install-admingen.sh
bash install-admingen.sh

Первая команда сохраняет установщик в файл install-admingen.sh в текущей папке. Вторая запускает его: он определяет ОС и процессор, скачивает последний выпуск, проверяет контрольную сумму и устанавливает обе программы в ~/.local/bin. sudo не нужен. Файл установщика можно оставить для обновлений или удалить после установки.

Архивы первого выпуска 0.8.1 уже опубликованы. Установщик из этой инструкции появится после публикации следующего выпуска. Если скачивание install.sh возвращает 404, пока используйте установку из архива ниже. Homebrew и APT ещё недоступны.

Чтобы установить конкретную версию, вместо обычного запуска установщика выполните:

bash install-admingen.sh --version 0.8.1

При необходимости выберите другую папку: bash install-admingen.sh --install-dir "$HOME/bin". Установщик предложит добавить в PATH и эту папку. Параметр --base-url нужен только при использовании другого HTTPS-зеркала; для обычной установки его задавать не требуется.

После установки программа предложит добавить папку бинарников в PATH, чтобы команды работали из любой папки. Перед подтверждением она покажет точные файлы и добавляемый фрагмент. Для zsh это .zshrc (с учётом экспортированного ZDOTDIR), для Bash — .bashrc и используемый профиль входа. По умолчанию выбран отказ; файлы меняются только с вашего согласия. Повторная установка не добавляет тот же служебный блок ещё раз.

Если согласились, откройте новый терминал и выполните admingen --help. Текущий терминал автоматически не обновляется. Если отказались или ваша оболочка не поддерживается, установщик покажет ручную настройку PATH. Для установки без вопросов можно явно разрешить настройку командой bash install-admingen.sh --configure-path; флаг --no-modify-path запрещает изменения файлов оболочки. Далее переходите к разделу «Создайте первый проект» ниже.

Установка из архива

Если предпочитаете установить программы вручную, выполните три шага ниже.

1. Выберите архив для своего компьютера

Скачайте архив нужной версии для вашей ОС и процессора. Название платформы в имени архива помогает выбрать файл:

Ваш компьютер	Платформа
macOS, Apple Silicon: M1, M2 и новее	`darwin_arm64`
macOS, Intel	`darwin_amd64`
Linux, Intel или AMD, 64 бита	`linux_amd64`
Linux, ARM, 64 бита	`linux_arm64`

Выпуск для Windows пока не заявлен. Если вы не знаете тип процессора, выполните в терминале uname -m: arm64 или aarch64 означает ARM, x86_64 — Intel/AMD.

2. Распакуйте и проверьте запуск

Распакуйте архив обычным способом. Откройте терминал в полученной папке: в ней должны находиться оба файла, admingen и admingen-cli. Выполните:

chmod +x admingen admingen-cli
./admingen --help
./admingen-cli --help

Первая команда разрешает запуск файлов в macOS и Linux. Две следующие показывают справку: если она появилась, программы запускаются.

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

3. Сделайте команды доступными из папки проекта

Это позволит писать admingen, не указывая полный путь к программе. Из папки с распакованными файлами выполните:

mkdir -p "$HOME/.local/bin"
cp admingen admingen-cli "$HOME/.local/bin/"
export PATH="$HOME/.local/bin:$PATH"
admingen --help

Настройка PATH из этой команды действует в текущем терминале. Чтобы сохранить её для следующих запусков, добавьте строку ниже в файл настроек вашей оболочки: обычно ~/.zshrc для zsh в macOS или ~/.bashrc для Bash в Linux.

export PATH="$HOME/.local/bin:$PATH"

После сохранения откройте новый терминал. Установка в домашнюю папку не требует sudo.

Создайте первый проект

Установка генератора завершена. Продолжайте с руководства Первый проект: от модели до первой записи: там вы создадите папку проекта, откроете Generator UI и опишете первую сущность.

Генератор запускается локально, а его интерфейс открывается в браузере. Терминал с запущенным редактором нужно оставить открытым. Чтобы остановить редактор, нажмите Ctrl+C в этом терминале.

Для самого генератора Go, Node.js и Docker не нужны. Для сборки и запуска созданного приложения понадобятся Go, Node.js/npm, Make и Docker с Compose v2. Их подготовка описана в локальной разработке.

Как обновлять генератор

Остановите редактор и снова выполните bash install-admingen.sh, чтобы установить последний выпуск. Если файла установщика уже нет, сначала скачайте его командой из начала статьи. При ручной установке замените оба файла в ~/.local/bin файлами из нового архива. Проверьте запуск через admingen --help.

Замена программы сама по себе не изменяет проекты и БД. Генерацию файлов и применение миграций вы запускаете отдельно.

Если команда не запускается

command not found — проверьте PATH или запустите файл из его папки как ./admingen.
Permission denied — выполните chmod +x для обоих файлов.
Exec format error или Bad CPU type — выберите архив для своей ОС и архитектуры.
Браузер не открылся при запуске редактора — откройте вручную адрес, который программа вывела в терминале.