Диагностика: найти и починить

Начните со состояния обоих сервисов. Если один из них не запустился вовсе, причина может быть в другом — от которого он зависит.

Журнал приложения называет путь, в который оно не может писать. Сравните его с тем, куда подключён том (docker compose config, раздел volumes сервиса app).

После первого исправления симптом сменится. Посмотрите столбец PORTS у web: в какой порт контейнера идёт пересылка, и какой порт слушает nginx?

Лист к главе 8. Скрипт меняет только compose.yaml в ~/docker-course/rpd-notes и перед этим сохраняет исправную копию в compose.yaml.before-break. Данные (том rpd-notes-data) не трогаются.

Исходное состояние: проект поднят с итоговым compose.yaml главы 7, сайт отвечает. Сохраните заметку, чтобы потом проверить, что она пережила ремонт: curl -sS -d 'До поломки' http://127.0.0.1:8080/notes.

Как устроен скрипт

1. Проверки — ничего не меняют. Скрипт откажется (Отказ: …, Ничего не изменено.), если:
   • уже есть compose.yaml.before-break — значит, поломка уже создавалась, и сохранённую исправную копию нельзя перезаписать;
   • compose.yaml не похож на исправный итоговый файл главы 7: нет condition: service_healthy, уже есть строка DATA_DIR, или строки, которые скрипт меняет, не найдены ровно по одному разу.
2. Подготовка. Копия создаётся без права перезаписи (set -o noclobber), затем меняется compose.yaml, результат сверяется, и проект перезапускается (docker compose up -d, не дольше 2 минут). При неожиданной ошибке скрипт останавливается и пишет, как вернуть исправный файл.

Чтобы тренировка была честной, запустите блок, не вчитываясь в него.

bash <<'BREAK'
rp_break() {
  fail() { echo "Отказ: $1"; echo "Ничего не изменено."; return 1; }
  cd ~/docker-course/rpd-notes 2>/dev/null || { fail "нет папки ~/docker-course/rpd-notes"; return 1; }
  [ -f compose.yaml ] || { fail "нет compose.yaml"; return 1; }
  [ ! -e compose.yaml.before-break ] || { fail "уже есть compose.yaml.before-break — поломка уже создавалась. Как вернуться или начать заново — ниже на странице"; return 1; }
  grep -q 'condition: service_healthy' compose.yaml || { fail "нужен итоговый compose.yaml главы 7"; return 1; }
  ! grep -q 'DATA_DIR' compose.yaml || { fail "в compose.yaml уже есть DATA_DIR — файл не исходный"; return 1; }
  [ "$(grep -c '^      STARTUP_DELAY: ${STARTUP_DELAY:-5}$' compose.yaml)" = 1 ] || { fail "строка STARTUP_DELAY не такая, как в главе 7"; return 1; }
  [ "$(grep -c '"127.0.0.1:${WEB_PORT:-8080}:80"' compose.yaml)" = 1 ] || { fail "строка порта web не такая, как в главе 7"; return 1; }
  command -v docker >/dev/null || { fail "не найден docker"; return 1; }

  (set -o noclobber; cat compose.yaml > compose.yaml.before-break) && cmp -s compose.yaml compose.yaml.before-break \
    || { echo "Ошибка: не удалось сохранить копию. compose.yaml не менялся."; return 1; }
  sed -i 's|^      STARTUP_DELAY: ${STARTUP_DELAY:-5}$|&\n      DATA_DIR: /srv/data|' compose.yaml \
    && sed -i 's|"127.0.0.1:${WEB_PORT:-8080}:80"|"127.0.0.1:${WEB_PORT:-8080}:8000"|' compose.yaml \
    && [ "$(grep -c 'DATA_DIR: /srv/data' compose.yaml)" = 1 ] && grep -q ':8000"' compose.yaml \
    || { echo "Ошибка после начала подготовки: compose.yaml изменён не так, как задумано."
         echo "Исправная копия — compose.yaml.before-break: cp compose.yaml.before-break compose.yaml"; return 1; }
  timeout 120 docker compose up -d 2>&1 | tail -1
  echo "Поломка готова. Проверьте: curl -sS http://127.0.0.1:8080/"
}
rp_break </dev/null
BREAK

Строка dependency failed to start: container rpd-app-1 is unhealthy перед «Поломка готова» — часть поломки, а не ошибка скрипта.

Как вернуться и как начать заново

• Вернуть исправный проект (например, если запутались): cp compose.yaml.before-break compose.yaml && docker compose up -d.
• Начать новую тренировку. Сначала верните исправный проект, затем переименуйте сохранённую копию — скрипт не перезаписывает её сам: mv compose.yaml.before-break "compose.yaml.before-break.$(date +%Y%m%d-%H%M%S)". После этого блок снова пройдёт проверки. Старые копии можно удалить вручную, когда они станут не нужны.

Лист ученика: 08-diagnostics.md.

Практика

Папка ~/docker-course/rpd-notes.

Симптом:

curl -sS http://127.0.0.1:8080/

curl: (7) Failed to connect to 127.0.0.1 port 8080 after 0 ms: Couldn't connect to server

Состояние:

docker compose ps -a --format 'table {{.Name}}\t{{.Status}}'

NAME        STATUS
rpd-app-1   Restarting (1) Less than a second ago
rpd-web-1   Created

web даже не запускался — он ждёт готовности app, а app падает. Начинать с app.

Журнал app:

docker compose logs app --tail 2

app-1  | notes: не могу писать в /srv/data: Permission denied

Приложение пишет в /srv/data, а том подключён в /data (docker compose config → у app target: /data). В environment появилась строка DATA_DIR: /srv/data. Причина 1 — переопределённый путь данных. Исправление — удалить эту строку из compose.yaml и применить:

docker compose up -d
curl -sS http://127.0.0.1:8080/

 Container rpd-web-1 Started
curl: (56) Recv failure: Connection reset by peer

Симптом сменился: web запущен, порт опубликован, но переслать некуда.

docker compose ps --format 'table {{.Name}}\t{{.Ports}}'

NAME        PORTS
rpd-app-1   8000/tcp
rpd-web-1   80/tcp, 127.0.0.1:8080->8000/tcp

Причина 2 — у web опубликован порт контейнера 8000, а nginx слушает 80 (80/tcp без стрелки). Исправление — в ports вернуть "127.0.0.1:${WEB_PORT:-8080}:80" и снова docker compose up -d.

Проверка:

curl -sS -i http://127.0.0.1:8080/ | grep -E 'HTTP|Server|X-App'
curl -sS http://127.0.0.1:8080/notes

HTTP/1.1 200 OK
Server: nginx/1.30.x
X-App: rpd-notes
До поломки

Заметка на месте: том не трогали. Точная версия в Server зависит от образа (у автора был заменитель с nginx 1.24).

Неверные пути: down -v (теряются заметки, причина остаётся), chmod 777 на что-либо внутри контейнера (путь /srv/data вообще не тот), docker compose restart вместо up -d (не применит изменения compose.yaml).

Воспроизведено: Docker Engine 29.8.2, Compose 5.5.1, образы-заменители.

Проверка понимания

1. Ответ 502 выдал nginx — значит, web работает и принимает запросы. Искать между nginx и приложением: журнал web (какой upstream и какая ошибка соединения), затем состояние и журнал app.
2. Контейнер — одноразовый экземпляр образа и настроек. Правка через exec живёт в его слое и пропадёт при следующем up -d с изменениями, обновлении образа или down. В файле проекта исправление сохраняется, попадает в Git и работает у всех, кто запустит проект.