Откуда берётся
Grafana в контейнере работает от пользователя с uid 472. Каталога ./grafana на новом сервере ещё нет —
Docker создаёт его сам, от root («Несуществующий путь в томе»). Grafana не может туда писать и падает, Docker
перезапускает её по кругу, в docker compose ps — Restarting (1):
GF_PATHS_DATA='/var/lib/grafana' is not writable.
mkdir: can't create directory '/var/lib/grafana/plugins': Permission denied
Обычное лечение — sudo chown 472:0 grafana на хосте. Это ручной шаг, который на следующем сервере забывают.
Как пишем
services:
grafana-init:
image: busybox:1.37
user: root
command: chown -R 472:0 /var/lib/grafana
volumes:
- ./grafana:/var/lib/grafana
grafana:
image: grafana/grafana:13.3.0
restart: unless-stopped
depends_on:
grafana-init:
condition: service_completed_successfully
volumes:
- ./grafana:/var/lib/grafana
grafana-init монтирует тот же каталог, делает chown от root и завершается. Условие
service_completed_successfully не даёт Grafana стартовать, пока grafana-init не завершится с кодом 0. Разовый сервис запускается
при каждом up -d — chown повторно ничего не ломает. В docker compose ps его нет, в ps -a — Exited (0).
После перезагрузки сервера Docker поднимает Grafana сам, без него: права уже записаны на диске.
Числа для chown берём из образа:
docker run --rm --entrypoint id grafana/grafana:13.3.0
# uid=472(grafana) gid=0(root) groups=0(root),0(root)
Почему не post_start
В compose есть хук post_start — команда внутри контейнера после его старта, и chown в нём напрашивается.
Но хук выполняется одновременно с приложением, порядок не гарантирован. Grafana падает через секунду, и хук
не успевает:
Error response from daemon: Container … is restarting, wait until the container is running
up -d выходит с кодом 1. Дальше Docker перезапускает контейнер сам, и хук больше не выполняется: хуки
запускает compose на своих up, start и restart. На docker restart и после перезапуска dockerd их
никто не запускает.
post_start годится, когда приложение может первые секунды обойтись без того, что делает хук.
Если не работает
up -d: service "grafana-init" didn't complete successfully: exit 1, Grafana в статусе Created
- Причина
chownупал — чаще всего путь в разовом сервисе не совпадает с путём у Grafana. Права не исправлены, и compose Grafana не запускает.- Делаем
- Смотрим
docker compose logs grafana-initи сверяем строкиvolumesу обоих сервисов.
После chown всё равно Permission denied
- Причина
- Не тот uid: у каждого образа свой пользователь. Пользователь в
.Config.Userбывает записан именем, аchownв busybox имён из чужого образа не знает. - Делаем
- Узнаём числа:
docker run --rm --entrypoint id <образ>— уadminer:5этоuid=100 gid=101.
Хук post_start пишет hook exited with status 127: … executable file not found in $PATH
- Причина
- Команда хука выполняется внутри образа приложения, а в минимальных образах нет ни
chown, ни shell. - Делаем
- Переносим команду в разовый сервис на
busybox.
Как проверить
ls -ldn grafana
# drwxr-xr-x 3 472 0 4096 … grafana
docker compose ps --format '{{.Service}} {{.Status}}'
# grafana Up 12 seconds
Up без Restarting, владелец каталога — 472 0. Страница входа отвечает примерно через 30 с: первый запуск
Grafana создаёт базу.