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
CicloparaTodos os ciclos— ouSem ciclo, se a issue não está em ciclo nenhum. - Limpe os filtros
Tipo,Responsável,IniciativaeDomain, e desligueMinhas issues. - Se a issue foi arquivada, mude para a visão
Listae filtreStatusporArquivado.
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
Domainsna lateral do Forge e clique emNovo domain. - Crie o domain e volte a
Initiatives— o botãoNova 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 branche 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
GitHubdo Forge. - Clique em
Conectar GitHube 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
GitHubdo Forge, comConectar 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ícioeTérmino— e só nesse estado o ciclo pode ser removido.Ativo: apenasObjetivoeTérmino.Concluído: apenas oObjetivo.
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íciodo ciclo (possível em ciclosPróximo) ou aguarde a data. - Adicione issues ao ciclo com
Adicionar issue ao ciclo, na abaListado 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
Bloqueadado 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 emGerenciar instalaçãoe confirme quais repositórios o app pode acessar. - Clique em
Sincronizar repositóriose confira a “Última sincronização”.