Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы может все еще выполняться. Актуальные сведения см. в документации на английском языке.
All products
Веб-перехватчики и события

Поддержка этой версии GitHub Enterprise была прекращена 2023-03-15. Исправления выпускаться не будут даже при критических проблемах безопасности. Для повышения производительности, укрепления безопасности и новых функций установите последнюю версию GitHub Enterprise. Чтобы получить справку по обновлению, обратитесь в службу поддержки GitHub Enterprise.

Замена служб GitHub

В этой статье

Если вы по-прежнему используете устаревшие службы GitHub, узнайте, как перенести перехватчики службы в веб-перехватчики.

Мы заменили службы GitHub интеграцией с веб-перехватчиками. Это руководство поможет вам перейти на веб-перехватчики из служб GitHub. Дополнительные сведения см. в этой записи блога.

В качестве альтернативы службе электронной почты теперь можно начать использовать уведомления по электронной почте для отправки в репозиторий. Сведения о настройке Уведомления по электронной почте фиксации см. в разделе Сведения об уведомлениях по электронной почте для отправок в репозиторий.

Временная шкала прекращения поддержки

  • 1 октября 2018 г. : GitHub запретил пользователям устанавливать службы. Мы удалили службы GitHub из пользовательского интерфейса GitHub.com.
  • 29 января 2019 г. : в качестве альтернативы службе электронной почты теперь можно начать использовать уведомления по электронной почте для отправки в репозиторий. Сведения о настройке Уведомления по электронной почте фиксации см. в разделе Сведения об уведомлениях по электронной почте для отправок в репозиторий.
  • 31 января 2019 г. : GitHub прекратит доставку событий установленных служб на сайте GitHub.com.

Фон служб GitHub

Службы GitHub (иногда называемые перехватчиками событий) — это устаревший метод интеграции, где GitHub размещал часть служб интегратора через github-servicesрепозитория. Действия, выполняемые на GitHub, активируют эти службы, которые можно использовать для активации действий за пределами GitHub.

Поиск репозиториев, использующих службы GitHub

Мы предоставляем скрипт командной строки, который помогает определить, какие репозитории на устройстве используют службы GitHub. Дополнительные сведения см. в статье ghe-legacy-github-services-report.

Службы GitHub и веб-перехватчики

Основные различия между службами GitHub и веб-перехватчиками:

  • Конфигурация. Службы GitHub имеют параметры конфигурации для конкретной службы, а веб-перехватчики просто настраиваются путем указания URL-адреса и набора событий.
  • Пользовательская логика. Службы GitHub могут иметь пользовательскую логику для реагирования несколькими действиями в рамках обработки одного события, а веб-перехватчики не имеют пользовательской логики.
  • Типы запросов. Службы GitHub могут выполнять HTTP-запросы и запросы, отличные от HTTP, а веб-перехватчики — только HTTP-запросы.

Замена служб веб-перехватчиками

Чтобы заменить службы GitHub веб-перехватчиками:

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

  2. Измените конфигурацию в зависимости от способа использования служб GitHub:

    • Приложения GitHub. Обновите разрешения приложения и подписки на события, чтобы настроить приложение для получения соответствующих событий веб-перехватчика.
    • Приложения OAuth. Запросите области repo_hook и/или org_hook для управления соответствующими событиями от имени пользователей.
    • Поставщики служб GitHub. Попросите пользователей вручную настроить веб-перехватчик с соответствующими событиями, отправленными вам, или воспользоваться этой возможностью для создания приложения для управления данной функцией. Дополнительные сведения см. в разделе Сведения о создании приложений GitHub.

  3. Перемещение дополнительной конфигурации за пределами GitHub. Для некоторых служб GitHub требуется дополнительная настраиваемая конфигурация на странице конфигурации в GitHub. Если служба выполняет это, вам потребуется переместить данную функцию в приложение или использовать приложения GitHub либо OAuth, если это применимо.

Установка GitHub Enterprise Server

  • GitHub Enterprise Server версии 2.17: GitHub Enterprise Server версии 2.17 и более поздних версий не позволит администраторам устанавливать службы. Администраторы по-прежнему смогут изменять имеющиеся перехватчики событий и получать перехватчики событий в GitHub Enterprise Server версий 2.17–2.19. В качестве альтернативы службе электронной почты вы сможете использовать уведомления по электронной почте для отправки в репозиторий в GitHub Enterprise Server версии 2.17 и более поздних версий. Дополнительные сведения см. в этой записи блога.
  • GitHub Enterprise Server версии 2.20: GitHub Enterprise Server версии 2.20 и более поздних версий прекратит доставку всех событий установленных служб.

Выпуск GitHub Enterprise Server версии 2.17 будет первым выпуском, который не позволяет администраторам устанавливать службы GitHub. Мы будем поддерживать имеющиеся службы GitHub только до выпуска GitHub Enterprise Server версии 2.20. Мы также будем принимать критические исправления для службы GitHub, работающей на GitHub Enterprise Server, до 1 октября 2019 г.

Миграция с нашей помощью

Свяжитесь с нами, чтобы задать интересующие вас вопросы.

Как общий обзор процесс миграции обычно включает в себя:

  • определение того, как и где ваш продукт использует службы GitHub;
  • определение соответствующих событий веб-перехватчика, которые необходимо настроить, чтобы перейти на обычные веб-перехватчики.
  • Реализация структуры с помощью OAuth Apps или GitHub Apps. GitHub Apps предпочтительнее. Дополнительные сведения о том, почему предпочтительнее использовать GitHub Apps, см. в разделе Migrating OAuth Apps to GitHub Apps.