Настройка процесса самообслуживания для получения лицензий GitHub Copilot

Узнайте, как пользователи могут сразу запросить лицензию и получить access.

В этой статье

Если вы включили GitHub Copilot в организации или предприятии, вы можете настроить рабочий процесс самообслуживания, чтобы разрешить пользователям запрашивать лицензии. Это позволяет распределять лицензии тем, кто их хочет, и позволяет быстро get started с Copilot.

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

В этой статье описаны два подхода вашей компании:

  • GitHub request access для Copilot Business, которая не требует настройки, но требует явного одобрения от администратора
  • Ваша собственная интеграция с API GitHub с API, который позволяет создавать собственный процесс с помощью мгновенных access

Подход 1: Используйте функцию «запрос access» GitHub

Если у вас есть план Copilot Business, члены организации могут запросить access Copilot на своей странице настроек. Затем владелец организации должны проверять и утверждать каждый запрос.

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

  1. Владелец организации или предприятия гарантирует, что Copilot Business включен в организации, где вы хотите управлять access.
  2. Члены организации заходят на страницу своих личных настроек по адресу https://github.com/settings/copilot и нажимают Попросите администратора access.
  3. Владелец организации проверяет и утверждает запросы на странице "Запросы от членов" в организации. См. Управление запросами на GitHub Copilot Business в вашей организации.

Вам следует настроить процесс, при котором запросы регулярно рассматриваются, чтобы заинтересованные пользователи могли быстро получить access Copilot.

Пользователи также могут запрашивать access у организаций, где Copilot Business не включён. В этом случае владелец организации будет предложено попросить владельца предприятия включить Copilot для организации.

Подход 2. Интеграция с API

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

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

Например, вызов API в рабочем процессе GitHub Actions может выглядеть следующим образом, где организация и выбранные имена пользователей предоставляются контекстом триггера рабочего процесса:

const { Octokit } = require("@octokit/action");
const octokit = new Octokit();
const response = await octokit.request('POST /orgs/{org}/copilot/billing/selected_users', {
  org: context.repo.owner,
  selected_usernames: [context.payload.sender.login],
  headers: {
    'X-GitHub-Api-Version': '2022-11-28'
  }
})

Примеры реализаций

  • Вы можете создать процесс полностью внутри GitHub, чтобы пользователи создавали задачи для запроса access, а затем используя рабочий процесс GitHub Actions для вызова API. Для демонстрации этого подхода смотрите репозиторий microsoft/GitHubCopilotLicenseAssignment. Обратите внимание, что это внешний пример, который не охватывается Служба поддержки GitHub.
  • Вы можете добавить кнопку «Запросить access» в профили пользователей на внутреннем сайте вашей компании, которая передаст имя пользователя GitHub в API. Вы можете предоставить access мгновенно или сначала проверить пользователя, например, проверить членство в определённой команде.

Дополнительные материалы