Раньше деплой перезапускал веб-сервер и обрывал всех, кто скачивал установщик. Замена небольшая: каталоги релизов, одно атомарное переименование, проверенный конфиг и мягкая перезагрузка. А детали, благодаря которым это работает, касаются inode, bind mount и одной настройки Caddy, которую мы сознательно не включили.
· 5 мин чтения
bitg.uz — статический сайт, но он раздаёт большие файлы: установщик для Windows, пакеты для Linux, пакет для macOS и apt-репозиторий. Вечером 12 ноября 2026 года деплой другого сайта на том же edge пересоздал общий веб-контейнер, и скачивание установщика bitg остановилось на 791 КБ. Короткую заметку об исправлении мы уже публиковали. Здесь — подробная версия: что было не так со старой схемой, зачем нужна каждая часть новой, как мы её проверяли и чего она по-прежнему не умеет.
Что раньше делал деплой
Старый деплой bitg.uz распаковывал новый сайт в каталог site/, сохранял предыдущий как site.prev/ и запускал docker compose up -d --force-recreate. Последний флаг пересоздаёт контейнер Caddy при каждом деплое. Docker отправляет старому контейнеру SIGTERM, а через стандартный таймаут остановки в десять секунд — SIGKILL. Любое скачивание, которому нужно больше времени, обрывается, и пользователь получает обрезанный установщик.
Пересоздание было не от лени. Сайт был единственным bind mount каталога ./site, и другого способа показать контейнеру новые файлы не было. Значит, исправление должно было менять структуру, а не только команду.
Ещё один урок мы получили до того, как написали код. Через несколько минут после первого обрыва второе скачивание остановилось на 861 КБ. Свалить это на ту же причину было бы легко. Но лог edge для этого запроса показал таймаут записи в сторону клиента, а все 22 тестовых скачивания из нашей собственной сети завершились полностью. Второй сбой был в соединении клиента, а не в деплое. Мы упоминаем это потому, что исправление, проверенное на чужой неисправности, ничего не доказывает.
Новая схема
Сайт теперь живёт в версионированных каталогах, а контейнер раздаёт то, на что указывает симлинк.
1ПроверкаНовый Caddyfile проверяется во временном контейнере без сети до любых изменений в рабочей системе.
2РаспаковкаСайт переносится в www/releases/<sha12>-<время> — каталог, который ещё не видел ни один запрос.
3ПодменаРядом с www/current создаётся новый симлинк и одним атомарным шагом переименовывается поверх него.
4ПерезагрузкаCaddy перечитывает конфиг на месте; уже открытые соединения сохраняют свои файлы.
5ОчисткаПоследние три релиза хранятся в www/history, более старые удаляются.
Рисунок 1
У каждого шага есть конкретная причина.
Деплой — это переименование.ln -sfn сам по себе не атомарен: он удаляет старую ссылку и создаёт новую, и между этими действиями может прийти запрос. Если сначала создать www/current.next, а затем выполнить mv -T www/current.next www/current, переключение превращается в один вызов rename(2). Каждый запрос видит либо старый релиз, либо новый, но никогда — отсутствующий каталог.
Открытые файлы сохраняют свой inode. Корень Caddy — /www/current, а симлинк разрешается в момент открытия файла. Скачивание, начавшееся до подмены, держит открытый дескриптор старого файла и продолжает отдавать данные из старого релиза, а новые запросы разрешают ссылку уже в новый. По этой же причине старые релизы не удаляются сразу.
В имени релиза есть время. Каталоги называются <первые 12 hex коммита>-<время UTC>. Поэтому повторный деплой того же коммита создаёт новый каталог, а не перезаписывает тот, который сейчас раздаётся.
Конфиг монтируется каталогом. Caddyfile заменяется так же: записывается conf/Caddyfile.next и переименовывается. Bind mount одного файла закрепляет исходный inode, и после переименования контейнер продолжал бы читать старый файл. Монтирование каталога conf/ позволяет контейнеру увидеть переименованный файл.
Проверка до подмены. Раньше сломанный Caddyfile укладывал сайт. Теперь деплой запускает caddy validate для нового файла в отдельном контейнере с --network none и останавливается, не трогая рабочую систему, если проверка не прошла.
Перезагрузка, а не перезапуск.caddy reload применяет новый конфиг через admin endpoint Caddy, который слушает только внутри контейнера и наружу не опубликован. Контейнер пересоздаётся только при изменении его определения в compose. На этот случай мы задали stop_grace_period: 15s, чтобы даже при пересоздании открытые скачивания получили немного времени.
Настройка, которую мы не включили
У Caddy есть параметр grace_period, ограничивающий, сколько сервер ждёт открытые соединения при остановке. Звучит как именно то, что нужно для работы без простоя. Мы сознательно его не задали: Caddy применяет его и при перезагрузке конфига, так что любое значение принудительно закрывало бы медленные скачивания посреди совершенно обычного деплоя. Без него перезагрузка ждёт, пока старые соединения завершатся сами. Ограничение на время остановки живёт в stop_grace_period Docker, и оно важно только при настоящем пересоздании.
Как мы проверяли
Перед продом мы прогнали новую схему на копии рабочего каталога в отдельном контейнере и сети на том же сервере.
Миграция. Первый деплой со старой структуры удалил site/, site.prev/ и старый Caddyfile верхнего уровня, направил www/current на новый релиз, и сайт ответил.
Деплой во время скачивания. Мы начали скачивание MSI с ограничением 300 КБ/с, затем задеплоили новый релиз, который заодно менял заголовок ответа. Скачивание завершилось со статусом 200 и 6 303 744 байтами, SHA-256 совпал с рабочим файлом. Новый запрос получил новый релиз и новый заголовок. Время запуска контейнера не изменилось.
Очистка. После ещё трёх деплоев осталось ровно три релиза, и current указывал на самый новый.
Общий edge получил такую же схему отдельным изменением: каталог релиза на каждый деплой, проверка через собственный compose-сервис edge, то же переименование, перезагрузка и автоматический возврат к предыдущему релизу, если перезагрузка не удалась. Edge читает корень документов из переменной окружения со значением по умолчанию — root * {$WEB_ROOT:/srv}, — так что старая структура образа продолжает работать, пока переменная указывает на текущий релиз. В проде скачивание длиной 76 секунд прошло сквозь деплой edge, завершилось с совпадающей контрольной суммой, а время запуска контейнера осталось прежним.
Ограничения
Смешанные версии в одной загрузке страницы. Если подмена попадёт между двумя запросами, HTML страницы может прийти из старого релиза, а CSS — из нового. Суффикс ?v=<sha> у ресурсов защищает от устаревшего кеша, но путь всё равно разрешается через current, поэтому старый файл он не закрепляет. Для статического сайта с небольшими изменениями мы это принимаем; как часто это случается, мы не измеряли.
Откат — это команда, а не кнопка. На bitg.uz откат означает вручную направить current на прежний релиз и перезагрузить Caddy. Автоматически откатывается только edge, и только если не удалась сама перезагрузка.
Нет проверки здоровья после деплоя. Деплой проверяет конфиг, но пока не запрашивает страницы после подмены и не откатывается при ошибках. После первого деплоя новой структуры мы вручную проверили короткий список URL.
У пересоздания всё равно есть предел. Когда меняется определение в compose, открытые скачивания получают 15 секунд, а не бесконечное время.
Одно измерение в проде. 76-секундное скачивание — один тест. Он показывает, что механизм работает, но это не статистика.
Изменение — около 66 строк shell. Ценность не столько в скрипте, сколько в знании того, какая операция атомарна, какой объект держит inode и какая дружелюбная на вид настройка свела бы всё на нет.
Повторите сами
Первая команда проверяет Caddyfile сайта так же, как это делает деплой, — в контейнере без сети; вторая показывает подмену симлинка на любой машине с Linux.