REFERÊNCIATroubleshooting

Resolver problemas do Forge

Os problemas mais comuns no Forge e como resolver cada um, do mais frequente ao mais raro.

Uma issue não aparece no board

Causa: o board filtra pelo ciclo ativo por padrão, e os filtros ficam salvos no navegador por time — um filtro esquecido continua escondendo issues mesmo depois de sair e voltar.

  • Mude o filtro Ciclo para Todos os ciclos — ou Sem ciclo, se a issue não está em ciclo nenhum.
  • Limpe os filtros Tipo, Responsável, Iniciativa e Domain, e desligue Minhas issues.
  • Se a issue foi arquivada, mude para a visão Lista e filtre Status por Arquivado.

O botão Nova iniciativa está desabilitado

Causa: o time ainda não tem nenhum domain — toda iniciativa exige um. A paleta de comandos mostra a dica “Crie um domain primeiro”.

  • Abra Domains na lateral do Forge e clique em Novo domain.
  • Crie o domain e volte a Initiatives — o botão Nova iniciativa é habilitado.

“Nenhum PR vinculado” na issue

Causa: a branch ou o PR não referencia a issue — o vínculo é automático apenas quando a branch começa com o padrão iss-N- ou a descrição do PR contém closes #N.

  • Na página completa da issue, use Copiar nome da branch e crie a branch com esse nome.
  • Para um PR já aberto, adicione closes #N (com o número da issue) à descrição.
  • Confirme que a integração com o GitHub está conectada e o repositório, sincronizado.

“Não encontramos o time que iniciou a conexão. Volte ao Forge e tente novamente.”

Causa: a instalação do GitHub App foi concluída em outro navegador, ou os dados locais do site foram limpos durante o processo.

  • Volte à página GitHub do Forge.
  • Clique em Conectar GitHub e conclua a instalação no mesmo navegador, sem limpar os dados no caminho.

“A assinatura do GitHub não confere com o pedido enviado. Por segurança, reinicie a conexão.”

Causa: a verificação de segurança do retorno do GitHub não bateu com o pedido original.

  • Reinicie a conexão pela página GitHub do Forge, com Conectar GitHub.

Não consigo editar as datas do ciclo

Causa: o que pode ser editado depende do estado do ciclo — os campos fora da regra aparecem desabilitados.

  • Próximo: Objetivo, Início e Término — e só nesse estado o ciclo pode ser removido.
  • Ativo: apenas Objetivo e Término.
  • Concluído: apenas o Objetivo.

O ciclo não mostra burndown

Causa: o ciclo ainda está Próximo ou não tem issues. Não existe ação de iniciar — o ciclo vira Ativo quando a data de início chega.

  • Antecipe o campo Início do ciclo (possível em ciclos Próximo) ou aguarde a data.
  • Adicione issues ao ciclo com Adicionar issue ao ciclo, na aba Lista do ciclo.

“Você precisa de permissão de gestor (FORGE_MANAGER) para ver este painel.”

Causa: a página Bloqueios é restrita a gestores e administradores do Forge.

  • Acompanhe os bloqueios das suas issues pela seção Bloqueada do Inbox.
  • Se o seu papel deveria ser de gestor, peça a um administrador do time para ajustar em membros do time.

Repositórios não aparecem depois de conectar

Causa: a instalação do GitHub App não inclui os repositórios esperados, ou a lista ainda não foi sincronizada.

  • Em GitHub, clique em Gerenciar instalação e confirme quais repositórios o app pode acessar.
  • Clique em Sincronizar repositórios e confira a “Última sincronização”.

Próximo