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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для назначений на уровне организации используйте команду Добавить пользователей в подписку Copilot для конечной точки организации.
Для прямого назначения пользователей на уровне предприятия (доступно только для Copilot Business) используйте команду Добавить пользователей в подписку 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 мгновенно или сначала проверить пользователя, например, проверить членство в определённой команде.

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

        [автозаголовок](/copilot/rolling-out-github-copilot-at-scale/driving-copilot-adoption-in-your-company)

        [автозаголовок](/copilot/rolling-out-github-copilot-at-scale/reminding-inactive-users)

        [автозаголовок](/copilot/rolling-out-github-copilot-at-scale/analyzing-usage-over-time-with-the-copilot-metrics-api)

        [AUTOTITLE](/enterprise-cloud@latest/admin/managing-accounts-and-repositories/managing-organizations-in-your-enterprise/managing-requests-for-copilot-business-from-organizations-in-your-enterprise)