Como habilitar o GitHub Connect no GHE.com

Você pode acessar recursos e fluxos sua instância do GitHub Enterprise Server de trabalho adicionais habilitando GitHub Connect. Confira Sobre GitHub Connect.

Ao se conectar a uma empresa em GHE.com:

as Estatísticas do Servidor não estarão disponíveis.
GitHub.com as ações não estão disponíveis.

O que acontece quando GitHub Connect está habilitado?

Ao habilitar o GitHub Connect, você configura uma conexão entre o sua instância do GitHub Enterprise Server e uma conta corporativa do GitHub Enterprise Cloud. A conexão usa HTTPS nas portas 443 ou 80 e é protegida pelo TLS.

Habilitar o GitHub Connect cria um GitHub App de propriedade da conta corporativa no GitHub Enterprise Cloud. O GitHub Enterprise Server usa as credenciais do GitHub App para fazer solicitações ao GitHub Enterprise Cloud.

O GitHub Enterprise Server armazena as credenciais do GitHub App. As credenciais a seguir serão replicadas em todos os nós em um ambiente de alta disponibilidade ou de agrupamento e armazenadas em qualquer backup, incluindo instantâneos criados por GitHub Enterprise Server Backup Utilities.

Um token de autenticação válido por uma hora;
Uma chave privada, que é usada para gerar um novo token de autenticação

Pré-requisitos

Acesso administrativo: Você precisa de acesso administrativo a uma conta corporativa em GHE.com e a uma instância do GitHub Enterprise Server.
Requisito de versão: Sua GitHub Enterprise Server instância deve ser executada GitHub Enterprise Server 3.12 ou posterior.
Configuração de proxy: Se estiver usando um servidor proxy, permita a conectividade com os nomes de host a seguir GHE.com (substitua SUBDOMAIN pelo subdomínio da sua empresa).
- SUBDOMAIN.ghe.com
- api.SUBDOMAIN.ghe.com
- uploads.SUBDOMAIN.ghe.com
Confira Configurando um servidor proxy Web de saída.

Etapa 1: Habilitar a conexão para GHE.com

Por padrão, GitHub Connect conecta-se GitHub Enterprise Server a GitHub.com. Você deve habilitar sua instância para se conectar ao subdomínio da sua empresa.GHE.com

Para habilitar a conexão, alguém com acesso administrativo por SSH a sua instância do GitHub Enterprise Server deve concluir as tarefas a seguir.

Conecte-se via SSH ao sua instância do GitHub Enterprise Server. Se sua instância for composta por vários nós, por exemplo, se a alta disponibilidade ou a replicação geográfica estiver configurada, efetue SSH no nó primário. Se você usar um cluster, poderá efetuar SSH em qualquer nó. Substitua HOSTNAME pelo nome do host da instância ou pelo nome do host ou endereço IP de um nó. Para saber mais, confira Acessar o shell administrativo (SSH).
Shell
```
ssh -p 122 admin@HOSTNAME
```
```
ssh -p 122 admin@HOSTNAME
```

Para permitir que sua instância se conecte a GHE.com para GitHub Connect, execute o comando a seguir. Substitua SUBDOMAIN pelo subdomínio da sua empresa no GHE.com, por exemplo octocorp.

Shell

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

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

Para aplicar a configuração, execute o comando a seguir.

Observação

Durante uma execução de configuração, os serviços sua instância do GitHub Enterprise Server podem ser reiniciados, o que pode causar um breve tempo de inatividade para os usuários.
Shell
```
ghe-config-apply
```
```
ghe-config-apply
```

Após a conclusão da execução, você pode configurar GitHub Connect.

Etapa 2: Habilitar GitHub Connect

Para habilitar GitHub Connect, você deve ser proprietário da empresa em GitHub Enterprise Server e GitHub Enterprise Cloud.

Pessoas com uma conta de usuário em ambos os ambientes podem conectar as contas a partir de sua instância do GitHub Enterprise Server.

Entre em sua instância do GitHub Enterprise Server e GHE.com.
No canto superior à direita do GitHub Enterprise Server, clique na sua imagem do perfil e clique em Configurações da empresa.
Na parte superior da página, clique em GitHub Connect.
Em "O GitHub Connect ainda não está habilitado", clique em Habilitar o GitHub Connect . Ao clicar em Enable GitHub Connect, você concorda com Termos do GitHub para produtos e recursos adicionais.
À direita da conta corporativa que você deseja conectar, clique em Conectar.
Escolha quais recursos GitHub Connect individuais você deseja habilitar. Confira Sobre GitHub Connect.

Reativando as conexões com GitHub.com

Se você precisar reativar GitHub Connect para GitHub.com, deverá reconfigurar as configurações.

Conecte-se via SSH ao sua instância do GitHub Enterprise Server. Se sua instância for composta por vários nós, por exemplo, se a alta disponibilidade ou a replicação geográfica estiver configurada, efetue SSH no nó primário. Se você usar um cluster, poderá efetuar SSH em qualquer nó. Substitua HOSTNAME pelo nome do host da instância ou pelo nome do host ou endereço IP de um nó. Para saber mais, confira Acessar o shell administrativo (SSH).
Shell
```
ssh -p 122 admin@HOSTNAME
```
```
ssh -p 122 admin@HOSTNAME
```

Execute o comando a seguir.