---
title: docker-service-administration (скилл) — что покрывает
created: '2026-09-29'
updated: '2026-09-29'
type: tech
namespace: personal
status: active
tags:
  - docker
  - skill
  - pruning
  - disk
related:
  - '[[personal/tech/docker-mac-disk-issues.md]]'
  - '[[personal/tech/docker_colima_setup.md]]'
---

# `docker-service-administration` (скилл) — карта покрытия

Зеркало скилла `skills/docker-service-administration/SKILL.md`. Нужно, чтобы не перечитывать
весь скилл при вопросе «а это где-то записано?».

## Секции скилла

| Секция | Тема |
|---|---|
| A | Service Containerization — перенос нативных сервисов в Docker, Dockerfile-паттерны |
| B | Compose Recovery — диагностика стека после ребута |
| C | Readiness Audit — что вообще можно контейнеризировать |
| D | Service Upgrade — мажорные апгрейды (Zulip 9→10→11) |
| E | Local Service Dockerization (RU) |

## ✅ Добавлено 2026-09-29 — Disk reclamation

Раздел «Disk reclamation» в Section A (Pitfalls). Ключевое:

### 🔴 Build cache живёт в VOLUME, а не в `builder prune`

```
docker builder prune -f           → освобождает только метаданные (1.9 ГБ)
docker rm -f buildx_buildkit_arm64builder0
docker volume rm buildx_buildkit_arm64builder0_state   → реальные 37.71 ГБ
```

📌 **Проверено 2026-09-29: освободило 41 ГБ** (VM disk 57 → 16 ГБ, 61% → 17%).
Мерить `colima ssh -- df -h /dev/vdb1`, **не** `docker system df` — тот врёт.
⚠️ Цена: builder уходит в `inactive`, следующая сборка с нуля.

### 🔴 `compose down` НЕ удаляет образ

`docker-compose down` убирает контейнер, образ остаётся. Нужен отдельный `docker rmi`.
В реальном кейсе так остались висеть `balda-executor:0.1.0` (**2.48 ГБ**) и `watchtower`.

### Safe-scope при чистке

| Команда | Вердикт |
|---|---|
| `docker image prune -f` | ✅ только dangling |
| `docker builder prune -f` | ✅ метаданные (+ volume отдельно) |
| `docker container prune -f` | ✅ только остановленные — но **сначала проверить** |
| `docker volume prune` | ❌ **удаляет тома с данными** (БД!) |
| `docker system prune -a` | ❌ сносит все неиспользуемые образы, включая рабочие |

🔴 **Никогда не чистить тома на хосте со stateful-сервисами.** Доказывать, что ничего живого
не задето, диффом списка контейнеров до/после (`comm -23 before after`).

⚠️ **Снос Watchtower = конец автообновлений образов на хосте.** Говорить об этом прямо.

## Связанные заметки

- [[personal/tech/docker-mac-disk-issues.md]] — Colima VM, структура диска, инцидент ENOSPC
- [[personal/tech/docker_colima_setup.md]] — установка Colima