feat(runme): integrar Runme como sidecar de documentación ejecutable
Agrega RUNBOOK.md y runbooks/ (fuera de content/, para no interferir con la publicación de Zola), con reglas de nombres/etiquetas/aislamiento de celdas mutantes verificadas por clusterlog validate. Instalación pinneada a v3.17.4 con checksum verificado (scripts/runme-install.sh), un job de CI separado (.gitea/workflows/ci.yml) que sólo corre celdas ci-safe, y la decisión documentada en docs/adr/0004-runme-sidecar.md y docs/RUNME.md. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
+37
@@ -121,6 +121,43 @@ Ante contenido sensible o firma cuestionable:
|
||||
6. documente el incidente en el sistema canónico, enlazando una memoria redactada cuando sea seguro;
|
||||
7. actualice manuales y controles preventivos.
|
||||
|
||||
## Documentación ejecutable (Runme)
|
||||
|
||||
`RUNBOOK.md` y `runbooks/**/*.md` permiten abrir procedimientos como
|
||||
notebooks ejecutables (ver `docs/RUNME.md` y ADR-0004). Esto no cambia el
|
||||
modelo de confianza: se agregan las siguientes reglas.
|
||||
|
||||
- Ejecutar una celda de Runme equivale exactamente a ejecutar el comando
|
||||
local con los permisos del usuario que la corre. No hay una elevación ni
|
||||
un sandbox adicional.
|
||||
- El usuario debe leer una celda antes de ejecutarla, igual que revisaría
|
||||
cualquier comando pegado desde un chat o un documento.
|
||||
- Un agente de IA no puede activar una celda `risk-mutating`/`risk-destructive`
|
||||
sin autorización explícita del usuario para esa operación puntual — igual
|
||||
que con cualquier otro comando mutante.
|
||||
- Una etiqueta (`ci-safe`, `role-*`, `risk-*`) es metadato de clasificación,
|
||||
**no** un control de acceso. `interactive` y `excludeFromRunAll` son
|
||||
defensas adicionales que Runme sí respeta técnicamente, pero tampoco son
|
||||
autorización: son mecanismos para reducir el riesgo de un "Run All"
|
||||
accidental, no una barrera de permisos.
|
||||
- Runme no debe leer, exportar ni copiar ninguna llave privada. Ninguna
|
||||
celda de este repositorio lo hace ni debe hacerlo.
|
||||
- No se guardan outputs de celdas con secretos. Los Session Outputs de
|
||||
Runme están desactivados por defecto en esta integración; si se habilitan
|
||||
localmente, no deben versionarse ni compartirse.
|
||||
- Runme Cloud, Gists y cualquier servicio remoto de Runme quedan fuera de
|
||||
alcance. `runme open` (servidor web local) no debe exponerse en `0.0.0.0`.
|
||||
- La ejecución de celdas desde el sitio Zola publicado está fuera de
|
||||
alcance: Zola no construye `runbooks/`, y no existe ningún mecanismo para
|
||||
correr Runme desde el navegador.
|
||||
- Las operaciones productivas reales (RBAC, `sudo`, gestores de secretos,
|
||||
kubeconfig, proveedor cloud, controles corporativos) siguen siendo
|
||||
responsabilidad de esas herramientas. Runme nunca las reemplaza ni las
|
||||
reimplementa.
|
||||
- Un agente debe detenerse ante errores de identidad, firma o validación
|
||||
también dentro de un runbook, igual que en cualquier otro flujo de
|
||||
`clusterlog`.
|
||||
|
||||
## Reporte de vulnerabilidades
|
||||
|
||||
No abra un issue público con detalles sensibles. Use el canal privado de seguridad de la organización y proporcione versión, impacto, pasos de reproducción y una prueba sin secretos reales.
|
||||
|
||||
Reference in New Issue
Block a user