Як обговорювати невдале розгортання в англійській мові

Неуспішна розмова про розгортання йде не так двома поширеними способами: занадто нечітка («щось зламалося, ми розглядаємо це») або занадто зосереджена на звинуваченні («хто це натиснув?») — жоден з них не допомагає команді відновлюватися швидше. Цей посібник містить інформацію з англійської мови, щоб обговорювати її точніше і продуктивніше.

Ключовий словник

** Стан розгортання ** — фактичне повідомлення про те, де розгортання знаходиться на даний момент (відновлено, у процесі, призупинено), яке буде вказано першим перед будь- яким поясненням причини. “Поточне стан: ми повернули до попередньої версії, і виробництво знову стабільне станом на 14:12.”

** Симптом невдачі ** — спостережуваний ефект невдачі розгортання (помилки, перерви, зниження продуктивності), описаний конкретно і відокремлений від будь- яких гіпотез щодо причини.

• “Симптомом був пік у 500 помилок на кінцевій точці отримання, що почався майже відразу після завершення розгортання.” *

** Корінь причини (проба проти підтвердження) ** — основна причина невдачі, яку слід чітко позначити як робочу гіпотезу доки вона не буде підтверджена, щоб уникнути твердження, що припущення є фактом.

• “Наша поточна теорія роботи полягає у відсутності змінної середовища у новому налаштуванні — це ще не підтверджено, тому розглядайте це як гіпотезу, а не остаточну відповідь.” *

** Радіус вибуху ** — обсяг того, що було дійсно вражено аварією (які служби, які користувачі, який відсоток трафіку), зазначено конкретно, а не залишено на припущення. “Радиус вибуху був обмежений потоком оплати - перегляд і сторінки облікового запису не були вражені протягом усього інциденту.”

** Безвинне розгортання ** — опис того, що сталося з точки зору процесу і системи, а не особи, яка викликала розгортання, щоб розмова зосередилася на запобіганні, а не на вини. “Це не про те, хто запустив розгортання — справжня прогалина полягає в тому, що ми не мали перевірки середовища стажування, яка б виявила це до того, як воно досягне виробничого рівня.”

** Крок усунення помилок ** — конкретна, конкретна дія, яку слід виконати, щоб запобігти повторенню тієї ж помилки, відмінна від простого виправлення негайного симптому. “Після негайного відновлення, крок відновлення полягає у додаванні перевірки налаштувань перед розгортанням, щоб цей клас помилок не міг знову потрапити до виробничого середовища.”

Звичайні фрази

• « Поточний стан: [відновлено / виправлено / у процесі], станом на [час]. »
• «Симптом, який ми побачили, був [спеціфічний спостережуваний ефект], починаючи приблизно з [час]»
• «Наша робоча гіпотеза є [причиною] — ще не підтверджена, все ще розслідується»
• «Радиус вибуху був обмежений [спеціфічним діапазоном] — [інші системи] не були вражені»
• “Крок відновлення, який ми робимо, це [спеціальні дії], щоб запобігти повторенню.”

Приклади висловлювань

Повідомлення про невдалу спробу розгортання у командному каналі:

• “Оновлення стану: розгортання 13: 45 спричинило стрімкий ріст кількості помилок у службі платежу на 500. Мы откатились назад в 13:58 и ошибки вернулись к исходному уровню. Розслідування кореневої причини триває — буде поділитись результатами після підтвердження. *

Обговорення причини без приписування вини: “Саме розгортання відбувалося за нашим звичайним процесом — фактичним недоліком було те, що наш конвеєр CI не зафіксував цю конкретну невідповідність налаштувань, що є проблемою процесу, яку ми повинні виправити, а не чимось специфічним для цього розгортання.”

Повідомлення про виправлення у наступному повідомленні: “Крім відновлення сервісу, ми додаємо автоматизований крок перевірки конфігурації до конвеєра, щоб подібне невідповідність було виявлено до розгортання, а не після — це конкретний виправлення, що виходить з цього інциденту.”

Професійні поради

• Виконати з ** стан розгортання **, а не пояснення — люди, які постраждали від невдачі, хочуть знати поточний стан, перш ніж вони хочуть знати, чому це сталося.
• Відокремте ** симптом ** від ** кореневої причини ** явно, і позначте причину як непевну доки вона не буде підтверджена — представлення припущення як факту має тенденцію вимагати незграбного виправлення пізніше.
• Вкажіть точно ** радіус вибуху ** — нечітка область дії (« деякі користувачі можуть бути вражені ») створює непотрібне тривога у порівнянні з конкретним, обмеженим описом.
• Тримайте обговорення в ** бездоганному форматі ** — описуйте процеси і системні прогалини, а не окремі дії, оскільки саме це насправді виробляє корисні кроки відновлення.

Практичні вправи

1. Написати перший рядок оновлення стану для невдалого розгортання, включаючи час.
2. Напишіть речення, яке відрізняє гіпотезу про початкову причину від підтвердженої гіпотези.
3. Написати крок виправлення, спрямований на запобігання повторення, а не лише на виправлення невідкладної проблеми.

Навигація по сторінках: описи сторінок

Успішно повідомляти про наслідки невдалого розгортання не просто про те, що * що * пішло не так; це про те, щоб зробити це з точністю і професіоналізмом. Для не рідних носіїв англійської мови це може бути особливо складним завдяки тонким відмінностям у фразуваннях, які значно впливають на тон і сприймається відповідальність. Сфокусуємося на розширенні вашого словника, а не просто на тому, щоб сказати «це зламалося». Розгляньте конкретну мову, яку використовують при повідомленні про інцидент, особливо коли ви прагнете до спільного, вирішення проблемного підходу, а не до такого, який зосереджений на приписуванні вини.

Однією з ключових областей є розуміння різниці між описом * проблеми * і повідомленням про те, що вона * зазнала невдачі *. Сказати “розгортання зазнало невдачі” може відразу ж звучати обвинувальним. Замість цього спробуйте фрази на кшталт «ми спостерігали несподівану поведінку» або «в розгорнутому середовищі були невідповідності». Це змінює фокус від остаточного судження до об’єктивного спостереження. Аналогічно, при детальному описі впливу, уникайте таких тверджень, як «це спричинило перерву в роботі». Нейтральнішим формулюванням є «сервіс пережив періодичну недоступність» - це менш емоційно заряджене і надає фактичну інформацію. Ви також можете використовувати такі терміни, як * залишкові ефекти * або * непередбачені наслідки *, якщо це необхідно, щоб продемонструвати ретельну оцінку ситуації.

Крім окремих фраз, звертайте увагу на те, як ви формулюєте свої прохання про допомогу. Замість того, щоб вимагати від когось виправити щось за допомогою « Вам слід відновити зміни! », спробуйте « Чи можемо ми розпочати відновлення до попередньої стабільної версії? » У цьому випадку використовується умовна мова і ввічливо запитується про дію. Аналогічно, у повідомленнях Slack або описах PR уникайте надмірно наголошених тверджень. Хорошим прикладом є: «Дослідження проблеми, коли користувачі повідомляють про періодичні помилки. Поки що програма працює правильно для підмножини користувачів. Ми працюємо над визначенням кореневої причини. “Зауважте, як це уникає негайного судження і чітко стверджує поточний стан, одночасно описуючи процес розслідування.

Нарешті, пам’ ятайте, що активне слухання і віддзеркалення мови, якою користуються ваші колеги, може бути надзвичайно корисним. Якщо хтось використовує фразу « вплив на доступність », спробуйте включити її до вашої власної відповіді, щоб показати, що ви розумієте його точку зору і берете участь у спільному розумінні ситуації. Практикування цих нюансових фраз не тільки покращить ваше спілкування, але також продемонструє професіоналізм і створить довіру у вашій команді — ключові елементи для успішного співробітництва, особливо під час стресових моментів, таких як проблеми з розгортанням.