

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criar uma conexão com o GitHub Enterprise Server (console)
<a name="connections-create-gheserver-console"></a>

Para criar uma conexão com o GitHub Enterprise Server, você fornece informações sobre onde seu GitHub Enterprise Server está instalado e autoriza a criação da conexão com suas credenciais GitHub Enterprise.

**nota**  
A partir de 1º de julho de 2024, o console cria conexões com `codeconnections` no recurso ARN. Os recursos com os dois prefixos de serviço continuarão sendo exibidos no console.

**Topics**
+ [Crie sua conexão com o GitHub Enterprise Server (console)](#connections-create-gheserver-connection)

## Crie sua conexão com o GitHub Enterprise Server (console)
<a name="connections-create-gheserver-connection"></a>

Para criar uma conexão com o GitHub Enterprise Server, tenha a URL do servidor e as credenciais GitHub Enterprise prontas.<a name="proc-host-create-console-steps"></a>

**Para criar um host**

1. Faça login no e abra Console de gerenciamento da AWS o console do AWS Developer Tools em[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).

1. Na guia **Hosts**, escolha **Create host** (Criar host). 

1. Em **Host name** (Nome do host), insira o nome que deseja usar para o host.

1. Em **Selecionar um provedor**, escolha uma das seguintes opções:
   + **GitHub Servidor corporativo **
   + **GitLab autogerenciado **

1. Em **URL**, insira o endpoint da infraestrutura em que seu provedor está instalado.

1. Se seu servidor estiver configurado em uma Amazon VPC e você quiser se conectar com sua VPC, escolha **Use a VPC** (Usar uma VPC). Caso contrário, escolha **No VPC**.

1. Se você tiver iniciado sua instância em uma Amazon VPC e quiser se conectar à sua VPC, escolha**Use a VPC** (Usar uma VPC) e conclua as operações a seguir.

   1. Em **VPC ID** (ID da VPC), escolha o ID da sua VPC. Escolha a VPC para a infraestrutura onde a instância está instalada ou uma VPC com acesso à instância por meio da VPN ou do Direct Connect.

   1. Se você tiver uma VPC privada configurada e tiver configurado a instância para executar a validação de TLS usando uma autoridade de certificação não pública, será necessário inserir o ID do certificado em **Certificado TLS**. O valor do certificado TLS é a chave pública do certificado.

1. Escolha **Create host** (Criar host).

1. Depois que a página de detalhes do host for exibida, o status do host será alterado quando o host for criado.
**nota**  
Se a configuração do host incluir uma configuração de VPC, aguarde vários minutos pelo provisionamento de componentes de rede do host.

   Aguarde até que seu host atinja um status **Pending** (Pendente) e, em seguida, conclua a configuração. Para obter mais informações, consulte [Configurar um host pendente](connections-host-setup.md).  
![Captura de tela do console mostrando detalhes do host com o host no status Pending (Pendente).](https://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/connections-create-host-pending.png)

**Etapa 2: Crie sua conexão com o GitHub Enterprise Server (console)**

1. Faça login no Console de gerenciamento da AWS e abra o console do Developer Tools em[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).

1. Escolha **Settings > Connections** (Configurações > Conexões) e, em seguida, escolha **Create connection** (Criar conexão).

1. Para criar uma conexão com um repositório instalado do GitHub Enterprise Server, escolha ** GitHub Enterprise Server**.

**Conecte-se ao GitHub Enterprise Server**

1. Em **Connection name** (Nome da conexão), informe um nome para a conexão.  
![Captura de tela do console mostrando a página Create host settings page with no VPC (Criar configurações do host sem VPC).](https://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/connections-create-ghes-screen.png)

1. Em **URL**, insira o endpoint do seu servidor.
**nota**  
Se a URL fornecida já tiver sido usada para configurar um GitHub Enterprise Server para uma conexão, você será solicitado a escolher o ARN do recurso de host que foi criado anteriormente para esse endpoint.

1. (Opcional) Se você tiver iniciado o servidor em uma Amazon VPC e quiser se conectar à VPC, escolha **Usar uma VPC** e faça o indicado a seguir.
**nota**  
Para organizações no GitHub Enterprise Server ou GitLab autogerenciadas, você não transmite um host disponível. Você cria um novo host para cada conexão em sua organização e deve se certificar de inserir as mesmas informações nos campos de rede (ID de VPC, IDs de sub-rede e IDs de grupo de segurança) para o host. Para obter mais informações, consulte [Configuração de conexão e host para provedores instalados que apoiam organizações](troubleshooting-connections.md#troubleshooting-organization-host).

   1. Em **VPC ID** (ID da VPC), escolha o ID da sua VPC. Certifique-se de escolher a VPC para a infraestrutura em que sua instância do GitHub Enterprise Server está instalada ou uma VPC com acesso à sua instância do GitHub Enterprise Server por meio de VPN ou Direct Connect.

   1. Em **Subnet ID** (ID da sub-rede), escolha **Add** (Adicionar). No campo, escolha o ID da sub-rede que você deseja usar para seu host. Você pode escolher até 10 sub-redes.

      Certifique-se de escolher a sub-rede para a infraestrutura em que sua instância do GitHub Enterprise Server está instalada ou uma sub-rede com acesso à sua instância instalada do GitHub Enterprise Server por meio de VPN ou Direct Connect.

   1. Em **Security group IDs** (IDs de grupos de segurança), escolha **Add** (Adicionar). No campo, escolha o grupo de segurança que você deseja usar para seu host. Você pode criar até 10 grupos de segurança.

      Certifique-se de escolher o grupo de segurança para a infraestrutura em que sua instância do GitHub Enterprise Server está instalada ou um grupo de segurança com acesso à sua instância instalada do GitHub Enterprise Server por meio de VPN ou Direct Connect.

   1. Se você tiver uma VPC privada configurada e tiver configurado sua instância do GitHub Enterprise Server para realizar a validação de TLS usando uma autoridade de certificação não pública, em Certificado ** TLS**, insira seu ID de certificado. O valor do certificado TLS deve ser a chave pública do certificado.  
![Captura de tela do console mostrando a página de criação de conexão do GitHub Enterprise Server para opções de VPC.](https://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/connections-create-ghes-screen-vpc.png)

1. Escolha ** Conectar ao GitHub Enterprise Server**. A conexão criada é mostrada com um status **Pending** (Pendente). Um recurso de host é criado para a conexão com as informações do servidor fornecidas. Para o nome do host, o URL é usado.

1.  Selecione **Update pending connection** (Atualizar conexão pendente).  
![Captura de tela do console mostrando a página de conexão pendente com o GitHub Enterprise Server.](https://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/connections-create-ghes-pending.png)

1. Se solicitado, na página de login GitHub Enterprise, faça login com suas credenciais GitHub Enterprise.

1. Na ** página ** Criar GitHub aplicativo, escolha um nome para seu aplicativo.  
![Captura de tela do console mostrando página de criação da aplicação.](https://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/connections-create-ghes-app-name.png)

1. <app-name>Na página de GitHub autorização, escolha ** Autorizar. **  
![Captura de tela do console mostrando uma página de autorização de aplicação.](https://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/connections-create-ghes-app-authorize.png)

1. Na página de instalação da aplicação, uma mensagem informa que a aplicação de conector está pronta para ser instalada. Se você tiver várias organizações, poderá ser solicitado a escolher a organização onde deseja instalar a aplicação. 

   Escolha as configurações do repositório em que deseja instalar a aplicação. Escolha **Instalar**.  
![Captura de tela do console mostrando uma página de autorização de aplicação.](https://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/connections-create-ghes-app-install.png)

1. A página de conexão mostra a conexão criada em um status **Available** (Disponível).