basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Права на каталог данных — разовым сервисом перед стартом

    Образ работает не от root, а каталог данных на хосте принадлежит root — приложение падает на записи. Перед приложением запускаем разовый сервис: он делает chown и завершается, а приложение стартует только после него. Права чинятся при каждом up -d, и на новом сервере ручной шаг не нужен.

    Откуда берётся

    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 создаёт базу.