KubeBolt docs
ENES GitHub

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
  1. El catálogo de acciones
  2. Vista previa con dry-run
  3. Interruptores de gobernanza
  4. Las acciones de Kobi Autopilot
  5. Registro de auditoría

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ónEndpointRolKobi puede proponerla
Reinicio progresivoPOST …/restartEditorpropose_restart_workload
Escalar réplicasPOST …/scaleEditorpropose_scale_workload
Revertir un Deployment, StatefulSet o DaemonSetPOST …/rollbackEditorpropose_rollback_deployment (Deployments)
Cambiar la imagen del contenedorPOST …/set-imageEditorpropose_set_image
Cambiar requests / limitsPOST …/set-resourcesEditorpropose_set_resources
Cambiar variables de entornoPOST …/set-envEditorpropose_set_env
Réplicas mín./máx. de un HPAPOST /resources/hpas/…/set-boundsEditorpropose_patch_hpa
Contenedor de depuración efímeroPOST …/debugEditorpropose_debug_pod
Eliminar un recursoDELETE /resources/{type}/{ns}/{name}Adminpropose_delete_resource
Aplicar YAML editadoPUT …/yamlEditorNo
Crear desde un manifiestoPOST /resources/{type}/{ns}EditorNo
Editar etiquetas y anotacionesPOST …/edit-metadataEditorNo
Revelar el valor de un SecretPOST /resources/secrets/…/revealEditor, Admin en namespaces de producciónNo
Acordonar / desacordonar un nodo (cordon / uncordon)POST …/cordon · …/uncordonEditorNo
Desalojar un podPOST …/evictEditorNo
Pausar / reanudar un rolloutPOST …/rollout-pause · …/rollout-resumeEditorNo
Suspender / reanudar / lanzar un CronJobPOST …/suspend · …/resume · …/triggerEditorNo
Drenar un nodoPOST …/drain (GET lo sigue, DELETE lo cancela)AdminNo
Abrir un port-forwardPOST /portforwardEditorNo

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:

OrigenCuándo
uiUna persona en una sesión del navegador
apiEl token de API de una persona
copilot_proposalUna propuesta de Kobi ejecutada desde la propia sesión de la persona y su propia conversación
autopilotKobi 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 entornoPor defectoEfecto cuando está desactivada
KUBEBOLT_AI_ACTIONS_ENABLEDtrueLas 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_ENABLEDtrueLa 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 AutopilotQué cambia
restart_deploymentReinicio progresivo de un Deployment
scale_deploymentNúmero de réplicas de un Deployment
rollback_deploymentRevierte un Deployment a una revisión anterior
patch_deployment_resourcesRequests y limits de CPU/memoria de un workload
patch_hpaminReplicas / maxReplicas de un HPA
patch_probeLos tiempos de la readiness o liveness probe de un workload
verify_pods_readyNada: espera a que los pods estén Ready (180 s por defecto)
inform_onlyNada: le dice a una persona qué hacer, ante una causa fuera del clúster

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:

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.