Conectar el Playbook
Kadu lee el Playbook de dos formas: mediante la GitHub App de Kadu (recomendado) o mediante una deploy key SSH. En ambos casos el acceso es solo de lectura.
GitHub App de Kadu (recomendado)
Es el camino del primer acceso a la consola: la tarjeta Conecta el Playbook lleva a la instalación. Ver Primeros pasos.
| Con la GitHub App | |
|---|---|
| Permiso | Contents: Read-only, solo en los repositorios elegidos en la instalación |
| Lectura | un token de instalación generado en cada lectura, válido por 1 hora, restringido al repositorio de la organización |
| Actualización | cada push a la rama predeterminada avisa a Kadu, que sincroniza al instante |
| Desconexión | desinstalar la App, suspender la instalación o quitar el repositorio de ella desconecta la organización |
Al volver de GitHub, la consola comprueba que la instalación es de quien la
hizo antes de vincular el repositorio. Si la instalación cubre varios
repositorios, la consola te pide elegir cuál es el Playbook, marcando los que tienen
el catálogo del Playbook, .claude-plugin/marketplace.json.
Deploy key (sin la App)
Para un repositorio mantenido por Kobana, o cuando no se puede instalar la App:
- El equipo de Kobana registra la dirección SSH del repositorio en la
organización (
git@github.com:<dueño>/<repositorio>.git). - Kadu genera un par de claves y muestra la clave pública.
- En GitHub, en Settings → Deploy keys → Add deploy key, pega la clave pública sin marcar "Allow write access".
- Para la actualización en cada push, configura en Settings → Webhooks → Add
webhook la URL y el secret que indique el equipo de Kobana, con content
type
application/jsony el evento "Just the push event".
La clave privada se guarda cifrada y nunca sale de Kadu. Sin el webhook, la sincronización igual ocurre mediante la verificación cada hora.
Qué guarda Kadu
- La dirección del repositorio y, sin la App, la deploy key cifrada.
- El catálogo: el frontmatter de las skills con bloque
task:, leído en cada sincronización. - Los últimos commits leídos, mostrados en Configuración → Deployment.
Kadu no guarda una copia del código de las skills: cada ejecución clona la rama predeterminada en el momento en que empieza y borra el clon al final.
Un Playbook por organización
Una organización tiene un único Playbook, y en él están todos sus workspaces. Para un nuevo dominio de negocio, crea un nuevo plugin en el mismo repositorio (Nuevo workspace), y no un repositorio nuevo.