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

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

   

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".