Repository navigation
Expand file tree
/
Copy pathMakefile
More file actions
518 lines (465 loc) · 39.2 KB
/
Copy pathMakefile
File metadata and controls
518 lines (465 loc) · 39.2 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
SHELL := /bin/bash
MODULE := github.com/Floodww/RoutineOps
# VERSION здесь = ВЕРСИЯ АГЕНТА (файл AGENT_VERSION). Makefile собирает только агента и
# его пакеты (agent/msi/deb/rpm/pkg/publish-release); сервер+веб версионируются отдельно
# (файл VERSION в корне, читается Dockerfile). Имя переменной оставлено VERSION, чтобы
# `make <target> VERSION=<semver>` по-прежнему переопределял версию агента.
VERSION ?= $(shell cat AGENT_VERSION 2>/dev/null || echo 0.0.0)
LDFLAGS := -X main.version=$(VERSION)
# Числовая PE-версия для VERSIONINFO Windows-exe из VERSION (semver x.y.z); если
# VERSION не semver (напр. git-hash в dev-сборке) → 0.0.0. WI сравнивает именно
# FixedFileInfo: versioned-файл перезаписывает unversioned/старее при апгрейде MSI.
WINVER := $(shell echo "$(VERSION)" | grep -Eo '[0-9]+\.[0-9]+\.[0-9]+' || echo 0.0.0)
WV_MAJ := $(word 1,$(subst ., ,$(WINVER)))
WV_MIN := $(word 2,$(subst ., ,$(WINVER)))
WV_PAT := $(word 3,$(subst ., ,$(WINVER)))
GOVERSIONINFO := go run github.com/josephspurrier/goversioninfo/cmd/goversioninfo@v1.7.0
# Версия protoc, которой сгенерирован лежащий в репозитории контракт. Гейт в цели
# `proto` не даст перегенерировать другой версией: иначе строка версии в шапке
# скачет между машинами и даёт конфликт на пустом месте.
# Плагины пинятся отдельно: protoc-gen-go v1.36.11, protoc-gen-go-grpc v1.6.2.
#
# ВНИМАНИЕ, две РАЗНЫЕ строки версии одного и того же компилятора:
# protoc --version → "libprotoc 35.0" ← с этим сравнивает гейт
# шапка proto/agent.pb.go → "protoc v7.35.0" ← это пишет protoc-gen-go
# protoc-gen-go подставляет мажор из внутреннего представления (7.x), а CLI
# печатает номер релиза (35.0). Гейт обязан сравнивать с CLI-формой — иначе он
# падает на той самой машине, которой контракт и сгенерирован.
PROTOC_VERSION := 35.0
.DEFAULT_GOAL := help
# Пусто = УНИВЕРСАЛЬНЫЙ агент: release-ключ приезжает в ответе на enroll (модель
# универсального MSI/PKG). Вшить ключ конкретного деплоя можно только явно:
# RELEASE_PUBKEY=<base64> make build-win
#
# Раньше здесь стоял боевой ключ мейнтейнера, и `make build-win` + `make msi-exe`
# (msi-exe лишь копирует exe, не пересобирая) вшивали его в публичный MSI. У чужого
# деплоя такой агент молча терял self-update: вшитый ключ АВТОРИТЕТЕН и не обходится
# ключом из enroll (SEC-2), а `version`/`diag` при этом рапортовали «self-update
# включено». build/pkg/build-pkg.sh и release-darwin ключ и так не передают — Makefile
# теперь с ними согласован, а build/msi/README.md («по умолчанию переменная пуста»)
# наконец не врёт.
RELEASE_PUBKEY ?=
RELEASE_KEY ?= $(HOME)/release_ed25519.pem
# FileVault recovery-escrow — ENTERPRISE-фича (carve-out). Open-core агент её НЕ
# собирает (символов main.escrowRecipient/_Fpr нет; escrow не шлётся, age не в графе).
# Enterprise-сборка агента:
# make build-mac AGENT_TAGS=enterprise ESCROW_RECIPIENT=age1... ESCROW_RECIPIENT_FPR=<fpr>
# ESCROW_RECIPIENT_FPR получить enterprise-бинарём сервера: `routineops-server -escrow-fpr age1...`.
AGENT_TAGS ?=
ESCROW_RECIPIENT ?=
ESCROW_RECIPIENT_FPR ?=
# escrow-ldflags добавляются ТОЛЬКО в enterprise-сборке (иначе таргетят несуществующие
# символы). TAGSFLAG подставляет -tags, когда AGENT_TAGS задан.
ifeq ($(AGENT_TAGS),enterprise)
ifeq ($(ESCROW_RECIPIENT),none)
# Явный отказ от ВШИТОГО получателя — универсальная enterprise-сборка (один агент на всех
# покупателей). Символы остаются пустыми, получатель приезжает подписанной публикацией
# сервера (internal/agent/recipient: подпись релизным ключом деплоя + epoch). FileVault в
# таком агенте скомпилирован, но до первой публикации выключен — и это видно в `-version`.
# "none" именно СЛОВОМ, а не пустым значением: пустое — это забытая переменная, и её
# гейт ниже обязан продолжать ловить.
ESCROW_LDFLAGS :=
else
ESCROW_LDFLAGS := -X main.escrowRecipient=$(ESCROW_RECIPIENT) -X main.escrowRecipientFpr=$(ESCROW_RECIPIENT_FPR)
endif
else
ESCROW_LDFLAGS :=
endif
TAGSFLAG := $(if $(AGENT_TAGS),-tags $(AGENT_TAGS),)
# Guard: ESCROW_* без AGENT_TAGS=enterprise = молчаливая потеря пиннинга (символов
# в free-агенте нет, -X по несуществующему символу линкер игнорирует) → жёсткая
# ошибка в агентских таргетах (не глобально, чтобы env с ESCROW_* не ломал make up/logs).
check-escrow-tags:
@if [ "$(AGENT_TAGS)" != "enterprise" ] && [ -n "$(ESCROW_RECIPIENT)$(ESCROW_RECIPIENT_FPR)" ]; then \
echo "ОШИБКА: ESCROW_RECIPIENT/_FPR заданы без AGENT_TAGS=enterprise — escrow молча не попадёт в free-агент." >&2; \
exit 1; \
fi
@if [ "$(AGENT_TAGS)" = "enterprise" ] && [ "$(ESCROW_RECIPIENT)" != "none" ] && { [ -z "$(ESCROW_RECIPIENT)" ] || [ -z "$(ESCROW_RECIPIENT_FPR)" ]; }; then \
echo "ОШИБКА: AGENT_TAGS=enterprise, но ESCROW_RECIPIENT/_FPR пусты." >&2; \
echo "-X по пустой строке линкер отработает МОЛЧА, и enterprise-агент уедет с выключенным FileVault-escrow." >&2; \
echo "Задай оба: ESCROW_RECIPIENT=age1... ESCROW_RECIPIENT_FPR=<fpr>," >&2; \
echo "либо ESCROW_RECIPIENT=none — явный отказ от вшитого получателя (универсальная сборка:" >&2; \
echo "получатель приедет подписанной публикацией сервера)." >&2; \
exit 1; \
fi
# Guard: удалённый стол — enterprise-фича (роадмап, Этап 2), и доказывать это чтением
# build-тегов нельзя. Проверяются ОБА направления на реальных бинарях: во free-агенте
# кодов сеанса нет ни одного, в enterprise они есть.
#
# Почему по бинарю, а не по `go list -deps`: гард check-oss-no-enterprise.sh строит граф
# по ИСХОДНИКАМ и на enterprise-БИНАРЬ в build/ радостно печатает «open-core чист» — эта
# дыра уже описана в scripts/export-free.sh для escrow. Здесь она закрыта тем же способом.
#
# Токен — путь пакета: Go кладёт его в таблицы имён, поэтому он есть в бинаре тогда и
# только тогда, когда пакет реально слинкован. Коды причин (SCOPE_VIOLATION и прочие) на
# эту роль не годятся, и это выяснилось прогоном: линкер выбрасывает недостижимые строковые
# константы, а платформенные ветки на чужой ОС просто не компилируются — гейт был бы
# красным на исправном дереве. Путь пакета проверен на всех трёх ОС в обе стороны.
# Пакетов теперь два: захват (internal/agent/screen) и формат кадра
# (internal/screenframe, общий с сервером). Второй проверяется той же меркой не для
# симметрии: он появился отдельным пакетом ИМЕННО чтобы сервер не тащил платформенный
# захват, и ровно поэтому его легче всего случайно затянуть во free-граф.
#
# LC_ALL=C у greps по бинарям — не гигиена. В UTF-8-локали grep разбирает вход как текст
# и строку с невалидной последовательностью байт молча не сопоставляет; в бинаре таких
# последовательностей полно, и находка токена зависела бы от того, куда легли байты 0x0a.
# Опасная сторона здесь — «во free-бинаре токена нет»: гейт напечатал бы «free чист».
#
# Третьим шагом той же меркой меряется ТРЕКНУТЫЙ darwin-prebuilt. Проверки выше говорят
# только про свежесобранные бинари, а в поле и в публичный Free-срез уезжает файл из
# build/darwin — и он обязан быть open-core. Здесь он проверяется потому, что это дёшево
# (голый grep, никаких инструментов) и потому попадает в pre-push. MSI и PKG той же
# проверкой накрыты в scripts/check-installer-versions.sh: их надо распаковывать
# (msitools/bsdtar), в pre-push такой зависимости не место.
REMOTE_TOKEN := internal/agent/screen
FRAME_TOKEN := internal/screenframe
UNINSTALL_TOKEN := internal/agent/uninstall
check-remote-tags: ## Гейт §9.17: удалённого стола нет во free-сборке и есть в enterprise
@fail=0; \
for pkg in 'agent/screen' 'internal/screenframe'; do \
if go list -deps ./cmd/agent 2>/dev/null | grep -q "$$pkg\$$"; then \
echo "ОШИБКА: пакет $$pkg в графе FREE-сборки — удалённый стол утёк в open-core." >&2; \
fail=1; \
fi; \
if ! go list -deps -tags enterprise ./cmd/agent 2>/dev/null | grep -q "$$pkg\$$"; then \
echo "ОШИБКА: пакета $$pkg НЕТ в графе enterprise-сборки — фича отвалилась," >&2; \
echo " либо гейт проверяет не то. Зелёный гейт без этой проверки бесполезен." >&2; \
fail=1; \
fi; \
done; \
tmp=$$(mktemp -d); \
CGO_ENABLED=0 go build -o "$$tmp/free" ./cmd/agent/ >/dev/null 2>&1 || { echo "ОШИБКА: free-сборка не собралась" >&2; fail=1; }; \
CGO_ENABLED=0 go build -tags enterprise -o "$$tmp/ent" ./cmd/agent/ >/dev/null 2>&1 || { echo "ОШИБКА: enterprise-сборка не собралась" >&2; fail=1; }; \
for tok in "$(REMOTE_TOKEN)" "$(FRAME_TOKEN)"; do \
if [ -f "$$tmp/free" ] && LC_ALL=C grep -qa "$$tok" "$$tmp/free"; then \
echo "ОШИБКА: $$tok найден во FREE-БИНАРЕ." >&2; fail=1; \
fi; \
if [ -f "$$tmp/ent" ] && ! LC_ALL=C grep -qa "$$tok" "$$tmp/ent"; then \
echo "ОШИБКА: $$tok отсутствует в ENTERPRISE-БИНАРЕ — проверка по бинарю бесполезна." >&2; fail=1; \
fi; \
done; \
rm -rf "$$tmp"; \
if [ -f build/darwin/agent_darwin_arm64 ]; then \
sh scripts/agent-edition-guard.sh "" build/darwin/agent_darwin_arm64 "трекнутый darwin-prebuilt" || fail=1; \
else \
echo "ОШИБКА: нет build/darwin/agent_darwin_arm64 — трекнутый prebuilt пропал из дерева." >&2; fail=1; \
fi; \
[ "$$fail" -eq 0 ] || exit 1; \
echo "check-remote-tags: free чист (граф и бинарь), enterprise содержит фичу ✅"
# Гейт Этапа 3 (удаление ПО во Free): зеркало check-remote-tags, но в ОБРАТНУЮ сторону.
#
# Экран — enterprise, и его гейт доказывает ОТСУТСТВИЕ во free. Удаление ПО — наоборот:
# фича Free (агент лицензию не проверяет, гейт живёт на сервере), поэтому её половина на
# устройстве тегом НЕ заперта и обязана ПРИСУТСТВОВАТЬ в open-core. Нужен гейт именно на
# это: «агентская часть тегами не заперта» — предположение, а класс дефекта, ради которого
# всё делается, тихий. Стоит однажды повесить //go:build enterprise на пакет uninstall или
# на SetUninstaller в cmd/agent — и free-агент молча перестанет уметь снимать ПО, отвечая
# на задачу completed с пустым логом (ровно то, от чего заведён storage/capability.go).
#
# Токен — ПУТЬ ПАКЕТА, как и у экрана: Go кладёт его в таблицы имён, поэтому он есть тогда
# и только тогда, когда пакет слинкован; недостижимые строковые константы линкер выбросил
# бы. Проверка на графе И на бинаре (граф не ловит выброшенное линковкой, бинарь не
# объясняет причину — нужны оба).
#
# 🔴 Негативный контроль на ТОМ ЖЕ free-бинаре: токен экрана обязан ОТСУТСТВОВАТЬ. Он тут
# не дубль check-remote-tags, а единственное, что делает presence-гейт способным краснеть:
# grep, находящий что угодно, был бы зелёным всегда, а бинарь чужой редакции содержал бы
# оба токена. Один и тот же grep обязан сказать ДА про uninstall и НЕТ про screen — только
# тогда «да» про uninstall что-то значит.
check-uninstall-present: ## Гейт Этапа 3: удаление ПО ЕСТЬ во free-агенте (граф и бинарь) и в enterprise
@fail=0; \
if ! go list -deps ./cmd/agent 2>/dev/null | grep -q "$(UNINSTALL_TOKEN)\$$"; then \
echo "ОШИБКА: пакета $(UNINSTALL_TOKEN) НЕТ в графе FREE-сборки — удаление ПО выпало из open-core." >&2; \
echo " Обычная причина: на пакет или SetUninstaller в cmd/agent повесили тег enterprise." >&2; \
fail=1; \
fi; \
if ! go list -deps -tags enterprise ./cmd/agent 2>/dev/null | grep -q "$(UNINSTALL_TOKEN)\$$"; then \
echo "ОШИБКА: пакета $(UNINSTALL_TOKEN) НЕТ в графе ENTERPRISE-сборки." >&2; \
fail=1; \
fi; \
tmp=$$(mktemp -d); \
CGO_ENABLED=0 go build -o "$$tmp/free" ./cmd/agent/ >/dev/null 2>&1 || { echo "ОШИБКА: free-сборка не собралась" >&2; fail=1; }; \
CGO_ENABLED=0 go build -tags enterprise -o "$$tmp/ent" ./cmd/agent/ >/dev/null 2>&1 || { echo "ОШИБКА: enterprise-сборка не собралась" >&2; fail=1; }; \
if [ -f "$$tmp/free" ] && ! LC_ALL=C grep -qa "$(UNINSTALL_TOKEN)" "$$tmp/free"; then \
echo "ОШИБКА: $(UNINSTALL_TOKEN) отсутствует во FREE-БИНАРЕ — удаление ПО стёрто линковкой из open-core." >&2; fail=1; \
fi; \
if [ -f "$$tmp/ent" ] && ! LC_ALL=C grep -qa "$(UNINSTALL_TOKEN)" "$$tmp/ent"; then \
echo "ОШИБКА: $(UNINSTALL_TOKEN) отсутствует в ENTERPRISE-БИНАРЕ — проверка по бинарю бесполезна." >&2; fail=1; \
fi; \
if [ -f "$$tmp/free" ] && LC_ALL=C grep -qa "$(REMOTE_TOKEN)" "$$tmp/free"; then \
echo "ОШИБКА: $(REMOTE_TOKEN) найден во FREE-бинаре — либо это не free-редакция, либо presence-гейт слеп." >&2; fail=1; \
fi; \
rm -rf "$$tmp"; \
if [ -f build/darwin/agent_darwin_arm64 ]; then \
if ! LC_ALL=C grep -qa "$(UNINSTALL_TOKEN)" build/darwin/agent_darwin_arm64; then \
echo "ОШИБКА: $(UNINSTALL_TOKEN) нет в трекнутом darwin-prebuilt — mac-агент без удаления ПО." >&2; fail=1; \
fi; \
else \
echo "ОШИБКА: нет build/darwin/agent_darwin_arm64 — трекнутый prebuilt пропал из дерева." >&2; fail=1; \
fi; \
[ "$$fail" -eq 0 ] || exit 1; \
echo "check-uninstall-present: удаление ПО есть во free (граф и бинарь) и в enterprise ✅"
# Гейт: enterprise-агент СОБИРАЕТСЯ под все три ОС.
#
# Заведён по факту, а не на всякий случай. `internal/agent/screen` объявлял тип `rect`,
# и такой же тип (структура RECT из Win32) объявлял соседний capture_windows.go — пакет
# не компилировался под GOOS=windows ВООБЩЕ, то есть enterprise-агент нельзя было собрать
# для платформы, которую владелец назвал первой по приоритету. Не заметили этого ровно
# потому, что все существующие проверки собирают агента под ХОЗЯЙСКУЮ ОС: check-remote-tags
# и тесты идут на linux, публикуемый windows-бинарь — free (там пакета screen нет вовсе).
#
# Отсюда правило: платформенный код проверяется КРОСС-КОМПИЛЯЦИЕЙ, а не тем, что «у меня
# собралось». darwin проверяется в обеих ипостасях: CGO=0 — то, что уезжает
# кросс-компиляцией, CGO=1 — нативная сборка с Cocoa (плашка наблюдения и замок).
check-agent-platforms: ## Гейт: enterprise-агент компилируется под windows/linux/darwin
@fail=0; \
for os in windows linux darwin; do \
if ! GOOS=$$os CGO_ENABLED=0 go build -tags enterprise -o /dev/null ./cmd/agent 2>/tmp/agent-build-$$os.log; then \
echo "ОШИБКА: enterprise-агент не собирается под GOOS=$$os:" >&2; \
head -20 /tmp/agent-build-$$os.log >&2; \
fail=1; \
fi; \
done; \
if [ "$$(go env GOOS)" = "darwin" ]; then \
if ! CGO_ENABLED=1 go build -tags enterprise -o /dev/null ./cmd/agent 2>/tmp/agent-build-darwin-cgo.log; then \
echo "ОШИБКА: нативная (CGO) enterprise-сборка macOS не собирается:" >&2; \
grep -v 'duplicate libraries' /tmp/agent-build-darwin-cgo.log | head -20 >&2; \
fail=1; \
fi; \
else \
echo "check-agent-platforms: нативная CGO-сборка macOS пропущена (не на маке)"; \
fi; \
[ "$$fail" -eq 0 ] || exit 1; \
echo "check-agent-platforms: enterprise-агент собирается под все три ОС ✅"
.PHONY: help proto tidy fmt scan-free hooks agent mockserver build certs up down logs run-mock run-agent test clean \
pkg-linux pkg-deb pkg-rpm pkg-deb-arm64 pkg-rpm-arm64 \
build-win build-win-arm64 canary-win build-mac build-linux build-linux-arm64 build-all lint publish-release syso-win \
check-escrow-tags check-remote-tags check-uninstall-present
help: ## Список целей
@grep -hE '^[a-zA-Z0-9_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN{FS=":.*?## "}{printf " \033[36m%-17s\033[0m %s\n", $$1, $$2}'
scan-free: ## Проверить Free-срез на утечки — гейт ПЕРЕД пушем (секунды, без тулчейна)
@# Почему цель, а не «просто запусти скрипт»: на macOS скрипт запускаться ОТКАЗЫВАЕТСЯ
@# (нужен bash 4+ и GNU sed), то есть половина команды выполнить рекомендацию не может
@# в принципе. Здесь этот случай уводится в контейнер, и гейт становится одинаковым
@# для всех. В CI суперсета он же есть шагом, но Actions там лежат на биллинге —
@# сегодня работает только локальный прогон.
@if [ -n "$${BASH_VERSINFO:-}" ] && [ "$$(bash -c 'echo $${BASH_VERSINFO[0]}')" -ge 4 ]; then \
bash scripts/export-free.sh --scan-only; \
else \
echo "== bash 3.x/BSD userland — ухожу в docker (golang:1.26) =="; \
docker run --rm -v "$$PWD":/src -w /src golang:1.26 \
bash -c 'git config --global --add safe.directory /src && bash scripts/export-free.sh --scan-only'; \
fi
fmt: ## Отформатировать весь Go-код (gofmt). Прогоняйте перед пушем — это гейт CI.
gofmt -w .
hooks: ## Включить гейты репозитория: pre-commit (быстрое) + pre-push (тесты и линтеры)
@# core.hooksPath, а НЕ копия в .git/hooks: копия протухает молча — правку хука
@# получают только те, кто вспомнит переустановить. Здесь хук версионируется
@# вместе с кодом.
@git config core.hooksPath scripts/hooks
@chmod +x scripts/hooks/pre-commit scripts/hooks/pre-push
@echo "Хуки включены (core.hooksPath=scripts/hooks)."
@echo " pre-commit: gofmt + перегенерация proto + buf breaking. Обойти: git commit --no-verify"
@echo " pre-push: go test ./internal/server/..., golangci-lint (обе сборки), гейты web."
@echo " Обойти осознанно: SKIP_GATES=1 git push"
proto: ## Перегенерировать Go-код из proto (ОБЩИЙ файл — менять согласованно, ADR-4)
@# Версии зафиксированы намеренно. Шапка сгенерированных файлов содержит версию
@# компилятора, поэтому у двух разработчиков с разными protoc КАЖДАЯ перегенерация
@# дёргала строку туда-сюда: шумный дифф в общем контракте и ложные конфликты.
@# Кодоген через buf сюда не годится: корень модуля в buf.yaml = proto/, и дескриптор
@# получил бы имя agent.proto вместо proto/agent.proto (переименование файла в
@# реестре + 300 строк churn), а CI-джоба `buf breaking` прибита к subdir=proto.
@have=$$(protoc --version | awk '{print $$2}'); \
if [ "$$have" != "$(PROTOC_VERSION)" ]; then \
echo "protoc $$have, а контракт генерируется $(PROTOC_VERSION)."; \
echo "Поставьте нужную версию: https://github.com/protocolbuffers/protobuf/releases/tag/v$(PROTOC_VERSION)"; \
echo "(перегенерация чужой версией меняет шапку файлов и создаёт конфликт на ровном месте)"; \
exit 1; \
fi
protoc --go_out=. --go_opt=paths=source_relative \
--go-grpc_out=. --go-grpc_opt=paths=source_relative \
proto/agent.proto
tidy: ## Привести go.mod/go.sum в порядок (добавит pgx и пр.)
go mod tidy
agent: ## Собрать агент -> bin/agent
CGO_ENABLED=0 go build -ldflags "$(LDFLAGS)" -o bin/agent ./cmd/agent
mockserver: ## Собрать mock-сервер -> bin/mockserver
CGO_ENABLED=0 go build -ldflags "$(LDFLAGS)" -o bin/mockserver ./cmd/mockserver
cli: ## Собрать CLI конфигурации парка -> bin/routineops (см. docs/config-as-code.md)
CGO_ENABLED=0 go build -ldflags "$(LDFLAGS)" -o bin/routineops ./cmd/routineops
build: agent mockserver ## Собрать оба бинарника
certs: ## Сгенерировать dev-сертификаты. Агентский — задать DEVICE_ID=<uuid>
./scripts/gen-certs.sh $(DEVICE_ID)
up: ## Поднять PostgreSQL + Redis
docker compose up -d
down: ## Остановить окружение (данные сохраняются; -v для сброса схемы)
docker compose down
logs: ## Логи окружения
docker compose logs -f
run-mock: ## Запустить mock-сервер (нужны certs/server.* + certs/ca.crt и поднятый Postgres)
go run ./cmd/mockserver
run-agent: ## Запустить агент. Требует DEVICE_ID=<uuid> (тот же, что в certs)
@test -n "$(DEVICE_ID)" || { echo "укажи DEVICE_ID=<uuid>"; exit 1; }
ROUTINEOPS_AGENT_CERT=certs/agents/$(DEVICE_ID)/agent.crt \
ROUTINEOPS_AGENT_KEY=certs/agents/$(DEVICE_ID)/agent.key \
ROUTINEOPS_CA_CERT=certs/agents/$(DEVICE_ID)/ca.crt \
go run ./cmd/agent
test: ## Прогнать тесты
go test ./...
syso-win: ## Сгенерировать cmd/agent/rsrc_windows_amd64.syso: манифест + PE-VERSIONINFO из VERSION
# Манифест (UAC/longpath) И числовая PE-версия в одном .syso (два .syso не
# линкуются: "too many .rsrc sections"). FixedFileInfo=$(WINVER).0 — по нему WI
# решает перезапись файла при апгрейде MSI (versioned > unversioned/старее),
# иначе старый exe не заменялся в поле (баг апгрейда v23→v25).
$(GOVERSIONINFO) -64 -arm=false -o cmd/agent/rsrc_windows_amd64.syso \
-manifest cmd/agent/agent.manifest \
-ver-major $(WV_MAJ) -ver-minor $(WV_MIN) -ver-patch $(WV_PAT) -ver-build 0 \
-product-ver-major $(WV_MAJ) -product-ver-minor $(WV_MIN) -product-ver-patch $(WV_PAT) -product-ver-build 0 \
-file-version "$(WINVER).0" -product-version "$(WINVER)" \
-company RoutineOps -product-name "RoutineOps Agent" -description "RoutineOps Agent" \
-internal-name RoutineOps-agent -original-name RoutineOps-agent.exe \
cmd/agent/versioninfo.json
build-win: syso-win check-escrow-tags ## Кросс-компиляция агента для Windows amd64 (манифест + VERSIONINFO из syso-win)
# -H windowsgui: GUI-subsystem, чтобы трей в юзер-сессии не открывал консольное
# окно (его закрытие убивало агент). CLI-ветки re-attach'атся к консоли родителя
# через attachParentConsole (см. cmd/agent/console_windows.go).
GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -trimpath \
$(TAGSFLAG) -ldflags "$(LDFLAGS) -X main.releasePubKey=$(RELEASE_PUBKEY) $(ESCROW_LDFLAGS) -H windowsgui" \
-o bin/agent_windows_amd64.exe ./cmd/agent
# Имя канареечного артефакта: версия + редакция. Канареечные бинари лежат вне git (гейт
# среза не пускает enterprise в дерево), и «какой из них какой» больше неоткуда узнать.
CANARY_EXE := bin/agent_windows_amd64_v$(VERSION)$(if $(AGENT_TAGS),-$(AGENT_TAGS),).exe
canary-win: syso-win check-escrow-tags ## Канареечная сборка агента для Windows amd64 — БАЙТ В БАЙТ как деплойная
# Отдельная цель, а не флаг к build-win, потому что build-win собирает НЕ ТО, что
# уезжает в поле, и расхождение молчаливое с двух сторон:
#
# -s -w — деплой (update.sh, install.sh) стрипает, Makefile нет. Разница ~7,5 МБ
# на 17,3 МБ, то есть 43%. Ловится только сверкой размеров вручную, и
# один раз уже ловилась — на 2.6.8.
# -buildvcs=true — БЕЗ него ревизия не попадает в бинарь ВООБЩЕ (go build молча
# пропускает штамп, когда git недоволен каталогом), а `go version -m`
# просто не печатает трёх строк vcs.*. Именно ими и проверяется «собрано
# из коммита X» перед публикацией — без штампа проверять нечем, и отказ
# выглядит как «строк нет», а не как «сборка не та».
#
# build-win при этом остаётся как есть: его артефакт идёт в MSI, и менять вес
# установщика заодно с канарейкой — это две правки под одним именем.
#
GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -trimpath -buildvcs=true \
$(TAGSFLAG) -ldflags "-s -w $(LDFLAGS) -X main.releasePubKey=$(RELEASE_PUBKEY) $(ESCROW_LDFLAGS) -H windowsgui" \
-o $(CANARY_EXE) ./cmd/agent
@go version -m $(CANARY_EXE) | grep -E 'vcs\.|-tags=' || \
{ echo "ОШИБКА: в бинаре нет штампа vcs — «собрано из коммита X» проверять нечем." >&2; exit 1; }
# Грязное дерево — ОТКАЗ, а не строчка в выводе. Канарейка существует затем, чтобы по
# ней приняли КОММИТ; собранная поверх незакоммиченного (тот же нетрекнутый `*.license`
# в дереве, однажды уже давший +dirty) она отвечает на этот вопрос ложью. Нужен снимок
# дерева — build-win рядом и ничего не обещает.
@go version -m $(CANARY_EXE) | grep -q 'vcs.modified=false' || \
{ echo "ОШИБКА: дерево грязное (vcs.modified=true) — канарейка не соответствует ни одному коммиту." >&2; exit 1; }
@ls -l $(CANARY_EXE) | awk '{print "размер:", $$5}'
@sha256sum $(CANARY_EXE)
syso-win-arm64: ## Сгенерировать cmd/agent/rsrc_windows_arm64.syso (манифест + PE-VERSIONINFO для arm64)
# Отдельный .syso, а не переиспользование amd64-шного: Go подхватывает ресурс по
# СУФФИКСУ АРХИТЕКТУРЫ в имени файла, поэтому rsrc_windows_amd64.syso в arm64-сборку
# не попадёт вовсе — молча, без ошибки. Итог был бы: exe без манифеста (нет
# longpath/UAC) и без PE-VERSIONINFO, а по этой метке Windows Installer решает,
# заменять ли файл при апгрейде MSI.
$(GOVERSIONINFO) -arm -64 -o cmd/agent/rsrc_windows_arm64.syso \
-manifest cmd/agent/agent.manifest \
-ver-major $(WV_MAJ) -ver-minor $(WV_MIN) -ver-patch $(WV_PAT) -ver-build 0 \
-product-ver-major $(WV_MAJ) -product-ver-minor $(WV_MIN) -product-ver-patch $(WV_PAT) -product-ver-build 0 \
-file-version "$(WINVER).0" -product-version "$(WINVER)" \
-company RoutineOps -product-name "RoutineOps Agent" -description "RoutineOps Agent" \
-internal-name RoutineOps-agent -original-name RoutineOps-agent.exe \
cmd/agent/versioninfo.json
build-win-arm64: syso-win-arm64 check-escrow-tags ## Кросс-компиляция агента для Windows arm64
# Нативная сборка под ARM-ноутбуки (Snapdragon X, Surface). Эмуляция x64 на них
# работает, но у службы, которая живёт месяцами и лезет в реестр, WMI и SCM,
# нативный бинарь дешевле и предсказуемее.
#
# Артефакт на настоящем arm64-железе НЕ прогонялся — его нет ни у меня, ни на
# билд-боксе. Пока это сборка «собирается и линкуется», а не «проверено в поле»:
# перед публикацией в releases нужен полевой install/enroll на живой машине.
GOOS=windows GOARCH=arm64 CGO_ENABLED=0 go build -trimpath \
$(TAGSFLAG) -ldflags "$(LDFLAGS) -X main.releasePubKey=$(RELEASE_PUBKEY) $(ESCROW_LDFLAGS) -H windowsgui" \
-o bin/agent_windows_arm64.exe ./cmd/agent
build-mac: check-escrow-tags ## Кросс-компиляция агента для macOS arm64 (CGO=0: без Cocoa-замка и keychain)
GOOS=darwin GOARCH=arm64 CGO_ENABLED=0 go build -trimpath \
$(TAGSFLAG) -ldflags "$(LDFLAGS) -X main.releasePubKey=$(RELEASE_PUBKEY) $(ESCROW_LDFLAGS)" \
-o bin/agent_darwin_arm64 ./cmd/agent
build-mac-native: check-escrow-tags ## Нативная сборка для macOS с CGO (Cocoa-замок блокировки + настоящий keychain). Запускать НА маке.
CGO_ENABLED=1 GOOS=darwin go build -trimpath \
$(TAGSFLAG) -ldflags "$(LDFLAGS) -X main.releasePubKey=$(RELEASE_PUBKEY) $(ESCROW_LDFLAGS)" \
-o bin/agent_darwin_native ./cmd/agent
build-linux: check-escrow-tags ## Кросс-компиляция агента для Linux amd64
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -trimpath \
$(TAGSFLAG) -ldflags "$(LDFLAGS) -X main.releasePubKey=$(RELEASE_PUBKEY) $(ESCROW_LDFLAGS)" \
-o bin/agent_linux_amd64 ./cmd/agent
build-linux-arm64: check-escrow-tags ## Кросс-компиляция агента для Linux arm64
GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -trimpath \
$(TAGSFLAG) -ldflags "$(LDFLAGS) -X main.releasePubKey=$(RELEASE_PUBKEY) $(ESCROW_LDFLAGS)" \
-o bin/agent_linux_arm64 ./cmd/agent
build-all: build build-win build-mac build-linux build-linux-arm64 ## Собрать всё (сервер + агент 3 платформы)
# ── Linux-пакеты (.deb/.rpm) через nfpm ──
# Один nfpm.yaml на оба формата; арх/версия/бинарь передаются через окружение.
# Юнит systemd в пакет НЕ кладём — его генерит `enroll -install-service` (см.
# build/nfpm/nfpm.yaml). NFPM берётся из PATH или ~/go/bin.
NFPM ?= $(shell command -v nfpm 2>/dev/null || echo $(HOME)/go/bin/nfpm)
# pkg-linux собирает .deb и .rpm под amd64 и arm64 (4 артефакта в bin/).
pkg-linux: pkg-deb pkg-rpm pkg-deb-arm64 pkg-rpm-arm64 ## Собрать .deb+.rpm (amd64+arm64)
# nfpmPackage <arch> <bin> <format>: staging бинаря + сборка. Каталог staging и
# сгенерированный конфиг УНИКАЛЬНЫ per (arch,format) — иначе под `make -j`
# arm64-cp перетёр бы amd64-payload между cp и nfpm (amd64-пакет с arm64-ELF).
# src подставляется через sed (nfpm не разворачивает ${env} в glob src); пути
# scripts/src — repo-relative, nfpm резолвит их от CWD (корень репо).
define nfpmPackage
rm -rf build/nfpm/stage-$(1)-$(3)
mkdir -p build/nfpm/stage-$(1)-$(3)
cp $(2) build/nfpm/stage-$(1)-$(3)/RoutineOps-agent
sed 's#__SRC__#build/nfpm/stage-$(1)-$(3)/RoutineOps-agent#' build/nfpm/nfpm.yaml \
> build/nfpm/stage-$(1)-$(3)/nfpm.yaml
PKG_ARCH=$(1) PKG_VERSION=$(VERSION) $(NFPM) package -f build/nfpm/stage-$(1)-$(3)/nfpm.yaml -p $(3) -t bin/
endef
pkg-deb: build-linux ## .deb amd64
$(call nfpmPackage,amd64,bin/agent_linux_amd64,deb)
pkg-rpm: build-linux ## .rpm amd64
$(call nfpmPackage,amd64,bin/agent_linux_amd64,rpm)
pkg-deb-arm64: build-linux-arm64 ## .deb arm64
$(call nfpmPackage,arm64,bin/agent_linux_arm64,deb)
pkg-rpm-arm64: build-linux-arm64 ## .rpm arm64
$(call nfpmPackage,arm64,bin/agent_linux_arm64,rpm)
msi-exe: build-win ## Подготовить exe для сборки MSI: bin -> build/msi/mdm-agent.exe
cp bin/agent_windows_amd64.exe build/msi/mdm-agent.exe
@echo "Готово. Сборку MSI запускайте НА WINDOWS (WiX):"
@echo " pwsh build/msi/build-msi.ps1 -Version <x.y.z.b> [-PfxPath cert.pfx -PfxPassword ...]"
lint: ## Запустить golangci-lint
golangci-lint run ./...
# CHANNEL — канал выкатки (Q-52). Дефолт stable сознательно совпадает с дефолтом
# самой команды: забытая переменная обязана вести себя как до появления каналов, а не
# тихо посадить релиз в канарейку, откуда его никто не ждёт.
CHANNEL ?= stable
publish-release: ## Опубликовать релиз: make publish-release BINARY=./bin/agent_darwin_arm64 OS=darwin ARCH=arm64 VERSION=v1.0.0 [CHANNEL=beta]
@test -n "$(BINARY)" || { echo "укажи BINARY=<путь>"; exit 1; }
@test -n "$(OS)" || { echo "укажи OS=<darwin|linux|windows>"; exit 1; }
@test -n "$(ARCH)" || { echo "укажи ARCH=<amd64|arm64>"; exit 1; }
@test -n "$(VERSION)" || { echo "укажи VERSION=<semver>"; exit 1; }
go run ./cmd/publish-release \
-binary $(BINARY) -version $(VERSION) -os $(OS) -arch $(ARCH) \
-key $(RELEASE_KEY) -channel $(CHANNEL)
clean: ## Удалить собранные бинарники
rm -rf bin
pkg-mac: build-mac ## Создать .pkg установщик для macOS (архитектура arm64)
# build-pkg.sh пересобирает бинарь САМ (не переиспользует bin/agent_darwin_arm64
# от build-mac) — AGENT_TAGS + ESCROW_RECIPIENT/_FPR обязаны быть проброшены в его
# окружение, иначе enterprise .pkg молча соберётся free-агентом без escrow.
cd build/pkg && AGENT_TAGS="$(AGENT_TAGS)" ESCROW_RECIPIENT="$(ESCROW_RECIPIENT)" ESCROW_RECIPIENT_FPR="$(ESCROW_RECIPIENT_FPR)" ./build-pkg.sh $(VERSION) arm64
pkg-mac-native: build-mac-native ## Создать .pkg установщик для macOS (нативная сборка)
cd build/pkg && AGENT_TAGS="$(AGENT_TAGS)" ESCROW_RECIPIENT="$(ESCROW_RECIPIENT)" ESCROW_RECIPIENT_FPR="$(ESCROW_RECIPIENT_FPR)" ./build-pkg.sh $(VERSION) native
release-darwin: pkg-mac-native ## [МЕЙНТЕЙНЕР, НА МАКЕ] Собрать macOS-релиз и обновить артефакты в git
# Linux-прод не может собрать macOS-агента: cgo нужен для Cocoa-замка (lockui_darwin.go)
# и Keychain (keystore/provider_darwin.go); `CGO_ENABLED=0 GOOS=darwin` молча подставляет
# заглушки по тегам `!darwin || !cgo`. Поэтому релиз рождается здесь и едет в git.
# RELEASE_PUBKEY НЕ передаём: артефакты обязаны быть универсальными (ключ — из enroll).
@echo ""
@echo "Проверь и закоммить:"
@git status --short build/pkg/RoutineOps-agent.pkg build/darwin/ || true