Подключите сервис исходного кода

Дайте агенту доступ к контексту репозитория, выпусков и запросов для расследования. Он может читать недавние изменения, находить связанные проблемы и открывать проблему или pull request в нужном репозитории или проекте, когда предоставляемые вами учетные данные это позволяют.

Этот учебник охватывает GitHub, Azure DevOps и GitLab. Соединения исходного кода используют страницу Code Access (Builder > Code Access), а не управляемый мастер коннектора. В этой статье внимание уделяется деталям исходного кода: как каждый сервис аутентифицируется и как проверить соединение.

Необходимые условия

• Действующий агент SRE и доступ к sre.azure.com.
• Разрешение на настройку агента.
• Аккаунт в сервисе с доступом к репозиториям или проектам, которые агент должен прочитать.

Для сервисов уведомлений см. Подключить сервис уведомлений.

Соединители исходного кода

Разъём	Услуга	Authentication	Типичное использование
GitHub	GitHub и GitHub Enterprise Cloud	Приложение для самостоятельного GitHub (также поддерживаются OAuth и PAT для github.com)	Читайте репозитории, выпуски и pull requests между проектами и организациями; Создавайте проблемы или pull requests с одобрением
Azure DevOps	Azure DevOps	Управляемая идентичность (также поддерживаются OAuth и PAT)	Читайте репозитории и pull requests между проектами; Создавайте pull requests или рабочие задачи с одобрением
GitLab	GitLab	Личный маркер доступа (PAT)	Читайте репозитории, выпуски и запросы на слияние; Создавайте проблемы и комментарии с одобрением

GitHub и Azure DevOps представляют аутентификационные опции в виде радиокнопок. GitLab использует личный токен доступа.

Шаг 1: Открытый доступ к коду

1. Перейдите к sre.azure.com и выберите агент.
2. В левой боковой панели разверните Builder и выберите Code Access.
3. Выберите вкладку для вашего сервиса (GitHub, Azure DevOps или GitLab).
4. Выберите "Добавить репозиторий".

Шаг 2: Аутентифицировать

Диалог «Добавить репозитории » открывается с помощью трёхшагового мастера: выберите платформу → Аутентификовать → добавить репозитории. После каждого шага выбирайте Далее. На последнем этапе есть кнопка «Сохранить ».

GitHub

Используйте приложение «Bring your own GitHub App» для GitHub Enterprise Cloud или для охвата доступа по организации или установке.

1. В разделе «Методы входа» выберите «Принести своё собственное приложение GitHub».
2. Заполните поля настройки приложения, показанные мастером.
3. Нажмите кнопку Далее.

GitHub Enterprise Cloud (.ghe.com) требует подключения к приложению GitHub. Для github.com также поддерживаются ваш аккаунт (OAuth, если он настроен под вашу среду) или токен Personal access, хотя опция GitHub App предпочтительна для производственных сценариев для более детальных разрешений и видимости аудита.

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

Azure DevOps

Используйте управляемую идентичность для продакшн-приложения, что позволяет избежать долгоживущих учетных данных.

1. В разделе «Методы входа» выберите «Управляемую идентичность».
2. Заполните поля, показанные мастером, и убедитесь, что управляемая идентичность агента имеет доступ к проектам и репозиториям Azure DevOps, необходимым агенту.
3. Нажмите кнопку Далее.

Ваш аккаунт (OAuth) и аутентификация токенов доступа Personal Access также поддерживаются, но они лучше всего подходят для разработки, тестирования или сценариев, где управляемая идентичность нельзя использовать. Используйте самый узкий идентификатор или токен, который может читать проекты и репозитории, необходимые агенту.

После подключения агент может искать репозитории, читать pull requests и проверять рабочие элементы по вашим проектам.

GitLab

1. Вводите личный токен доступа GitLab (PAT).
2. Нажмите кнопку Далее.

Предоставьте PAT только те области, которые нужны агенту для доступа к репозиторию, выпуску и запросу слияния.

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

Сервис видит удостоверение личности, авторизировавшей соединение. Проблемы, комментарии и активность pull-запросов, которые создаёт агент, появляются в этом аккаунте.

Шаг 3: Добавить репозитории

Шаг «Добавить репозитории » показывает таблицу, где указано, какие репозитории индексируют агенты. Каждая строка — это один репозиторий.

1. Если ваш сервис Azure DevOps, сначала выберите project из выпадающего меню Azure DevOps Project. Столбец URL репозитория заполняется репозиториями в этом проекте.

2. В столбце URL репозитория выберите репозиторий из выпадающего меню или введите URL напрямую. Для GitHub и GitLab выпадающие списки репозиториев, к которым могут получить доступ к вашим учетным данным. Для Azure DevOps он перечисляет репозитории в выбранном проекте.

3. В столбце «Отображаемое имя » введите короткое имя, которое агент использует для обращения к репозиторию.

4. По желанию заполните столбец «Описание », чтобы агент получил больше контекста относительно того, что содержит репозиторий.

5. Если ваш сервис — Azure DevOps, а репозиторий очень большой, включите галочку «Удалённо». Агент использует поиск на удалённой копии с помощью искусственного интеллекта вместо локального клонирования. Репозитории клонируются с ограничением диска 100 ГБ; включение Remote позволяет избежать этого ограничения.

6. Чтобы добавить ещё один репозиторий, выберите « Добавить » и заполните следующую строку.

7. Когда таблица заполнена, выберите Сохранить.

Шаг 4: Подтвердите ситуацию

1. Откройте чат с вашим агентом.

2. Задайте прочитанный вопрос, например:

   List the open issues in the payments repository from the last week.
   

3. Проверьте карту инструментов, чтобы увидеть, как агент ищет по сервису и результаты возвратов, основанные на ваших данных.

Когда появляются результаты, ссылающиеся на ваш репозиторий, соединение работает от конца до конца.

Troubleshooting

Проблема.	Cause	Исправление
Поиск не возвращает результатов	Аккаунт не имеет доступа к проекту или репозиторию	Убедитесь, что аккаунт подключения видит проект или репозиторий, затем попробуйте снова.
Создание не удаётся из-за ошибки допуска	Токен или аккаунт не имеют область записи	Предоставьте необходимый объём токена или аккаунту, либо используйте учетные данные с доступом к записи.
GitHub Enterprise Cloud отклоняет соединение	GitHub Enterprise Cloud требует подключения к приложению GitHub	На странице доступа к коду отключите соединение GitHub, выберите «Добавить репозиторий», выберите GitHub, введите свой .ghe.com хост и выберите «Bring your own GitHub App» в качестве способа аутентификации.

Связанные материалы

• Подключите сервис уведомлений
• Подключите источник телеметрии
• Настройте управляемый разъём