Подключение

Репозитории

Подключите GitHub, и агенты смогут искать по вашему коду, запускать его, проверять каждый pull request и следовать за ним до инфраструктуры, в которую он деплоится.

Подключение репозитория даёт агентам ваш исходный код. Polylane индексирует его для поиска, запускает в песочнице, проверяет каждый pull request на фоне production и размещает репозиторий на топологии рядом с тем, что он деплоит.

Что это даёт

Агенты ищут код по ключевым словам и по смыслу, так что запрос вроде «повтор с экспоненциальной задержкой» приводит к нужному модулю, даже если этих слов в исходниках нет. Они запускают код репозитория в песочнице, когда этого требует расследование. Каждый pull request проверяется на фоне production-топологии и получает вердикт «pass» или «fail» в виде комментария.

На топологии репозиторий является узлом, соединённым рёбрами deploys_to с ресурсами, в которые он деплоится, и рёбрами defines с ресурсами, которые провизионирует его конфигурация. Когда агент расследует проблему на сервисе, он идёт по этим рёбрам прямо к коду, который туда выкатывается.

Подключение репозитория

Откройте Settings > Repositories в консоли и выберите Add repository. Add from GitHub устанавливает GitHub-приложение Polylane в вашу организацию и позволяет выбрать, какие репозитории Polylane может читать; подключённые репозитории синхронизируются по мере изменения кода.

Add public repository регистрирует публичный репозиторий GitHub по URL. Добавленные так репозитории не обновляются автоматически при изменении кода, поэтому для всего, что вы активно разрабатываете, предпочитайте GitHub-приложение. Разрешения приложения описаны на странице GitHub.

Страница репозитория

ВкладкаЧто делает
SettingsНастройки автофикса, ревью pull request'ов и сети песочницы для этого репозитория, описанные ниже.
ObservabilityPolylane проверяет репозиторий после каждой синхронизации и сообщает, насколько хорошо инструментирован его код: сколько обработчиков маршрутов отдают телеметрию и какие не отдают ничего. Каждую находку можно передать агенту кнопкой Ask Polylane to fix it.
ChangesИстория ревью pull request'ов для этого репозитория, каждое проверено на фоне production-топологии с вердиктом «pass» или «fail».
ResourcesОблачные ресурсы, которыми управляет этот репозиторий. Polylane связывает их по манифестам деплоя и метаданным провайдера, а то, что он не может определить, вы добавляете через Link resource. Ревью ограничивают своё расследование этими ресурсами, а пока они не связаны, рассматривают весь облачный аккаунт.
PropertiesСырая запись репозитория.

Настройки репозитория

НастройкаЧто контролирует
Open autofix pull requestsПревращает ли Polylane подтверждённые находки в pull request'ы в этом репозитории. Выключение останавливает новые; существующие pull request'ы остаются открытыми.
Review pull requests for production impactРасследуется ли каждый pull request на фоне production-топологии с комментарием-вердиктом.
Pull request review instructionsУказания для ревью, специфичные для репозитория, например какие пути критичны для деплоя или какие вопросы уже закрывают другие проверки.
Block merging on production concernsПубликует на каждом проверенном pull request проверку «Polylane production impact», которая падает, когда ревью находит риск. Сделайте эту проверку обязательной в branch protection, чтобы блокировать слияние. Включено по умолчанию.
Agent internet accessМожет ли агент делать исходящие сетевые запросы во время выполнения кода.
Domain allowlistNone, Common dependencies для реестров пакетов и языковых экосистем или All (unrestricted).

См. также

  • Ревью pull request'ов: что проверяет ревью и как читается вердикт.
  • Topology: граф, в который входит репозиторий.
  • Autofix: pull request'ы, которые Polylane открывает в подключённых репозиториях.
  • GitHub: разрешения приложения и что удаляет отключение.