Visão geral das integrações com Git
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 artigo.
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.
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.
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.
Ramificações
Cada branch do DevOps é criada ou atualizada como uma branch com o mesmo nome no seu repositório Git.
Commits
O DevOps envia commits para a branch. Os commits sempre têm Sincronização do DevOps. Uma branch é sincronizada. 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.
Solicitações de Pull Request
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.
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.
Commits de sincronização do DevOps
Cada commit que o DevOps envia para o Git tem o seguinte formato:
Cabeçalho do commit
Corpo do commit
O corpo do commit pode incluir vários commits do DevOps, e as seguintes informações são fornecidas para cada commit do DevOps.
Hash
Código hash do commit do DevOps representado por esta mensagem.
Mensagem
Mensagem do commit do DevOps.
CreatedAt
O timestamp ISO 8601 em que o commit foi criado no DevOps.
A seguir estão capturas de tela de exemplo de commits sincronizados do DevOps no GitHub.
Criação e sincronização inicial da branch
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.
Mesclagem de pull request do DevOps
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.
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.
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.
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.
Atualizado
Isto foi útil?