> 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/visao-geral-das-integracoes-com-git.md).

# Visão geral das integrações com Git

{% hint style="warning" %}

#### Escrito para a interface antiga

Este artigo foi escrito para a interface antiga. As instruções ainda podem ser usadas, mas as capturas de tela estão desatualizadas. Em alguns casos, os itens referenciados nas instruções foram movidos ou alterados. Se você não conseguir encontrar um item, consulte o [Para onde foi](/devops/devops-pt-br/transicao-para-a-nova-ui-ux/para-onde-foi.md) artigo.
{% endhint %}

## ![](https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) Visão geral

A integração com Git permite conectar seu repositório Git ao DevOps, para que os metadados do Salesforce gerenciados nas branches do DevOps sejam sincronizados automaticamente. Isso garante que suas branches e commits sejam rastreados no seu sistema de controle de versão baseado em Git. Quando uma pull request do DevOps é mesclada, um commit é criado para as alterações mescladas. A integração com Git envia esse commit para a branch de destino no Git, mas a pull request não é sincronizada com o Git.

{% hint style="info" %}

#### Boas práticas

* Nomeie as branches do DevOps usando apenas letras, números e estes símbolos: `_ / - .`. Evite espaços ou caracteres especiais para garantir uma sincronização tranquila com o Git.
* Monitore a integração com Git **Atividades** para exceções e resolva-as rapidamente.
* Use filtros para auditar branches, datas ou status específicos.
  {% endhint %}

## Estrutura do repositório sincronizado

Depois que o DevOps conclui uma sincronização com uma tarefa Push to Git, o repositório Git conectado reflete os estados das branches do DevOps. Cada tarefa de sincronização cria um novo commit para rastreabilidade. A tabela abaixo explica como a integração lida com cada um dos itens a seguir.

<table data-header-hidden><thead><tr><th width="180"></th><th></th></tr></thead><tbody><tr><td>Ramificações</td><td>Cada branch do DevOps é criada ou atualizada como uma branch com o mesmo nome no seu repositório Git.</td></tr><tr><td>Commits</td><td>O DevOps envia commits para a branch. Os commits sempre têm <code>Sincronização do DevOps. Uma branch é sincronizada.</code> como cabeçalho. O corpo do commit inclui o Hash, a Mensagem e o CreatedAt de todos os commits do DevOps enviados ao Git durante esta sincronização.</td></tr><tr><td>Solicitações de Pull Request</td><td>Quando uma pull request do DevOps é mesclada, um commit é criado para as alterações mescladas. A integração com Git envia esse commit para a branch de destino no Git, mas a pull request não é sincronizada com o Git. O commit enviado inclui o seguinte nos detalhes do commit: <code>Mensagem: Mesclar branch</code>.</td></tr></tbody></table>

O repositório é formatado como um **Projeto Salesforce DX**, com o seguinte:

* Pastas padrão
  * force-app/
  * config/
  * scripts/
* Arquivos padrão
  * sfdx-project.json
  * package.json
  * README.md

A captura de tela abaixo mostra um exemplo de uma branch em um repositório GitHub que está sincronizado com o DevOps.

<figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F2SuhPHJlixMqCpLNqNeS%2FOverviewOfGitIntegrations-Repo-01.png?alt=media&amp;token=59ca4924-fa61-43c3-8bff-5d98c35c5ad1" alt=""><figcaption></figcaption></figure>

### Commits de sincronização do DevOps

Cada commit que o DevOps envia para o Git tem o seguinte formato:

#### Cabeçalho do commit

{% code overflow="wrap" expandable="true" %}

```
Sincronização do DevOps. Uma branch é sincronizada.
```

{% endcode %}

#### Corpo do commit

{% code overflow="wrap" expandable="true" %}

```
Commits do DevOps sincronizados:

Hash: 
Mensagem:
CreatedAt:
```

{% endcode %}

O corpo do commit pode incluir vários commits do DevOps, e as seguintes informações são fornecidas para cada commit do DevOps.

<table data-header-hidden><thead><tr><th width="128.3333740234375"></th><th></th></tr></thead><tbody><tr><td>Hash</td><td>Código hash do commit do DevOps representado por esta mensagem.</td></tr><tr><td>Mensagem</td><td>Mensagem do commit do DevOps.</td></tr><tr><td>CreatedAt</td><td>O timestamp ISO 8601 em que o commit foi criado no DevOps.</td></tr></tbody></table>

A seguir estão capturas de tela de exemplo de commits sincronizados do DevOps no GitHub.

<details>

<summary>Criação e sincronização inicial da branch</summary>

Quando um repositório Git é conectado a um locatário existente do DevOps, uma branch é criada e um commit inicial é enviado ao Git, incluindo todas as mensagens de commit no DevOps para essa branch. A seguir, um exemplo de um commit inicial no GitHub.

<figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2F81znbC6bp8uzTEfR7KBh%2FOverviewOfGitIntegrations-Commits-01.png?alt=media&amp;token=9186e33b-f6d5-4872-ae81-12a6cf975c3c" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Commit do DevOps</summary>

A seguir, um exemplo de um commit do DevOps no GitHub.

<figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2Far5XPO59NVfT0exg1aNh%2FOverviewOfGitIntegrations-Commits-02.png?alt=media&amp;token=a228ead4-8cf0-4b2c-a9b3-6123cc5b7801" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Mesclagem de pull request do DevOps</summary>

Quando uma pull request do DevOps é mesclada, um commit é criado para as alterações mescladas. A integração com Git envia esse commit para a branch de destino no Git, mas a pull request não é sincronizada com o Git. O commit enviado inclui o seguinte nos detalhes do commit: `Mensagem: Mesclar branch`. A seguir, um exemplo de um commit de merge no GitHub.

<figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FwKXbVPUTzMWgoNJLABUv%2FOverviewOfGitIntegrations-Commits-03.png?alt=media&amp;token=8030c406-c129-4f58-bf74-c036e2c7e412" alt=""><figcaption></figcaption></figure>

</details>

#### Commits agrupados

Em algumas situações, a integração com Git agrupa vários commits em um único commit que é sincronizado com o Git. No Git, a mensagem do commit inclui detalhes de cada commit do DevOps agrupado. Por exemplo, quando um componente é editado no DevOps, o commit resultante não é enviado ao Git até que outra ação de branch acione um envio. A seguir, um exemplo de um commit agrupado.

<div align="left"><figure><img src="https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FUzxCEwp4rX3gU9KmjzGt%2FOverviewOfGitIntegrations-Commits-04.png?alt=media&amp;token=9e1a79c7-287a-4e87-9f56-8d3309799864" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
O agrupamento de commits pode fazer com que o Git fique temporariamente fora de sincronia com o DevOps. No entanto, assim que o DevOps enviar os commits agrupados para o Git, os sistemas voltarão a ficar sincronizados. Se você não tiver certeza de que um commit foi enviado ao Git, compare os commits da branch do DevOps com os commits da branch do Git.
{% endhint %}

## Hosts Git compatíveis

O DevOps pode se conectar aos seguintes hosts para repositórios Git.

* GitHub
* GitLab
* Azure
* Bitbucket

Instruções detalhadas para conectar ao GitHub são fornecidas no artigo abaixo e podem servir como guia para conectar aos outros hosts, já que o processo é semelhante.

* [Conectando um repositório do GitHub](/devops/devops-pt-br/configuracoes/integracoes-com-git/conectando-um-repositorio-do-github.md)


---

# 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/visao-geral-das-integracoes-com-git.md?ask=<question>&goal=<user_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.