basforge

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

    EN
    КонфигLinuxsystemd

    systemd: отложенный поочерёдный запуск compose-стеков

    На слабом сервере контейнеры, которые стартуют разом после загрузки, мешают друг другу: база не успевает подняться, приложения падают на подключении. Юнит systemd ждёт Docker, выдерживает паузу и запускает стеки по очереди.

    Из чего собрано

    Частей три:

    1. У стеков, которые запускает скрипт, — restart: on-failure, а не unless-stopped. Иначе Docker поднимет их сам, сразу и все вместе, и очередь потеряет смысл.
    2. Скрипт — список стеков в нужном порядке, с паузами.
    3. Юнит systemd — запускает скрипт после старта Docker.

    Юнит

    /etc/systemd/system/docker-delayed-start.service
    [Unit]
    Description=Delayed Start for Docker Compose Projects
    After=docker.service
    Requires=docker.service

    After — стартует после Docker. Requires — без Docker не запускается; если Docker остановят, остановится и юнит.

    [Service]
    Type=oneshot

    oneshot — «выполнился и закончил». У него тайм-аут на запуск по умолчанию выключен, поэтому длинные паузы в скрипте systemd не прервёт.

    ExecStartPre=/bin/sleep 60

    Минута, пока Docker поднимает свои unless-stopped-контейнеры и система успокаивается после загрузки.

    ExecStart=/opt/scripts/start-all.sh

    Сам скрипт. Ему нужен бит исполнения: chmod 755. Лежит в /opt/scripts/ — там скрипты всего сервера; скрипт одного стека держим в каталоге стека.

    RemainAfterExit=yes

    Отработав, юнит остаётся в состоянии active (exited) — по systemctl status видно, что он выполнился. Повторный systemctl start скрипт заново не запустит.

    [Install]
    WantedBy=multi-user.target

    Включается при обычной загрузке, после systemctl enable.

    Скрипт

    Порядок: сначала защита (CrowdSec), потом вход (Traefik), потом базы, потом приложения, остальное — в конце.

    /opt/scripts/start-all.sh
    #!/bin/bash
    
    echo "Запуск crowdsec..."
    cd /opt/crowdsec && docker compose up -d
    sleep 10
    
    echo "Запуск reverse proxy..."
    cd /opt/traefik && docker compose up -d
    sleep 10

    cd … && — если каталога нет, шаг пропускается. Без && compose запустился бы в текущем каталоге, то есть в предыдущем стеке. Паузы — по весу стека: защита и прокси поднимаются за секунды.

    echo "Запуск базы данных и кэша..."
    cd /opt/mariadb && docker compose up -d
    sleep 50
    Главное

    База на медленном диске после старта ещё несколько десятков секунд догружает буфер и проверяет журнал — ей пауза дольше.

    echo "Запуск nginx и WordPress..."
    cd /opt/project_root && docker compose up -d
    sleep 50
    # echo "Запуск panel..."
    # cd /opt/panel && docker compose up -d
    
    echo "Все контейнеры успешно запущены по очереди!"

    Скрипт — это список того, что должно работать. Временно ненужный стек комментируем здесь, иначе он поднимется после следующей перезагрузки.

    Установка

    Юнит храним в репозитории сервера (host/systemd/, «Конфиги серверов в git») и ставим оттуда:

    install -m 644 /opt/host/systemd/docker-delayed-start.service /etc/systemd/system/docker-delayed-start.service
    systemctl daemon-reload
    systemctl enable docker-delayed-start.service

    Как ещё можно упорядочить запуск

    Способ Что даёт Цена
    restart: unless-stopped у всех, без скрипта ничего не надо настраивать: Docker сам поднимает всё после загрузки всё стартует разом — на быстром диске и при запасе памяти это нормально
    depends_on с condition: service_healthy порядок «база, потом приложение» без пауз, по готовности работает только внутри одного compose-проекта
    on-failure + юнит со скриптом порядок и паузы между проектами — в одном файле если юнит выключен, стеки после перезагрузки могут не подняться
    юнит systemd на каждый стек с After= друг на друга у каждого стека свой статус в systemctl много файлов

    Что делают restart-политики после перезагрузки сервера:

    Политика После перезагрузки
    always поднимается всегда
    unless-stopped поднимается, если его не останавливали вручную
    on-failure[:N] поднимается, только если контейнер завершился с ошибкой; после штатной остановки при выключении — как повезёт с кодом выхода, полагаться нельзя
    no не поднимается

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

    После перезагрузки часть сайтов не открылась

    Причина
    У этих стеков restart: on-failure, а юнит выключен или скрипт упал.
    Делаем
    Смотрим systemctl is-enabled docker-delayed-start.service, systemctl status … и journalctl -u docker-delayed-start -b.

    После перезагрузки поднялся сервис, который должен стоять выключенным

    Причина
    Его шаг в скрипте не закомментирован.
    Делаем
    Комментируем шаг в start-all.sh — скрипт и есть список того, что должно работать.

    Поправили юнит — ничего не поменялось

    Причина
    systemd перечитывает юниты только по systemctl daemon-reload или при загрузке.
    Делаем
    Делаем systemctl daemon-reload.

    Скрипт ничего не запустил, а systemctl status показывает active (exited)

    Причина
    Повторный start не запускает oneshot с RemainAfterExit=yes.
    Делаем
    Нужен systemctl restart … или запуск скрипта руками.

    Сервер переехал на быстрый диск

    Причина
    Паузы подбирались под медленный диск.
    Делаем
    Паузы можно сократить или убрать. Они не обязательны, но и не мешают.

    Сервер сменил роль, стеков почти не осталось

    Причина
    Очередь запуска больше не нужна.
    Делаем
    Выключаем юнит (systemctl disable) и возвращаем стекам unless-stopped. Скрипт и юнит можно оставить в репозитории на будущее.

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

    systemctl is-enabled docker-delayed-start.service       # enabled
    systemctl status docker-delayed-start.service           # active (exited)
    journalctl -u docker-delayed-start -b                   # вывод echo из скрипта за эту загрузку
    docker ps --format 'table {{.Names}}\t{{.Status}}'      # всё ли поднялось