Виявлення

Перегляди pull request

Кожний pull request у підключеному репозиторії перевіряється відносно production, куди він розгортається, і ви дізнаєтеся про це до злиття.

Більшість інцидентів починаються зі зміни. Polylane переглядає кожний pull request у підключеному репозиторії відносно production-ресурсів, куди він розгортається, і публікує один коментар, який каже «pass» або «fail».

Що це дає

Агент читає diff і живі метрики, логи та відкриті проблеми ресурсів, куди розгортається репозиторій, а потім вирішує, чи може зміна зашкодити production. Ви отримуєте один коментар у pull request, необов'язкову перевірку Polylane production impact і тред у консолі з повним аналізом.

Як це працює

Відкриття pull request у гілку за замовчуванням, push у нього або позначення його готовим до перегляду починає перегляд його головного коміту. Чернетки не переглядаються.
Пізніший push замінює перегляд, що триває, тому оцінюється лише останній коміт.
Зміни, які торкаються лише документації, тестів або файлів CI, проходять без розслідування.
Polylane іде ребрами розгортання репозиторію до його production-ресурсів або, коли їх немає, переглядає відносно хмарних облікових записів робочого простору загалом.
Агент розслідує в треді і фіксує висновок pass або fail.
Один коментар на pull request редагується при кожному перегляді. Fail читається як Hold this merge з рівнем впливу та знахідкою; pass читається як Production impact unlikely або каже, чи очікується, що виправлення виявленої проблеми її вирішить. Коли пізніший push знімає застереження, коментар повертається до pass і повідомляє про це.

Агент також може запропонувати покращення спостережуваності як один пакетний перегляд із коментарями-пропозиціями або як stacked pull request. Вони ніколи не впливають на висновок.

Дії за результатами перегляду

Згадайте @polylane у коментарі до pull request, і Polylane відповість у тій самій розмові; учасники, які не є членами робочого простору, замість цього отримують примітку про доступ.

Що ви просите	Що відбувається
Запитання	Агент відповідає з треду перегляду, маючи докази перед собою.
Ще один погляд	Агент знову переглядає останній push і переоцінює висновок.
Виправлення	Polylane починає запуск виправлення і відкриває stacked pull request у гілку цього pull request, з посиланням у коментарі.

Вкладка Changes репозиторію в консолі перелічує кожний перегляд. Fail пропонує Fix with Polylane, що починає той самий запуск виправлення, і Dismiss, коли застереження не стосується справи: pull request і далі переглядається, але не отримує нових коментарів, доки ви не натиснете Restore.

Статус	Опис
In review	Polylane переглядає останній push.
Flagged	Перегляд знайшов застереження щодо production.
Passed	Застережень щодо production не знайдено.
Resolved	Пізніший push зняв застереження.
Dismissed	Учасник відхилив перегляд; pull request більше не отримує коментарів.

Налаштування

Перегляди увімкнено для кожного підключеного репозиторію. Settings > Pull request reviews вимикає їх для всього робочого простору і визначає, чи поширюються треди перегляду на тих, хто бачить pull request. У розділі Settings > Repositories вкладка Settings репозиторію додає три поля.

Поле	Опис
Review pull requests for production impact	Вимикає перегляди лише для цього репозиторію.
Pull request review instructions	Вільний текст, який агент читає при кожному перегляді: критичні для розгортання шляхи або питання, якими вже займаються інші перевірки.
Block merging on production concerns	Публікує перевірку Polylane production impact на кожному переглянутому pull request; вона не проходить при застереженні. Увімкнено за замовчуванням. Зробіть її обов'язковою в захисті гілок, щоб блокувати злиття.

Перевірка також завершується на комітах merge queue, оскільки pull request було переглянуто до того, як він потрапив у чергу. Висновок fail може надіслати лист Production Concern Found, вимкнений за замовчуванням у розділі Сповіщення.

Примітки щодо планів

Кожний план включає місячну кількість переглядів pull request; квоту плану Free наведено на сторінці Оплата та використання, а учасники отримують лист, коли вона вичерпується. Після вичерпання квоти консоль фіксує pull request як Production impact not verified, і в GitHub нічого не публікується.

Пов'язане

Репозиторії: підключення репозиторію та зв'язування його ресурсів.
Запуски виправлення: як тред перегляду доходить висновку.
Автовиправлення: pull request, які відкриває запуск виправлення.
Сповіщення: лист, який може надіслати невдалий перегляд.

Проблеми

Кожна проблема, яку Polylane виявляє або отримує від вашого алертингу, стає однією проблемою, над якою працює один запуск виправлення, чий тред розповідає всю історію.

Рекомендації

Поради щодо окремих ресурсів про неправильну конфігурацію, ризики для стійкості та прогалини у спостережуваності, кожна з виправленням, яке можна передати агенту.