Бинарные зависимости в проектах: единый подход для команды

Как стандартизировать установку инструментов (golangci-lint, goose, goreleaser и др.) в multi-ОС команде с помощью Makefile и локальных бинарников.

Опубликовано %d.%m.%Y

3 мин. чтения

Когда над проектом работает несколько человек - особенно с разными ОС (Linux, macOS, иногда даже Windows), - быстро возникает разнобой в инструментах:
один использует golangci-lint v2.5.0, другой - v2.7.2, третий вовсе забыл его обновить.
В итоге:

локально всё ок, а на CI - ошибки
goose migrate работает у одних, падает у других
коллеги тратят время на «а у меня не запускается»

Цель: сделать установку и версионирование бинарных (pre-compiled) зависимостей предсказуемой и воспроизводимой - без глобальных go install, brew или apt.

Почему именно бинарники?

Не требуют компиляции
Изолированы от глобального окружения
Контролируемая версия
Работает вне GOPATH

Предлагаемая структура

 
1
2
3
4
5
6
7
.
├── Makefile # точка входа и версии
├── bin # локальные бинарники (игнорируется в .gitignore)
└── scripts
    ├── install.mk # установка инструментов
    ├── generate.mk # (опционально) запуск линтеров
    └── tests.mk # (опционально) миграции через

Makefile: точка входа и управление версиями

 
1
2
3
4
5
6
7
LOCAL_BIN := $(CURDIR)/bin

LINT_VERSION := v2.6.1
GOOSE_VERSION := v3.16.0
GORELEASER_VERSION := v2.3.0

include scripts/*.mk

install.mk: установка бинарных файлов

 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
OS := $(shell uname -s | tr A-Z a-z)
ARCH := $(shell uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')

.prep_bin:
	mkdir -p ${LOCAL_BIN}

.install-lint:
	curl -Ls https://github.com/golangci/golangci-lint/releases/download/v${LINT_VERSION}/golangci-lint-${LINT_VERSION}-${OS}-${ARCH}.tar.gz | \
		tar xvz --strip-components=1 -C ${LOCAL_BIN} golangci-lint-${LINT_VERSION}-${OS}-${ARCH}/golangci-lint

.install-goose:
	curl -Ls https://github.com/pressly/goose/releases/download/${GOOSE_VERSION}/goose_${OS}_${ARCH} --output ${LOCAL_BIN}/goose
	chmod +x ${LOCAL_BIN}/goose

.install-goreleaser:
	curl -Ls https://github.com/goreleaser/goreleaser/releases/download/${GORELEASER_VERSION}/goreleaser_${OS}_${ARCH}.tar.gz | tar xvz -C ${LOCAL_BIN} goreleaser

.PHONY:install-deps
install-deps: \
	.prep_bin \
	.install-lint \
	.install-goose \
	.install-goreleaser

OS и ARCH определяются динамически, но можно переопределить:
make OS=linux ARCH=arm64 install-deps
Для Windows (если нужно) - добавьте обработку MINGW*/CYGWIN* в uname -s

Как использовать

1
make install-deps

Заключение

Управление бинарными зависимостями через Makefile - это просто, надёжно и масштабируемо.

Вы получаете:

единый стандарт для всей команды
воспроизводимость «на любой машине»
независимость от глобального окружения

А главное - меньше «а у меня работает».

Tutorial

go tooling make

Авторский пост защищен лицензией CC BY 4.0.