Перейти к содержанию

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"