Integração Git: Nativo → Git (GitHub)
Esta página explica como a sincronização Nativo → Git funciona, permitindo que metadados Salesforce gerenciados em branches do Revvy sejam sincronizados com o GitHub para controle de versão completo.
O Revvy oferece integração perfeita com provedores Git externos para controle de versão. Atualmente, o GitHub é suportado para Sincronização Nativo → Git de sincronização. Isso permite que o metadata do Salesforce gerenciado em branches do Revvy seja sincronizado automaticamente com repositórios no GitHub, garantindo controle de versão completo junto ao fluxo de DevOps do Revvy.
Acessando a Integração com Git
Navegue até Configurações → Integrações Git no aplicativo Revvy DevOps. Duas opções de integração estão disponíveis:
Integração de Histórias de Usuário – Conecte o Jira ou outras plataformas de gestão de histórias.
Integrações Git – Conecte repositórios Git para sincronização de branches, commits e pull requests.
Configurando a Integração com o GitHub
Vá para Configurações → Integrações Git → Integração.
Selecione Tipo de Serviço = GitHub.
Insira:
Organização – Organização ou owner do GitHub.
Token – Token de acesso pessoal (com escopos repo + workflow).
Nome de usuário – Nome de usuário do GitHub.
Nome do Repositório – Repositório alvo no GitHub.
Clique Conectar.
Em caso de sucesso, você verá uma confirmação: “As configurações de integração com Git foram salvas com sucesso.”
Uma vez conectado, um Desconectar botão substitui o botão Conectar.
Atividades – Histórico de Sincronização
Após a configuração, o Revvy registra todos os trabalhos de sincronização Git em Configurações → Integração Git → Atividades.
Filtros
Filtro de Branch – Selecione um branch específico (por exemplo, Feature-JiraStory1).
Direção – As opções incluem:
Sincronização Nativo → Git (do Revvy para o GitHub).
Git → Nativo (expansão futura).
Status – Filtre por status dos jobs (Em fila, Em progresso, Concluído, Abortado, Exceção).
Intervalo de Datas – Restrinja os resultados por janela de tempo.
Colunas do Histórico de Sincronização
Carimbo de data/hora – Quando a sincronização foi iniciada.
Branch – O nome do branch no Revvy.
Direção – Fluxo da sincronização (Nativo → Git).
Status – Estado atual do job.
Componentes – Resumo de itens Novos, Alterados e Excluídos.
Duração – Tempo total de execução.
Logs – O link “Ver Logs” abre os detalhes.
Status dos Jobs na Integração com Git
Em fila – Sincronização agendada, ainda não iniciada.
Em progresso – Sincronização em execução; clique para ver componentes e logs em tempo real.
Concluído – Sincronização finalizada com sucesso.
Exceção – Sincronização falhou com um erro (verifique os logs).
Abortado – Sincronização interrompida manualmente.
Jobs em Progresso
Quando um job está Em progresso, você pode:
Clique no link Direção (Nativo → Git) para ver os componentes sincronizados.
Abra o painel de Logs para ver a execução em tempo real (configuração do repositório, sincronização de componentes, criação de projeto).
Use o botão Atualizar para carregar novas linhas de log.
Jobs Concluídos
Quando um job tem status Concluído, você pode:
Revisar Resumo do Job incluindo:
Nome do branch.
Status do job (Concluído).
Direção (Para o Git).
Total de componentes sincronizados (contagens de Novos, Alterados, Excluídos).
Duração.
Data de início e data de término.
Abrir Logs para ver o histórico completo passo a passo:
Job iniciado.
Preparar repositório Git iniciado/concluído.
Sincronização de componentes iniciada/concluída.
Push para o repositório Git iniciado/concluído.
Job concluído.
Use o botão Atualizar para recarregar os logs atualizados se você estiver revisando logo após a conclusão.
Clique em Componentes Sincronizados para ver:
Todos os itens sincronizados, com filtros para Novos, Alterados, Excluídos.
Filtro por tipo de componente (CustomField, CustomObject, ListView, etc.).
Barra de pesquisa para localizar um componente específico.
Metadata atualizado por último no Revvy vs. Git.
Isso garante rastreabilidade completa: você pode confirmar exatamente quais componentes foram enviados, validar que nenhuma alteração foi perdida e revisar os logs para auditoria ou solução de problemas.
Visão de Componentes Sincronizados
Clicar em um job ou Nativo -> Git abre o painel de componentes sincronizados:
Guias: Todos, Novos, Alterados, Excluídos.
Filtros: Por tipo de componente.
Pesquisar: Restringir resultados por nome.
Se nenhum componente for atualizado, o painel mostra “Nenhum componente.”
Logs de Sincronização
Logs detalhados fornecem visão sobre o processo de sincronização. Entradas de exemplo incluem:
Job iniciado.
Preparar repositório Git iniciado/concluído.
Sincronização de componentes iniciada.
Criação do projeto Salesforce iniciada/concluída.
Os logs podem ser copiados pelo ícone de copiar e atualizados para obter atualizações em tempo real.
Abortando uma Sincronização
Se necessário, uma sincronização ativa pode ser abortada:
Abra o detalhe do job.
Clique no Botão Abortar
O status atualiza para Abortado, e o job para imediatamente.
Visualizando Conteúdo Sincronizado no GitHub
Uma vez que os jobs de sincronização estejam Concluídos no Revvy, o repositório conectado no GitHub reflete o estado atualizado do branch.
Branches no GitHub
Cada branch do Revvy (por exemplo, Feature-JiraStory2) é criado ou atualizado como um branch no repositório do GitHub.
Você verá o nome do branch listado no dropdown do seletor de branches.
Commits no GitHub
O Revvy envia commits com mensagens como “Sincronização Devops. Um branch foi sincronizado.”
Cada job de sincronização cria um novo commit para rastreabilidade.
Estrutura do Repositório no GitHub
O repo é formatado como um projeto Salesforce DX com pastas padrão (force-app/, config/, scripts/) e arquivos (sfdx-project.json, package.json, README.md).
Boas Práticas
Use Tokens de Acesso Pessoal com escopo limitado para segurança.
Use nomes de branch com apenas letras, números, _, /, -, e ., e evite espaços ou caracteres especiais para garantir sincronização Git sem problemas.
Monitore Atividades para exceções e resolva rapidamente.
Use filtros para auditar branches, datas ou status específicos.
Atualizado