Usar Forjar
GitHub
Cómo le das trabajo a Forjar en GitHub, qué hace con tus repositorios y cómo proteges la rama principal.
Forjar trabaja en GitHub como una GitHub App. En cloud instalas la de Forjar; en self-hosted, la tuya. Instálala solo en los repositorios en los que puede trabajar.
Darle una issue
Ponle la etiqueta forja a una issue de un repositorio con factory. En segundos aparece en la cabina.
Forjar solo toma una issue si su autor es propietario, miembro o colaborador del repositorio, o si la etiqueta la puso una persona del equipo. La issue de un desconocido espera a que uno de vosotros la etiquete.
Qué hace en tu repositorio
- Trabaja solo en ramas
forja/…y abre PRs contra la rama por defecto. - Publica el check
forja/gateen cada PR suyo, yforja/verifysi le diste un comando de verificación. - Lee los checks de tu CI como evidencia.
- Mergea con squash cuando el gate se abre.
- Ignora los PRs que no son de una rama
forja/*que subió un run suyo.
Protege la rama principal
GitHub no puede limitar un token de instalación a una rama. El ruleset es lo que mantiene a Forjar fuera de tu rama principal. En cada repositorio instalado: Settings › Rules › Rulesets › New branch ruleset, apuntando a la rama por defecto, con Enforcement en Active.
- Require a pull request before merging, con 0 aprobaciones requeridas. Forjar registra las aprobaciones; una aprobación obligatoria de GitHub bloquearía los cambios normales.
- Require status checks to pass, con
forja/gatey eligiendo la app de Forjar como origen, para que nadie más pueda publicar un estado verde con ese nombre. - Block force pushes y Restrict deletions.
- Bypass list: vacía, o solo tú si quieres subir tu trabajo directamente. No añadas la app de Forjar: tiene que pasar por el gate.
Con el ruleset, tus propios PRs también esperan a forja/gate, y Forjar
nunca lo publica en un PR que no es suyo. Si abres PRs a mano, ponte en la
bypass list.
Aprobar desde GitHub
Una aprobación en GitHub de una persona del equipo cuenta como la de la cabina.
- Solo cuenta si se da sobre el commit que es la cabeza del PR. Un push después de aprobar empieza la revisión otra vez.
- Una revisión que pide cambios de una persona cierra el gate hasta el siguiente push.
- Una aprobación que llega antes de que Forjar clasifique el PR falla. Reenvíala cuando esté clasificado.
Colaboradores
Los colaboradores con permiso de escritura son de confianza: pueden subir a ramas forja/*. Mantén corta la lista de colaboradores.