REFERENCIATroubleshooting

Solucionar problemas de Forge

Los problemas más comunes en Forge y cómo resolver cada uno, del más frecuente al más raro.

Una issue no aparece en el board

Causa: el board filtra por el ciclo activo por defecto, y los filtros quedan guardados en el navegador por equipo — un filtro olvidado sigue escondiendo issues incluso después de salir y volver.

  • Cambia el filtro Ciclo a Todos os ciclos (todos los ciclos) — o Sem ciclo (sin ciclo), si la issue no está en ningún ciclo.
  • Limpia los filtros Tipo, Responsável (responsable), Iniciativa y Domain, y desactiva Minhas issues (mis issues).
  • Si la issue fue archivada, cambia a la vista Lista y filtra Status por Arquivado (archivada).

El botón Nova iniciativa está deshabilitado

Causa: el equipo aún no tiene ningún domain — toda iniciativa exige uno. La paleta de comandos muestra la pista “Crie um domain primeiro” (crea un domain primero).

  • Abre Domains en la barra lateral de Forge y haz clic en Novo domain (nuevo domain).
  • Crea el domain y vuelve a Initiatives — el botón Nova iniciativa (nueva iniciativa) se habilita.

“Nenhum PR vinculado” (ningún PR vinculado) en la issue

Causa: la branch o el PR no referencia la issue — el vínculo es automático solo cuando la branch empieza con el patrón iss-N- o la descripción del PR contiene closes #N.

  • En la página completa de la issue, usa Copiar nome da branch (copiar nombre de la branch) y crea la branch con ese nombre.
  • Para un PR ya abierto, añade closes #N (con el número de la issue) a la descripción.
  • Confirma que la integración con GitHub está conectada y el repositorio, sincronizado.

“Não encontramos o time que iniciou a conexão. Volte ao Forge e tente novamente.” (no encontramos el equipo que inició la conexión)

Causa: la instalación de la GitHub App se concluyó en otro navegador, o los datos locales del sitio se borraron durante el proceso.

  • Vuelve a la página GitHub de Forge.
  • Haz clic en Conectar GitHub y concluye la instalación en el mismo navegador, sin borrar los datos por el camino.

“A assinatura do GitHub não confere com o pedido enviado. Por segurança, reinicie a conexão.” (la firma de GitHub no coincide con la solicitud enviada)

Causa: la verificación de seguridad del retorno de GitHub no coincidió con la solicitud original.

  • Reinicia la conexión desde la página GitHub de Forge, con Conectar GitHub.

No puedo editar las fechas del ciclo

Causa: lo que se puede editar depende del estado del ciclo — los campos fuera de la regla aparecen deshabilitados.

  • Próximo: Objetivo, Início (inicio) y Término (fin) — y solo en ese estado el ciclo puede eliminarse.
  • Ativo (activo): solo Objetivo y Término (fin).
  • Concluído (concluido): solo el Objetivo.

El ciclo no muestra burndown

Causa: el ciclo aún está Próximo o no tiene issues. No existe una acción de iniciar — el ciclo pasa a Ativo (activo) cuando llega la fecha de inicio.

  • Adelanta el campo Início (inicio) del ciclo (posible en ciclos Próximo) o espera la fecha.
  • Añade issues al ciclo con Adicionar issue ao ciclo (añadir issue al ciclo), en la pestaña Lista del ciclo.

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

Causa: la página Bloqueios (bloqueos) está restringida a gestores y administradores de Forge.

  • Sigue los bloqueos de tus issues por la sección Bloqueada del Inbox.
  • Si tu rol debería ser de gestor, pide a un administrador del equipo que lo ajuste en miembros del equipo.

Los repositorios no aparecen después de conectar

Causa: la instalación de la GitHub App no incluye los repositorios esperados, o la lista aún no se sincronizó.

  • En GitHub, haz clic en Gerenciar instalação (gestionar instalación) y confirma a qué repositorios puede acceder la app.
  • Haz clic en Sincronizar repositórios (sincronizar repositorios) y revisa la “Última sincronização” (última sincronización).

Siguiente