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á.
# Crie uma conexão com GitHub
Você pode usar o Console de gerenciamento da AWS ou o AWS Command Line Interface (AWS CLI) para criar uma conexão com GitHub.
Antes de começar
+ Você já deve ter criado uma conta com GitHub.
+ Você já deve ter criado seu repositório de código de terceiros.
**nota**
Para criar a conexão, você deve ser o proprietário GitHub da organização. Para repositórios que não estão em uma organização, você deve ser o proprietário do repositório.
**Topics**
+ [Crie uma conexão com GitHub (console)](#connections-create-github-console)
+ [Crie uma conexão com GitHub (CLI)](#connections-create-github-cli)
## Crie uma conexão com GitHub (console)
Você pode usar o console para criar uma conexão com GitHub o.
**nota**
A partir de 1º de julho de 2024, o console cria conexões com o `codeconnections` ARN do recurso. Os recursos com os dois prefixos de serviço continuarão sendo exibidos no console.
1. Faça login no e abra Console de gerenciamento da AWS 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 GitHub ou com o GitHub Enterprise Cloud, em **Selecionar um provedor**, escolha **GitHub**. Em **Connection name** (Nome da conexão), digite o nome da conexão que você deseja criar. Escolha **Connect GitHub to** e vá para a Etapa 2.
![\[Captura de tela do console mostrando a opção de conexão selecionada para Bitbucket.\]](http://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/github-conn.png)
**Para criar uma conexão com GitHub**
1. **Nas configurações de GitHub conexão**, o nome da conexão aparece em **Nome da conexão**. Escolha **Connect to GitHub**. A página de solicitação de acesso será exibida.
![\[Captura de tela do console mostrando a página de acesso à GitHub conta.\]](http://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/github-conn-access.png)
1. Escolha **Autorizar AWS conector para GitHub**. A página de conexão é exibida e mostra o campo **GitHub Aplicativos**.
![\[Captura de tela do console mostrando a página de GitHub conexão inicial com o campo GitHub Aplicativos.\]](http://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/github-conn-access-app.png)
1. Em **GitHub Aplicativos**, escolha uma instalação de aplicativo ou escolha **Instalar um novo aplicativo** para criar um.
**nota**
Você instala uma aplicação para todas as suas conexões com um provedor específico. Se você já instalou o GitHub aplicativo AWS Connector for, escolha-o e pule esta etapa.
1. Na GitHub página Install **AWS Connector for**, escolha a conta na qual você deseja instalar o aplicativo.
![\[Captura de tela do console mostrando o AWS conector para a página GitHub de instalação.\]](http://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/github-conn-access-app-install1.png)
**nota**
Você só instala o aplicativo uma vez para cada GitHub conta. Se você instalou a aplicação anteriormente, poderá escolher **Configure** (Configurar) para prosseguir para uma página de modificação para a instalação da aplicação ou usar o botão Back (Voltar) para retornar ao console.
1. **Na GitHub página **Install AWS Connector for**, deixe os padrões e escolha Instalar.**
![\[Captura de tela do console mostrando o segundo AWS conector para a página GitHub de instalação.\]](http://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/github-conn-access-app-install2.png)
Após essa etapa, uma página de permissões atualizada pode ser exibida em GitHub.
1. Se uma página for exibida mostrando que há permissões atualizadas para o GitHub aplicativo AWS Connector for, escolha **Aceitar novas permissões**.
![\[Captura de tela do console mostrando a página AWS Conector para permissões GitHub atualizadas.\]](http://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/accept-new-permissions.png)
1. Você retornará à GitHub página **Connect to**. O ID de conexão da sua nova instalação aparece em **GitHubAplicativos**. Selecione **Conectar**.
### Visualizar sua conexão criada
+ A conexão criada é exibida na lista de conexões.
![\[Captura de tela do console mostrando uma lista de conexões criadas com sucesso.\]](http://docs.aws.amazon.com/pt_br/dtconsole/latest/userguide/images/connections-create-ghe-complete.png)
## Crie uma conexão com GitHub (CLI)
Você pode usar o AWS Command Line Interface (AWS CLI) para criar uma conexão com GitHub.
Para fazer isso, use o comando **create-connection**.
**Importante**
Uma conexão criada por meio do AWS CLI ou AWS CloudFormation está no `PENDING` status por padrão. Depois de criar uma conexão com a CLI ou CloudFormation, use o console para editar a conexão e definir seu status. `AVAILABLE`
**Para criar uma conexão com GitHub**
1. Abra um terminal (Linux, macOS ou Unix) ou um prompt de comando (Windows). Use o AWS CLI para executar o **create-connection** comando, especificando `--provider-type` e `--connection-name` para sua conexão. Neste exemplo, o nome do provedor de terceiros é `GitHub` e o nome da conexão especificada é `MyConnection`.
```
aws codeconnections create-connection --provider-type GitHub --connection-name MyConnection
```
Se tiver êxito, esse comando gerará as informações do ARN de conexão semelhantes às seguintes.
```
{
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}
```
1. Use o console para concluir a conexão. Para obter mais informações, consulte [Atualizar uma conexão pendente](connections-update.md).