Enterprise Server 3.22 в настоящее время доступен в качестве кандидата на выпуск.

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

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

В этой статье

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

  • Параметр Server Statistics недоступен.
  • Автоматическая синхронизация пользовательских лицензий требует GitHub Enterprise Server версии 3.15 или выше.
  • Действия, от GitHub.com которых требуется GitHub Enterprise Server версия 3.20.6 или более поздней версии, или любой выпуск компонентов версии 3.21.0.

Что происходит при 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 ConnectGHE.comэкземпляр GitHub Enterprise Server должен быть в версии 3.12 или более поздней. Некоторые отдельные функции GitHub Connect требуют более поздних версий. См . раздел AUTOTITLE.

  • Конфигурация прокси-сервера: При использовании прокси-сервера разрешите подключение к следующим 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.comGitHub 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. Чтобы применить конфигурацию, выполните следующую команду.

    Примечание.

    Во время запуска конфигурации сервисы могут экземпляр 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.

  3. В верхней части страницы нажмите GitHub Connect.

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

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

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

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

При необходимости повторной GitHub ConnectGitHub.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. Чтобы применить конфигурацию, выполните следующую команду.

    Примечание.

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

    Shell
    ghe-config-apply

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