Ir para o artigo

Repositórios Git e sincronização de problemas

Conecte uma conta Git, vincule um repositório ao projeto e configure a sincronização de problemas com o provedor.

A conexão Git pessoal autoriza o acesso ao provedor; o vínculo do repositório e a sincronização de problemas são configurações do projeto. O proprietário as configura para GitHub.com ou GitLab.com. Confira separadamente acesso, direção da sincronização e conflitos.

Conectar Git e vincular um repositório ao projeto

Conecte GitHub ou GitLab nas configurações Git da conta e conclua a autorização pelo navegador. Conceda somente repositórios necessários. No desktop retorne ao app depois. A conexão pode ser reutilizada em projetos, sem vincular todos os repositórios automaticamente.

O proprietário abre Git nas configurações do projeto, escolhe um repositório disponível e confirma. Confira provedor, nome completo e conta que atuará. Membros não podem substituir esse vínculo exclusivo. Ele permite o contexto do repositório, o acompanhamento de pull requests e as skills do repositório; a sincronização de tarefas é um botão separado.

Conectar uma conta e vincular um repositório
Conta pessoal do Git
Autorize o GitHub ou o GitLab para os repositórios de que você precisa.
Proprietário do projeto
Escolha um repositório disponível nas configurações de Git do projeto.
Repositório vinculado
Aurora → aurora/web. A sincronização de tickets é uma escolha separada.
Autorize primeiro a conta e depois vincule um repositório como proprietário do projeto.

Repositório ausente ou acesso expirado

Se a lista estiver vazia, confira permissões e autorização da organização ou repositório. Reconecte contas expiradas em vez de colar tokens nas tarefas. Desvincular exige o proprietário; leia a confirmação.

Self-hosted pode usar um relay gerenciado configurado ou apps próprios do operador. A conexão com o relay é explícita e não torna a plataforma Git local. Disponibilidade depende da configuração. Confira a política do operador antes de autorizar.

Sincronizar problemas da plataforma Git

Como proprietário, abra Git após vincular o repositório. Ative sincronização com as permissões de escrita necessárias. Tarefas importadas chegam à triagem. Confira a carga inicial informada e título, descrição e status de uma tarefa remota conhecida.

Aberto e fechado são espelhados nos dois sentidos. No GitHub, título e corpo viram título e descrição; labels fornecem categorias e prioridade ou esforço reconhecidos; usa-se o primeiro responsável vinculado e a data do milestone como prazo. Comentários preservam autor, identidade, URL e datas remotos. Bloqueios exigem ambas as tarefas no mesmo projeto importado. URLs de anexos permanecem; bytes e campos GitHub Projects não têm equivalente nativo.

Permissões, conflitos e desativação

A GitHub App exige leitura/escrita de Issues e assinaturas Issues, Issue comments e Issue dependencies. Instalações existentes precisam aceitar permissões novas. Esses mapeamentos não garantem todos os campos GitLab.

Eventos GitHub antigos com data não substituem alterações locais recentes. Identidades de entrega e comentário evitam duplicações. Compare datas e consulte eventos do provedor e logs do operador se faltar carga inicial. Desative no mesmo controle exclusivo do proprietário; examine o trabalho já importado separadamente.

Sincronização de tickets do GitHub
Configuração do proprietário
Vincular repositório, conceder leitura/escrita de Issues e ativar a sincronização.
Eventos recebidos
Deduplicar IDs de entrega; dados mais antigos não sobrescrevem alterações locais mais recentes.
Importação e mapeamento
Tickets importados entram na triagem. Título/corpo viram título/descrição; rótulos fornecem categorias, prioridade e esforço reconhecidos.
Sincronização de estado
Estados aberto/fechado são espelhados nos dois sentidos. Comparar horários quando alterações concorrem.
Comentários mantêm a identidade remota sem duplicação. O mapeamento do GitLab pode ser diferente.
Eventos do GitHub preservam alterações recentes e evitam entregas duplicadas. O mapeamento do GitLab exige verificação separada.
O repositório de demonstração está vinculado ao GitHub. A sincronização de issues continua desativada; confira o escopo e o backlog existente antes de ativá-la. Esta captura não comprova uma importação sincronizada.

Artigos relacionados