basforge

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

    EN

    Смонтировали отдельный файл — контейнер не видит правок

    Если в контейнер смонтирован отдельный файл (./nginx.conf:/etc/nginx/nginx.conf), то после git pull, sed -i или mv контейнер продолжает видеть старый. После такой правки контейнер перезапускаем, а скрипт, который обновляет файл, пишет поверх, в тот же файл.

    Почему контейнер видит старый файл

    Монтирование файла привязано к самому файлу — к inode, а не к имени. Изменить файл можно двумя способами:

    Способ Что происходит Контейнер видит изменения?
    записать в тот же файл: cp new file, cat new > file, >> тот же inode, новое содержимое да
    создать новый и подменить: git pull, git checkout, sed -i, mv new file, сохранение во многих редакторах новый inode под старым именем; старый удалён, но контейнер держит его нет

    Что с этим делаем

    • Конфиги, которые меняются через git, монтируем каталогом (./conf.d:/etc/nginx/conf.d:ro): каталог видит новые файлы в нём. Так Traefik и читает dynamic/.
    • Если файл всё же смонтирован отдельно, после git pull нужен docker compose restart <сервис>. nginx -s reload не поможет: nginx перечитает тот же старый файл.
    • Скрипт, который регулярно обновляет такой файл, пишет во временный, проверяет и копирует поверх — cp, не mv:
    tmp=$(mktemp); trap 'rm -f "$tmp"' EXIT
    generate > "$tmp"                               # собираем новое содержимое
    [ -f "$out" ] && cp "$out" "$out.prev"          # копия на случай отката
    cp "$tmp" "$out"                                # cp, а не mv: тот же inode — контейнер увидит
    if docker exec nginx nginx -t >/dev/null 2>&1; then
      docker exec nginx nginx -s reload
    else
      cp "$out.prev" "$out"                         # конфиг не прошёл проверку — возвращаем прежний
      exit 1
    fi

    Каталогом или файлом

    Как монтировать Когда
    каталог всё, что меняется: конфиги из git, файлы, которые обновляют скрипты
    отдельный файл, :ro файл почти не меняется (nginx.conf, php.ini), и после правки не жалко перезапуска
    отдельный файл, обновление поверх генерируемые списки (IP-адреса, блок-листы), когда перезапуск нежелателен

    Если не работает

    Обновили nginx.conf через git pull, сделали nginx -s reload — ничего не поменялось

    Причина
    git pull подменил файл новым, а контейнер держит старый. reload перечитывает тот же старый файл.
    Делаем
    docker compose restart nginx.

    Скрипт обновляет список адресов, reload проходит, а список в nginx старый

    Причина
    Скрипт пишет новый файл и делает mv: под старым именем оказывается другой файл, контейнер его не видит.
    Делаем
    Меняем mv на копирование поверх — cp, как в скрипте выше.

    Файл, который читает nginx, не меняется месяцами, а рядом растёт другой

    Причина
    Скрипт пишет не в тот путь.
    Делаем
    Сверяем путь в скрипте с путём в томе compose. Чтобы скрипт работал из любого каталога, в начале — cd "$(dirname "$0")".

    Поправили смонтированный файл в vim прямо на сервере — в контейнере старая версия

    Причина
    vim сохраняет через новый файл при backupcopy=no и, когда может, при auto — это значение по умолчанию у Vim.
    Делаем
    Сейчас поможет перезапуск. Чтобы не повторялось — правки через git и монтирование каталогом; в самом vim — :set backupcopy=yes.

    Как проверить

    Сравниваем содержимое на хосте и в контейнере:

    md5sum ./nginx.conf
    docker exec nginx md5sum /etc/nginx/nginx.conf     # должно совпасть