Включение GitHub Connect для GHE.com

Включите GitHub Connect для совместного использования данных между GHE.com и ваш экземпляр GitHub Enterprise Server.

В этой статье

Вы можете получить доступ к дополнительным функциям и рабочим процессам для ваш экземпляр GitHub Enterprise Server путем включения GitHub Connect. См . раздел AUTOTITLE.

Если вы подключаетесь к организации на GHE.com, статистика сервера недоступна.{ % else %}:

  • Статистика сервера недоступна.
  • Чтобы использовать автоматическую синхронизацию лицензий пользователей, необходимо обновить до GitHub Enterprise Server версии 3.15 или более поздней.

Что происходит при включении GitHub Connect?

Если включить GitHub Connect, настройте подключение между ваш экземпляр GitHub Enterprise Server и корпоративной учетной записью для GitHub Enterprise Cloud. Подключение использует ПРОТОКОЛ HTTPS через порты 443 или 80 и защищается tls.

Включение GitHub Connect создает GitHub App, принадлежащих учетной записи предприятия на GitHub Enterprise Cloud. GitHub Enterprise Server использует учетные данные GitHub Appдля выполнения запросов к GitHub Enterprise Cloud.

GitHub Enterprise Server сохраняет учетные данные из GitHub App. Следующие учетные данные будут реплицированы на все узлы в среде высокого уровня доступности или кластерной среде и хранятся в любых резервных копиях, включая моментальные снимки, созданные GitHub Enterprise Server Backup Utilities.

  • Маркер проверки подлинности, действительный в течение одного часа
  • Закрытый ключ, который используется для создания нового маркера проверки подлинности

Необходимые компоненты

  • Административный доступ: вам нужен административный доступ к учетной записи предприятия в GHE.com и экземпляре GitHub Enterprise Server.

  • Требование к версии: экземпляр GitHub Enterprise Server должен запускать GitHub Enterprise Server 3.12 или более поздней версии.

  • Конфигурация прокси-сервера. Если используется прокси-сервер, разрешить подключение к следующим именам узлов GHE.com (замените SUBDOMAIN поддоменом вашего предприятия).

    • SUBDOMAIN.ghe.com
    • api.SUBDOMAIN.ghe.com
    • uploads.SUBDOMAIN.ghe.com

    См . раздел AUTOTITLE.

Шаг 1. Включение подключения к GHE.com

По умолчанию GitHub Connect подключает GitHub Enterprise Server к GitHub.com. Необходимо включить подключение экземпляра к поддомену вашего предприятия GHE.com.

Чтобы включить подключение, пользователь с административным доступом SSH к экземпляр GitHub Enterprise Server должен выполнить следующие задачи.

  1. SSH в ваш экземпляр GitHub Enterprise Server. Если экземпляр состоит из нескольких узлов, например, если настроен высокий уровень доступности или георепликация, передача осуществляется по SSH в основной узел. При использовании кластера можно использовать для передачи по SSH в любой узел. Замените HOSTNAME именем узла для экземпляра, именем узла или IP-адресом узла. Дополнительные сведения см. в разделе Доступ к административной оболочке (SSH).

    Shell
    ssh -p 122 admin@HOSTNAME

  2. Чтобы включить подключение экземпляра к GHE.com для GitHub Connect, выполните следующую команду. Замените SUBDOMAIN поддоменом для вашего предприятия на GHE.com, например octocorp.

    Shell
    ghe-config app.github.github-connect-ghe-com-enabled true
ghe-config app.github.github-connect-ghe-com-subdomain "SUBDOMAIN"

  3. Чтобы применить конфигурацию, выполните следующую команду.

    Note

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

    Shell
    ghe-config-apply

После завершения выполнения можно настроить GitHub Connect.

Шаг 2. Включение GitHub Connect

Чтобы включить GitHub Connect, необходимо быть владельцем предприятия для GitHub Enterprise Server и GitHub Enterprise Cloud.

Пользователи с учетной записью пользователя в обеих средах могут подключать учетные записи из экземпляр GitHub Enterprise Server.

  1. Войдите в ваш экземпляр GitHub Enterprise Server и GHE.com.

  2. В правом верхнем углу GitHub Enterprise Serverщелкните фото профиля, а затем выберите параметры Enterprise.

    Снимок экрана: раскрывающееся меню, отображаемое при щелчке фото профиля на GitHub Enterprise Server. Описан параметр "Параметры предприятия".

  3. На боковой панели учетной записи предприятия щелкните GitHub Connect.

  4. В разделе "GitHub Connect еще не включен" нажмите Включить GitHub Connect. Щелкнув включить GitHub Connect, вы соглашаетесь с Условия GitHub для дополнительных продуктов и функций.

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

  6. Выберите отдельные функции GitHub Connect, которые вы хотите включить. См . раздел AUTOTITLE.

Повторное подключение к GitHub.com

Если необходимо повторно изменить GitHub Connect для GitHub.com, необходимо перенастроить параметры.

  1. SSH в ваш экземпляр GitHub Enterprise Server. Если экземпляр состоит из нескольких узлов, например, если настроен высокий уровень доступности или георепликация, передача осуществляется по SSH в основной узел. При использовании кластера можно использовать для передачи по SSH в любой узел. Замените HOSTNAME именем узла для экземпляра, именем узла или IP-адресом узла. Дополнительные сведения см. в разделе Доступ к административной оболочке (SSH).

    Shell
    ssh -p 122 admin@HOSTNAME

  2. Выполните следующую команду.

    Shell
    ghe-config app.github.github-connect-ghe-com-enabled false

  3. Чтобы применить конфигурацию, выполните следующую команду.

    Note

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

    Shell
    ghe-config-apply

  4. Включите GitHub Connect для GitHub.com. См . раздел AUTOTITLE.