> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-pt-br/configuracoes/integracoes-com-git/conectando-um-repositorio-do-github.md).
# Conectando um repositório do GitHub
##  Visão geral
Este artigo mostra como conectar seu repositório do GitHub ao DevOps para que os metadados do Salesforce gerenciados nos branches do DevOps sejam sincronizados automaticamente com seu repositório do GitHub. Isso garante que seus branches, commits e pull requests sejam totalmente rastreados no seu sistema de controle de versão baseado em Git.
{% hint style="info" %}
#### Tokens de acesso pessoal do GitHub
O DevOps se conecta a um repositório do GitHub usando um token de acesso pessoal. Você pode usar um **Clássico** token ou um **Granular** token, dependendo dos requisitos da sua empresa. As instruções abaixo cobrem ambos os métodos, mas você só precisa criar um tipo de token.
{% endhint %}
## Pré-requisitos do GitHub
{% stepper %}
{% step %}
### Repositório
A integração do DevOps com o GitHub sincroniza todos os branches, commits e pull requests em um único repositório do GitHub. Esse repositório pode ser público ou privado e pode pertencer a uma organização ou a um usuário individual.
A captura de tela abaixo mostra um repositório privado **flosum-devops-example** que faz parte da **Flosum-Example** organização.
{% endstep %}
{% step %}
### Token de acesso pessoal - Clássico
{% hint style="info" %}
Um **Clássico** token se aplica a todos os repositórios aos quais sua conta do GitHub pode acessar e precisa de apenas dois escopos. As instruções a seguir explicam como criar um.
{% endhint %}
1. Faça login na sua conta do GitHub.
2. Clique na sua foto de perfil no canto superior direito para abrir o menu suspenso.
3. Clique em **Configurações**.
4. Acesso **Configurações do desenvolvedor > Tokens de acesso pessoal > Tokens (clássicos)**.
5. Clique no **Gerar novo token** menu suspenso.
6. Clique em **Gerar novo token (clássico)**.
7. Insira uma descrição do token na **Nota** caixa de texto.
8. Clique no **Expiração** menu suspenso e selecione a data em que você deseja que o token expire.
9. Selecione o seguinte **Escopos**:
1. **repo**
2. **workflow**
10. Clique em **Gerar token** na parte inferior da página.
11. Copie o token e salve-o com segurança. Você precisará deste token ao conectar o DevOps à sua conta do GitHub.
{% endstep %}
{% step %}
### Token de acesso pessoal - Granular
{% hint style="info" %}
Um **Granular** token é limitado aos repositórios e permissões que você selecionar, então ele concede ao DevOps um acesso mais restrito do que um **Clássico** token. As instruções a seguir explicam como criar um.
{% endhint %}
1. Faça login na sua conta do GitHub.
2. Clique na sua foto de perfil no canto superior direito para abrir o menu suspenso.
3. Clique em **Configurações**.
4. Acesso **Configurações do desenvolvedor > Tokens de acesso pessoal > Tokens granulares**.
5. Clique em **Gerar novo token**.
6. Insira um nome para o token na **Nome do token** caixa de texto.
7. Clique no **Proprietário do recurso** menu suspenso e selecione o usuário ou a organização que é proprietária do repositório para o qual este token será usado.
8. Clique no **Expiração** menu suspenso e selecione a data em que você deseja que o token expire.
9. Em **Acesso ao repositório**, selecione **Selecionar apenas repositórios** para limitar o escopo deste token apenas aos repositórios que você selecionar.
{% hint style="info" %}
Você também pode selecionar **Todos os repositórios**, mas então o token terá acesso a quaisquer novos repositórios adicionados ao **Proprietário do recurso**.
Não selecione **Repositórios públicos**. Esta opção concede acesso somente leitura, e a integração do DevOps com o GitHub requer permissões de leitura e gravação.
{% endhint %}
10. Clique no **Selecionar repositórios** menu suspenso e marque todos os repositórios a serem incluídos com este token.
11. Em **Permissões**, clique em **Adicionar permissões** para adicionar cada uma das permissões na tabela abaixo.
12. Defina o **Acesso** menu suspenso de cada permissão para corresponder à coluna Acesso na tabela abaixo.
| Permissão | Acesso |
|---|
| Administração | Leitura e gravação |
| Conteúdo | Leitura e gravação |
| Metadados | Somente leitura |
| Webhooks | Leitura e gravação |
{% hint style="info" %}
A **Metadados** permissão é adicionada automaticamente quando outra permissão é adicionada.
{% endhint %}
13. Clique em **Gerar token**.
14. Revise as configurações do token na caixa de diálogo de confirmação e clique em **Gerar token**.
15. Copie o token e salve-o com segurança. Você precisará deste token ao conectar o DevOps à sua conta do GitHub.
{% endstep %}
{% endstepper %}
## Conectar o DevOps ao GitHub
{% stepper %}
{% step %}
### Acessar as configurações de integração com Git
1. Clique em **Integração com Git** na **Configurações** seção no menu da barra lateral esquerda.
2. Clique no **Configurações** aba.
{% endstep %}
{% step %}
### Conectar GitHub
1. Clique no **Tipo de serviço** menu suspenso.
2. Selecione **GitHub**.
3. Na **Organização** caixa de texto, insira o nome da organização do GitHub proprietária do repositório ao qual você está se conectando. Deixe em branco se estiver se conectando a um repositório pertencente à sua conta de usuário do GitHub.
{% hint style="info" %}
#### Caminho do repositório
O caminho do repositório do GitHub ao qual a integração tenta se conectar depende de se o **Organização** campo tem um valor.
Se o **Organização** campo tiver um valor, o caminho do repositório é:
* `github.com/{Organization}/{Repository name}`
Se o **Organização** campo estiver em branco, o caminho do repositório é:
* `github.com/{Username}/{Repository name}`
{% endhint %}
4. Na **Nome de usuário** caixa de texto, insira o nome de usuário do GitHub com o qual você está conectando esta integração.
5. Na **Token** caixa de texto, insira o token de acesso pessoal do GitHub que você criou na seção acima.
6. Na **Nome do repositório** caixa de texto, insira o nome do repositório do GitHub ao qual você está se conectando.
7. Clique em **Conectar**.
8. Se a integração com Git se conectar com sucesso ao seu repositório do GitHub, uma mensagem de sucesso aparecerá. A **GitHub** conexão então lista a organização e mostra seu status como **Conectado**.
{% hint style="warning" %}
Se a conexão da integração com Git falhar, verifique a mensagem de erro para determinar a causa. Depois de corrigir, tente conectar novamente.
{% endhint %}
{% endstep %}
{% step %}
### Sincronização do GitHub
Depois de conectado, todos os branches do DevOps começarão a ser sincronizados com o repositório do GitHub. Você pode verificar o progresso da sincronização na **Atividades** aba.
{% endstep %}
{% step %}
### Repositório do GitHub
A captura de tela abaixo mostra um exemplo de um repositório do GitHub conectado e sincronizado com o DevOps.
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.flosum.com/devops/devops-pt-br/configuracoes/integracoes-com-git/conectando-um-repositorio-do-github.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
