У цей момент не треба сперечатися з терміновістю. Треба зупинити лише одну річ: першу перевірку на живому сайті. Якщо іншого місця для цього сценарію немає, це треба назвати вголос. Потім таке місце треба зробити, навіть якщо воно тимчасове й незручне.
Клієнт уже бачить збій: форма не проходить, сума рахується неправильно або сторінка відкривається порожньою. Після цього в чаті часто з’являється проста пропозиція: увечері швидко виправити все прямо на сервері, бо тестового середовища немає.
Тестове середовище тут не є розкішшю. Це просто окрема точка, де той самий запит проходить без участі клієнта. Коли такої точки немає, це вже частина інциденту.
1. Назвіть баг і окремо назвіть приховану частину
У чаті все часто стискають в одну фразу: продакшен зламаний, зараз буде правка без свідків, тестового середовища немає. Але це не одна обставина. Це три різні факти.
Перший факт — сам збій. Другий — відсутність місця для безпечної перевірки. Третій — зміна, яку ніхто не побачить у момент внесення. Саме третій пункт і треба відкинути, навіть якщо час тисне.
Такі рішення з’являються не через злий намір. Просто друге середовище сприймають як зайву роботу, а клієнт чекає зараз. Тому хтось заходить по SSH, міняє файл на сервері й не доводить зміну до репозиторію. Вранці вже важко показати, що саме змінилося і чому.
Перед будь-яким редагуванням зафіксуйте окремо:
2. Чому живий сайт не підходить для перевірок
На живому сайті вже є реальні замовлення, оплати та акаунти. Навіть дрібна на вигляд зміна може торкатися того самого шляху, який записує дані в базу, надсилає лист або звертається до платіжного сервісу. Наслідки тут часто видно не одразу, а після скарги від клієнта.
Швидкий погляд на сторінку теж мало що доводить. Екран може виглядати нормальним для того, хто вніс зміну. Але ту саму функцію пізніше використає задача за розкладом, експорт або інший розділ системи.
На успадкованих проєктах це особливо помітно. Одна команда колись правила все напряму, бо не мала другої копії. Наступна людина отримує не лише баг, а й страх щось чіпати. Відновлення починається з розуміння поточного стану, а не з ще однієї невидимої зміни.
Окремо варто сказати про бекапи. Копія, яку жодного разу не відновлювали, не є готовим планом порятунку. Це лише файл. Якщо правка зламає ще щось, перше відновлення не повинно відбуватися просто під час інциденту.
До рішення про виправлення поставте кілька простих запитань:
3. Що має з’явитися до самої правки
Щоб відмовитися від правки без свідків, не потрібен ідеальний двійник продакшену. Потрібне місце, де запускається саме той сценарій, який ви збираєтесь міняти.
Це може бути невеликий тестовий застосунок із недавньою копією потрібних таблиць. Це може бути відновлена копія на машині, яка не обслуговує клієнтів. Але це точно не фраза «я просто буду обережний на сервері».
Порядок простий. Взяти код із репозиторію. Підключити базу, яка не є бойовою. Відкрити екран зі збоєм. Побачити ту саму помилку на копії. Лише після цього міняти код і перевіряти результат.
Якщо баг на копії не відтворюється, його ще не зрозуміли достатньо добре. Якщо копія взагалі не запускається, це теж важливий висновок. У такій ситуації правка чекає, поки хтось не прибере перешкоду.
У Laravel-проєктах, які перейшли у спадок, зупинка часто стається на звичайних речах: немає environment-файлу, ключ оплати існує лише на сервері, назва бази жорстко вписана в код. Це не причина лізти в живі файли. Це причина записати блокери. Довший список для приймання проєкту — це прохід для передачі. Для сьогоднішнього вечора висновок вужчий: не ховайте зміну, поки базові перешкоди не названі.
Якщо таку нічну зміну просить агенція, цей самий список уже є частиною передачі. Це не внутрішня дрібниця розробника. Окремо про це йдеться в матеріалі про передачу з боку агенції.
4. Який вигляд усе одно має мати викладка
Коли копія вже дає правильний результат, живий сайт стає місцем релізу, а не місцем для проб. Це все ще може бути той самий вечір. Але різниця принципова: екран уже перевірений, зміна вже побачена, післярелізна перевірка вже визначена.
Дивитися треба не лише на сторінку, яку редагували. Треба дивитися й на шлях, де створюється заявка або проходять гроші. Якщо без справжньої картки не можна оформити замовлення, варто заздалегідь записати найближчу перевірку без руху коштів і спочатку пройти її на копії.
Після релізу має лишитися короткий слід.
Якщо розмова вже перейшла від помилки на сторінці до ідеї повного редизайну, ці теми краще розділити. Редизайн системи, яку можна міняти лише наживо, не зменшує ризик. Він просто додає більше файлів. Саме тому спочатку потрібні час і друге середовище. Про це окремо написано тут: що перевірити перед редизайном.
5. Замініть правку без свідків коротким планом
План — це не обіцянка бути уважними. План — це короткий список із відповідальними.
Спочатку в ньому має з’явитися клієнтський збій, місце для перевірки поза продакшеном і статус відновлення: воно вже перевірене чи ні. Потім — сама зміна, перевірка на копії та реліз із записаним повторним оглядом. Після цього — окрема задача на нормальне тестове середовище, щоб наступний інцидент не починався з порожнього місця.
Кожен рядок має мати власника.
На успадкованих бойових системах корисний порядок простий: спочатку побачити, що реально працює, потім зробити ризиковий шлях видимим, і лише тоді змінювати його. Нові функції можуть зачекати. Правка без свідків просто перевертає цей порядок.
Коли варто покликати спеціаліста
Екран, неправильний результат і питання «де це може впасти без клієнтів?» можна записати й без розробника. Але допомога потрібна тоді, коли ніхто не може запустити застосунок поза живим сервером, коли репозиторій або хостинг досі не ваші, або коли збій сидить на оплаті, нічному списанні чи спільній базі для кількох клієнтів, а в чаті пропонують лише редагування на бойовій машині.
Саме таку роботу я і беру: спочатку зробити шлях придатним для запуску в безпечному місці, потім змінити його на тій системі, яка у вас уже є.
Послуги охоплюють таке відновлення, роботу зі швидкістю та backend-системи з реальними клієнтами. Роботи — це ті самі ситуації, де результат стоїть поруч із дією, яка його дала. Коли ризикований сценарій працює лише на живому сайті, Приймання та підтримка Laravel починається з окремого середовища та кроку викладки, який можна повторити.
Якщо хочете другий погляд до сьогоднішньої правки, напишіть мені. Надішліть баг одним реченням і скажіть, чи існує хоч якесь друге середовище. Секретного у перший лист класти не потрібно.