Como habilitar o GitHub Connect no GHE.com

Acesse recursos e fluxos de trabalho adicionais do sua instância do GitHub Enterprise Server, habilitando o GitHub Connect. Confira "Sobre o GitHub Connect".

No GHE.com, os recursos do GitHub Connect não incluem nenhuma funcionalidade que dependa de recursos no GitHub.com.

O que acontece quando o GitHub Connect é 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 empresarial no GHE.com e a uma instância do GitHub Enterprise Server.
Requisito de versão: sua instância do GitHub Enterprise Server precisa executar o GitHub Enterprise Server 3.12 ou posterior.
Configuração de proxy: se estiver usando um servidor proxy, permita a conectividade com os nomes do host do GHE.com a seguir (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 com o GHE.com

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

Para habilitar a conexão, alguém com acesso SSH administrativo no sua instância do GitHub Enterprise Server precisa 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 obter mais informações, confira "Acesar o shell administrativo (SSH)".
Shell
```
ssh -p 122 admin@HOSTNAME
```
```
ssh -p 122 admin@HOSTNAME
```

Para permitir que a sua instância se conecte ao 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.

Note

Durante uma execução de configuração, os serviços do sua instância do GitHub Enterprise Server podem ser reiniciados, o que poderá 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, configure o GitHub Connect.

Etapa 2: Habilitar o GitHub Connect

Para habilitar o GitHub Connect, é necessário ser proprietário de uma empresa tanto no GitHub Enterprise Server quanto no GitHub Enterprise Cloud.

As pessoas com uma conta de usuário nos dois ambientes podem conectar as contas do sua instância do GitHub Enterprise Server.

Entre no sua instância do GitHub Enterprise Server e no GHE.com.
No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.
Na barra lateral da conta corporativa, clique em GitHub Connect .
Em "O GitHub Connect ainda não está habilitado", clique em Habilitar o GitHub Connect . Ao clicar em Habilitar 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 os recursos individuais do GitHub Connect que você deseja habilitar. Confira "Sobre o GitHub Connect".

Como habilitar novamente as conexões com o GitHub.com

Caso você precise habilitar novamente o GitHub Connect para o GitHub.com, é necessário redefinir 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 obter mais informações, confira "Acesar o shell administrativo (SSH)".
Shell
```
ssh -p 122 admin@HOSTNAME
```
```
ssh -p 122 admin@HOSTNAME
```

Execute o comando a seguir.