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

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

В этой статье

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

Если вы подключаетесь к компании на GHE.com:

  • Статистика сервера недоступна.
  • GitHub.com Действия недоступны.

Что происходит при 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.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.