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

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

В этой статье

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

В GHE.comфункции GitHub Connect не включают какие-либо функции, основанные на ресурсах на 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

    См. раздел "Настройка сервера веб-прокси исходящего трафика".

Шаг 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, которые вы хотите включить. См. раздел "Сведения о GitHub Connect".

Повторное подключение к 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. См. раздел "Включение GitHub Connect для GitHub.com".