Makefile Targets Reference
Полный справочник целей Makefile сгенерированного проекта.
Разработка
| Цель |
Описание |
make run |
Запуск приложения |
make build |
Сборка бинарника |
make generate |
Все генераторы (ogen, argen, jsonschema, моки) |
make ogen |
Генерация REST из OpenAPI |
make argen |
Генерация ActiveRecord |
make generate-mocks |
Перегенерация моков, каркас которых пишет генератор |
make mock |
Все //go:generate проекта, включая написанные вручную |
Моки и make generate
Для приложения с goat_tests и транспортом generator_type: ogen_client генератор
пишет каркас мока tests/{app}/mocks/{transport}/psg_doc_gen.go с директивой
//go:generate … mockgen … Handler. Мок отражает ogen-интерфейс, который генератор
пишет сам, поэтому generate-mocks входит в агрегатор generate — последним
пререквизитом, после generate-ogen. Любое изменение контракта, прошедшее через
make generate, оставляет мок согласованным с интерфейсом.
- Цель адресная (
go generate ./tests/{app}/mocks/...): пользовательские
//go:generate в остальном коде в гейт кодогенерации не попадают — для них есть
make mock.
- Перед mockgen цель выполняет
go mod tidy -e: mockgen загружает ogen-пакет через
граф модуля, поэтому импорты, только что добавленные генераторами, должны быть
разрешимы. На приведённом в порядок модуле это no-op. Флаг -e обязателен:
проект с goat_tests, запиненный на Go 1.24, не может разрешить транзитивные
otlptrace-импорты самого goat (их не даёт ни один модуль из go.mod, и tidy
выбирает релиз, требующий более новый toolchain) — к мокам это отношения не имеет,
а без -e роняло бы весь make generate. Ошибка не маскируется: если неразрешимы
именно ogen-импорты, следом падает mockgen.
make generate рассчитан на последовательный make; make -j generate не
поддерживается — порядок пререквизитов значим.
- У проекта без каркасов моков цель остаётся, но ничего не делает, и в
generate
не подключается.
Генераторы, объявленные проектом в секции generator, добавляют свои цели — по одной на
генератор (см. Свои генераторы):
| Цель |
Описание |
make install-{generator} |
Установка генератора; в зависимостях install-tools |
make generate-{generator} |
Вызов генератора на каждой его спеке; в зависимостях generate |
make lint-{generator} |
Линтер генератора; в зависимостях lint |
Тестирование
| Цель |
Описание |
make test |
Unit тесты с coverage |
make race |
Тесты с race detector |
make coverage |
HTML отчёт coverage |
make goat-tests |
GOAT интеграционные тесты |
make goat-tests-verbose |
GOAT тесты с подробным выводом |
make build_for_test-{app} |
Сборка бинарника для тестов |
Линтинг
| Цель |
Описание |
make lint |
Проверка изменений относительно main |
make lint-full |
Полный lint всего кода |
make lint-fix |
Автоисправление lint ошибок |
make install-lint |
Установка golangci-lint |
Дополнительные флаги golangci-lint передаются через переменную LINT_ARGS (по умолчанию пусто),
она подставляется во все три цели:
make lint LINT_ARGS='--build-tags=integration'
Docker
| Цель |
Описание |
make docker-build |
Сборка Docker образа |
make docker-build-{app} |
Сборка образа конкретного приложения |
make docker-push |
Push образа в registry |
make docker-up |
Запуск docker-compose |
make docker-down |
Остановка docker-compose |
make docker-logs |
Просмотр логов |
Dev Stand
Доступны при dev_stand: true:
| Цель |
Описание |
make dev-up |
Запуск dev окружения с OnlineConf |
make dev-down |
Остановка dev окружения |
make dev-restart |
Перезапуск |
make dev-rebuild |
Пересборка приложений |
make dev-drop |
Полный сброс (удаление volumes) |
Миграции БД
| Цель |
Описание |
make migrate-up |
Применить миграции |
make migrate-down |
Откатить миграции |
make migrate-status |
Статус миграций |
make migrate-create |
Создать новую миграцию |
Системные пакеты
Доступны при artifacts: [deb, rpm, apk]:
| Цель |
Описание |
make packages |
Сборка всех пакетов |
make deb-{app} |
Сборка .deb для приложения |
make rpm-{app} |
Сборка .rpm |
make apk-{app} |
Сборка .apk |
make install-nfpm |
Установка nfpm |
make upload-packages |
Загрузка пакетов |
make upload-deb |
Загрузка только .deb |
make upload-rpm |
Загрузка только .rpm |
make upload-apk |
Загрузка только .apk |
Утилиты
| Цель |
Описание |
make clean |
Очистка артефактов сборки |
make help |
Справка по целям |
make version |
Показать версию |
Переменные
Сборка
GOPROXY=... # Go proxy
GOPRIVATE=... # Приватные модули
CGO_ENABLED=0 # Статическая сборка
Docker
DOCKER_REGISTRY=... # URL registry
DOCKER_TAG=... # Тег образа
Dev Stand
DEV_ONLINECONF_ADMIN_PORT=8888
DEV_TRAEFIK_PORT=9080
DEV_POSTGRES_PORT=5432
DEV_GRAFANA_PORT=3000
Кастомизация
Добавьте свои цели ниже disclaimer-маркера:
# ==========================================
# GENERATED CODE - DO NOT EDIT ABOVE THIS LINE
# ==========================================
.PHONY: my-custom-target
my-custom-target:
@echo "Custom target"