Kobi
Acciones y gobernanza
El catálogo completo de acciones, la aplicación de RBAC, las vistas previas con dry-run, los interruptores de gobernanza de Kobi y el registro de auditoría que hay detrás de cada cambio.
En esta página
KubeBolt no solo observa: también actúa. Las acciones llegan al clúster desde una persona (una acción en la UI desde la página de un recurso, o una llamada con un token de API), desde una propuesta de Kobi Copilot que una persona aprueba en el chat y, en KubeBolt Cloud, desde Kobi Autopilot. Todas pasan por RBAC, la mayoría se pueden previsualizar antes de ejecutarse y todas quedan en el registro de auditoría. Esta página cubre el catálogo de acciones y los controles que lo rodean.
El catálogo de acciones
La API y la UI incluyen más acciones de las que Kobi puede proponer. Las herramientas
propose_* de Kobi son un subconjunto seleccionado: los nueve cambios sobre los que
es útil razonar en una conversación.
| Acción | Endpoint | Rol | Kobi puede proponerla |
|---|---|---|---|
| Reinicio progresivo | POST …/restart | Editor | propose_restart_workload |
| Escalar réplicas | POST …/scale | Editor | propose_scale_workload |
| Revertir un Deployment, StatefulSet o DaemonSet | POST …/rollback | Editor | propose_rollback_deployment (Deployments) |
| Cambiar la imagen del contenedor | POST …/set-image | Editor | propose_set_image |
| Cambiar requests / limits | POST …/set-resources | Editor | propose_set_resources |
| Cambiar variables de entorno | POST …/set-env | Editor | propose_set_env |
| Réplicas mín./máx. de un HPA | POST /resources/hpas/…/set-bounds | Editor | propose_patch_hpa |
| Contenedor de depuración efímero | POST …/debug | Editor | propose_debug_pod |
| Eliminar un recurso | DELETE /resources/{type}/{ns}/{name} | Admin | propose_delete_resource |
| Aplicar YAML editado | PUT …/yaml | Editor | No |
| Crear desde un manifiesto | POST /resources/{type}/{ns} | Editor | No |
| Editar etiquetas y anotaciones | POST …/edit-metadata | Editor | No |
| Revelar el valor de un Secret | POST /resources/secrets/…/reveal | Editor, Admin en namespaces de producción | No |
| Acordonar / desacordonar un nodo (cordon / uncordon) | POST …/cordon · …/uncordon | Editor | No |
| Desalojar un pod | POST …/evict | Editor | No |
| Pausar / reanudar un rollout | POST …/rollout-pause · …/rollout-resume | Editor | No |
| Suspender / reanudar / lanzar un CronJob | POST …/suspend · …/resume · …/trigger | Editor | No |
| Drenar un nodo | POST …/drain (GET lo sigue, DELETE lo cancela) | Admin | No |
| Abrir un port-forward | POST /portforward | Editor | No |
Drenar está junto a eliminar en Admin porque desalojar todos los pods de un nodo
puede incumplir los PodDisruptionBudgets y reducir la capacidad del clúster.
Acordonar y desacordonar se quedan en Editor: solo cambian un flag de planificación.
Desalojar un solo pod también es Editor: pasa por la API Eviction de policy/v1, así
que un PDB que se incumpliría devuelve 429 en lugar de una interrupción.
Cada registro indica su origen, que decide el servidor según quién hizo la petición;
una petición puede declarar uno con la cabecera X-KubeBolt-Action-Source, pero esa
declaración por sí sola no se da por buena:
| Origen | Cuándo |
|---|---|
ui | Una persona en una sesión del navegador |
api | El token de API de una persona |
copilot_proposal | Una propuesta de Kobi ejecutada desde la propia sesión de la persona y su propia conversación |
autopilot | Kobi Autopilot, que llama con su token de servicio |
Una declaración que no se dio por buena queda en el registro como claimedSource. El
mismo actor firma la escritura en el clúster: Kubernetes registra en los
managedFields del objeto el field manager kubebolt para una persona,
kubebolt-kobi para una propuesta de Copilot y kubebolt-autopilot para Autopilot.
El nombre de un manager es lo que la escritura dice ser, no quién la hizo:
cualquier cliente puede escribir con cualquier field manager, y Kobi lo lee así.
Un registro de Copilot enlaza con la conversación que lo propuso; uno de Autopilot,
con su ejecución y su incidente; y una acción que empezó desde un insight conserva el
id del insight de origen, así que el registro de auditoría se puede recorrer desde el
síntoma hasta la corrección.
Vista previa con dry-run
Todas las acciones que Kobi puede proponer aceptan ?dryRun=true: restart, scale,
rollback, set-image, set-resources, set-env, set-bounds, debug y delete. El dry-run
pasa por la admisión completa (dryRun=All), así que las infracciones de cuota, los
LimitRanges y los webhooks de admisión aparecen antes de que apruebes, con el
detalle de la cuota extraído del error del apiserver en lugar de mostrarlo en bruto.
La tarjeta de acción de Kobi ejecuta esa vista previa automáticamente para cada
propuesta, antes de que puedas hacer clic en Execute. Un dry-run nunca se audita
y nunca guarda nada.
Interruptores de gobernanza
Dos interruptores acotan lo que puede ejecutar Kobi Copilot. Los dos están activados por defecto, y los dos se pueden cambiar sin reiniciar como Kobi actions y Destructive actions en Administration → AI (Kobi) → Configuration (en KubeBolt Cloud, Administration → AI & Autopilot → Kobi Copilot):
| Variable de entorno | Por defecto | Efecto cuando está desactivada |
|---|---|---|
KUBEBOLT_AI_ACTIONS_ENABLED | true | Las herramientas propose_* se retiran por completo del modelo. Kobi sigue diagnosticando y recomendando, y en su lugar ofrece el comando kubectl equivalente. |
KUBEBOLT_AI_DESTRUCTIVE_ACTIONS_ENABLED | true | La eliminación se retira del modelo, y los endpoints de acciones rechazan una eliminación o un escalado a cero propuestos por Kobi con un 403 que nombra la política, no tu rol. El escalado a cero comparte la herramienta de escalado no destructiva, así que no se puede filtrar de la lista de herramientas. |
Cómo configurarlas con Helm o Docker Compose está en Activar Kobi.
Estos dos interruptores gobiernan solo las propuestas de Kobi Copilot: la
comprobación en el servidor se basa en X-KubeBolt-Action-Source: copilot_proposal.
Una acción de la UI desde la página de un recurso se rige por RBAC, no por estos
interruptores, y Autopilot tiene sus propios controles (más abajo). Desactivar
KUBEBOLT_AI_ACTIONS_ENABLED convierte a Kobi en asesor; no hace que la
instalación sea de solo lectura. Para eso, da a las personas el rol Viewer.
Juntos te permiten ajustar el radio de impacto a cada entorno: por ejemplo, propuestas y ejecución completas en desarrollo y solo diagnóstico en producción.
Las acciones de Kobi Autopilot
En KubeBolt Cloud, Autopilot ejecuta a través de los mismos endpoints, con su propio
token de servicio, y sus registros llevan el origen autopilot. Tiene un catálogo más
pequeño y fijo que Copilot, y sus propios controles:
| Acción de Autopilot | Qué cambia |
|---|---|
restart_deployment | Reinicio progresivo de un Deployment |
scale_deployment | Número de réplicas de un Deployment |
rollback_deployment | Revierte un Deployment a una revisión anterior |
patch_deployment_resources | Requests y limits de CPU/memoria de un workload |
patch_hpa | minReplicas / maxReplicas de un HPA |
patch_probe | Los tiempos de la readiness o liveness probe de un workload |
verify_pods_ready | Nada: espera a que los pods estén Ready (180 s por defecto) |
inform_only | Nada: le dice a una persona qué hacer, ante una causa fuera del clúster |
- Solo se ejecuta el plan. Un cambio solo se ejecuta como acción del plan de la ejecución, sobre el mismo objetivo y con los argumentos del plan.
- Lo que lee Autopilot es evidencia, nunca política. Un texto en anotaciones, etiquetas, variables de entorno, logs, tags de la nube u objetos de External Secrets no puede hacer que se retire, aplace o escale a cero: esa afirmación se registra como no verificada y el remedio se elige como si no existiera. Solo los ajustes de KubeBolt deciden si se actúa, con qué acción, la aprobación y el cooldown, y escalar a cero nunca se trata como una reparación.
- Una investigación que pide a una persona condiciona el plan. Toda acción que cambia algo espera entonces una aprobación, sea cual sea el modo y el riesgo. La aprobación (la tarjeta web, la cola, Slack, el correo de aprobación y los webhooks) avisa cuando su motivo cita el propio texto del workload.
- La aprobación depende del modo de operación. En Approve & execute cada cambio espera a una persona; en Autonomous, los rollbacks, el escalado a cero, los cambios de escala mayores y los parches de recursos más arriesgados siguen esperando. Aprobar o rechazar requiere el rol Editor, y una aprobación que nadie responde en 5 minutos (el valor por defecto) cuenta como rechazada. Cambiar los ajustes de Autopilot requiere Admin.
- Namespaces protegidos. La lista de la plataforma (
kube-system,kube-publicykube-node-leasepor defecto) más los que añada tu organización: Autopilot nunca abre un incidente ni cambia un workload en ellos. - Reversión si falla la verificación. Cuando los pods no quedan Ready después de un cambio, Autopilot lo revierte: automáticamente en Autonomous, después de una aprobación en Approve & execute.
Los modos y el proceso de los incidentes están en Conoce a Kobi; los ajustes, en KubeBolt Cloud.
Registro de auditoría
Cada cambio se guarda con la identidad y el rol de quien lo hizo, el origen de la acción, los parámetros aplicados y el resultado. Los cambios de administración (ajustes, conectores, clústeres, políticas de insights, integraciones) se registran igual, sin el cuerpo de sus peticiones. El registro se consulta a través de la API; no hay una página de auditoría en la UI:
curl -H "Authorization: Bearer $TOKEN" \
"https://kubebolt.example.com/api/v1/admin/actions?class=mutation&limit=200"
GET /api/v1/admin/actions es solo para administradores y devuelve primero los
registros más recientes. class es mutation, access o all (por defecto);
limit vale 100 por defecto (máximo 1000). Desde la 2.7.0, la clase se aplica antes
que el límite, así que una página filtrada se llena hasta él; un registro escrito
antes de que los registros llevaran clase se lee como una mutación. Los registros se
eliminan pasado KUBEBOLT_AUDIT_RETENTION_HORIZON (por defecto 2160h, 90 días).
Cada registro nombra el clúster sobre el que actuó: el que resolvió la petición en
las mutaciones y en las rutas de integraciones de ámbito de clúster (desde la
2.6.7), y el que alcanzó el acceso en terminales, port-forwards y lecturas de
archivos (desde la 2.6.4). Los registros anteriores pueden llevar en su lugar el
clúster por defecto de la instalación. Un registro de set-env guarda los nombres y
el origen de las variables que cambió, nunca sus valores, en el registro de
auditoría y en el log de la API; los registros antiguos se limpian al arrancar.
Dos tipos de acción tienen un peso extra en la auditoría:
- Revelar un Secret emite un segundo registro en un canal dedicado con el motivo escrito, las claves solicitadas y el resultado, incluidos los intentos denegados. Ninguno de los dos registros contiene nunca un valor. Consulta Vistas de recursos.
- Las sesiones de acceso (terminales de pods, port-forwards y lecturas y
descargas de archivos de pods) se registran con la clase
access, nomutation: un par de apertura y cierre con lo que se alcanzó, rutas, tamaños y duraciones. El contenido que pasa por ellas nunca se registra. Las llamadas de los conectores de nube también son registrosaccess(mcp_tool_call) y, desde la 2.7.0, nombran la operación aunque la llamada se bloqueara, la retuviera el presupuesto por minuto o fallara en el proveedor.
Las acciones siempre se ejecutan con los permisos RBAC detectados: Kobi nunca puede hacer más de lo que permite el clúster. Consulta RBAC para ver cómo KubeBolt detecta los permisos de las credenciales con las que se conecta (un kubeconfig, su propia ServiceAccount o la del agente) y se adapta a ellos, y Conectar clústeres para los tres niveles de permisos del agente.