Во время инцидента легко смешать диагностику и ремонт. Если сразу поменять путь, порт и права, успешный результат не объяснит причину, а неудачу будет труднее отменить. Управляемое изменение начинается до редактора.
Назови ожидаемый эффект
До правки запиши: что сейчас наблюдается, какое значение считаешь неверным и какой запрос должен измениться. Удобная гипотеза предсказывает результат, который можно проверить за короткий интервал.
Отдели восстановление доступности от постоянного решения. Временное исключение backend может уменьшить ошибки, но оставляет снижение ёмкости и задачу ремонта реплики.
Сохрани именно действующую конфигурацию
Найди файл и include, которые реально используются. Копия похожего файла из старого релиза не является откатом текущего состояния. Сохрани права, владельца и способ применения вместе с исходной версией.
Диагностические снимки могут содержать внутренние адреса и секреты. Храни их внутри учебного окружения; в комментарий к статье достаточно отправить обезличенный фрагмент и своё объяснение.
sudo nginx -T
systemctl cat shop-apiПроверь синтаксис и границы изменения
Проверка nginx -t отвечает на вопрос о допустимости конфигурации. Она не делает запрос к каждому backend и не запускает JavaScript в браузере. Поэтому добавь прикладную проверку к плану, а не подменяй ею синтаксис.
Сравни изменённый фрагмент с исходным. Если diff включает посторонние значения, уменьши правку до проверяемого объёма. Чем меньше переменных меняется, тем яснее причинная связь.
sudo nginx -tПримени, наблюдай и реши об откате
Используй механизм, соответствующий изменению: конфигурация приложения, unit systemd и код релиза могут требовать разных действий. После применения повтори исходный запрос, проверь журнал и необходимые отрицательные сценарии.
Заранее задай условие отката: ошибка синтаксиса, новый отказ, потеря обязательного поведения или отсутствие ожидаемого улучшения. Откат возвращает известное состояние, но не гарантирует устранение первоначального инцидента.
От симптома к проверке
| Наблюдение | Следующая проверка | Как читать результат |
|---|---|---|
| Файл изменён, поведение прежнее | Используемый путь и применение | Процесс мог не получить новую конфигурацию. |
| Синтаксис корректен, запрос падает | Прикладная проверка и журнал | Синтаксис и работоспособность — разные проверки. |
| Появилась новая ошибка | Diff и условие отката | Сначала сохрани наблюдение и верни контролируемое состояние. |
Типовые ошибки
- Менять несколько независимых параметров сразу.
- Не знать, как приложение перечитывает конфигурацию.
- Считать откат доказательством исправления исходной проблемы.
Как доказать восстановление
- Есть исходное наблюдение, гипотеза и минимальный diff.
- Выбран правильный способ применения и выполнен прикладной тест.
- Условие отмены и результат проверки записаны.
МИНИ-ИНЦИДЕНТ
Одна успешная проверка из трёх
nginx -t успешен, reload принят, но запрос /api/orders по-прежнему 401. Можно ли закрыть инцидент? Какое сравнение выбрать дальше?
syntax: OK
reload: accepted
GET /api/orders: 401Разобрать ход диагностики
Нет: пользовательская операция не восстановлена. Сравни фактическое прохождение заголовка и контракт backend с гипотезой правки. Проверь, был ли изменён нужный location. Слепой второй reload не добавляет нового свидетельства.
ПРАКТИКУМ
Практикум: объясни данные и выбери действие
После одной правки улучшился один маршрут и сломался другой.
before: /api=502 /assets=200
after: /api=200 /assets=404
change: modified shared locationМожно ли назвать изменение успешным?
Сверить рассуждение
Восстановление одного пути сопровождается регрессией другого. Сравни область diff и критерии обязательного поведения до решения оставить правку.
Какой вопрос помогает сузить исправление?
Сверить рассуждение
Почему общая правка затронула статику, если гипотеза относилась к API? Проверь выбор location и необходимость отдельного правила.
Что проверять после отката?
Сверить рассуждение
Возврат к известной исходной картине и отсутствие новой регрессии. Исходный 502 может остаться: откат возвращает состояние, а не автоматически чинит причину.
ПРОВЕРЬ СЕБЯ
Какое изменение легче обоснованно отменить?
Показать объяснение
То, для которого известны исходная версия, границы diff, способ применения и критерий неуспеха. Малый размер сам по себе не заменяет этих условий.
Пока без комментариев. Поделись первым впечатлением или задай вопрос по теме.