Актуализация страниц о деплое и разработке + мелочи по оформлению

content/iptvc/site/deploy.md

@@ -110,28 +110,28 @@ docker compose down
 
 ## Сборка образа iptvc { id="image" }
 
-Для публикации образа используйте скрипт `iptvc/build-docker-image.sh`.
-
-Скрипт вычисляет версию из Git, собирает образы с тегами `iptvc:<тег>` и `git.axenov.dev/iptv/iptvc:<тег>`, а затем отправляет registry-тег в registry:
+Для сборки и публикации образа используйте цели Makefile в каталоге `iptvc/`:
 
 ```bash
 cd iptvc
-./build-docker-image.sh latest
+
+# Сборка одноархитектурного образа (linux/amd64 по умолчанию)
+make image
+
+# Сборка под arm64
+make image GOARCH=arm64
+
+# Сборка с указанием тега
+make image IMAGE_TAG=v1.2.3
 ```
 
-Для публикации релизного тега:
+Для публикации multi-arch манифеста (linux/amd64 + linux/arm64):
 
 ```bash
-./build-docker-image.sh v1.2.3
+make image-all
 ```
 
-По умолчанию скрипт собирает Linux-образ для `amd64`.
-
-Платформу можно изменить переменными окружения:
-
-```bash
-GOOS=linux GOARCH=arm64 ./build-docker-image.sh v1.2.3
-```
+Цель `image-all` всегда отправляет образ в registry — это ограничение `docker buildx`: multi-arch манифест нельзя загрузить в локальный Docker daemon.
 
 Перед публикацией войдите в registry, если это требуется вашей настройкой:
 
@@ -140,8 +140,8 @@ docker login git.axenov.dev
 ```
 
 !!! warning "Рабочее дерево Git"
-    Скрипт переключается на Git-тег, переданный первым аргументом, или на тег, возвращённый `git describe`.
-    Перед запуском сохраните локальные изменения и убедитесь, что нужный тег существует.
+    Версия и коммит вшиваются в бинарь из `git describe` и `git rev-parse` на хосте в момент запуска `make`.
+    Перед сборкой убедитесь, что рабочая копия чистая и находится на нужном теге или коммите.
 
 ## Обновление { id="update" }