KubeBolt docs
ENES GitHub

Kobi

Conectores de nube

Deja que Kobi lea los recursos de AWS y Azure de los que depende un workload, en solo lectura, a través de servidores MCP seleccionados. Qué incluye cada edición, cómo configurarlos y qué queda fuera.

En esta página
  1. Qué incluye cada edición
  2. Qué lee
  3. Solo lectura, por capas
  4. Configurar AWS
  5. Configurar Azure (open source)
  6. Quién puede usar un conector
  7. Cómo se usa
  8. Desactivarlo
  9. Bloquear una operación
  10. Una alerta ante rechazos repetidos
  11. Solución de problemas

Kobi ve dentro del clúster. Cuando un workload falla por algo que está fuera de él (una base de datos detenida, una regla de firewall eliminada, una cola llena de mensajes fallidos, una cuota que bloquea un node pool), la evidencia en Kubernetes se queda en “cannot connect”. Los conectores de nube permiten a Kobi leer esos recursos en tu cuenta de la nube. En KubeBolt Cloud, el investigador, el planificador y el postmortem de Autopilot también los leen.

Los conectores llegaron con KubeBolt 2.5.0 (open source) y 2.5.0-e2 (Cloud y EE autoalojado).

Qué incluye cada edición

Open sourceKubeBolt CloudEE autoalojado
Amazon Web Services✅✅ Desde el plan Team✅
Microsoft Azure✅ A través de un sidecarSoonSoon
Google CloudSoonSoonSoon

Qué lee

Lo que ningún conector lee: el contenido de las bases de datos (ni SQL, ni ítems de DynamoDB), los valores de los secretos, el contenido de los objetos de S3, el contenido de los mensajes, las capas de las imágenes ni el código de las funciones. En Azure, el Azure MCP Server no tiene herramientas de red (NSG, tablas de rutas, balanceadores de carga, endpoints privados) ni de Microsoft Entra ID: Kobi solo ve un cambio de red a través del registro de actividad.

Una credencial rotada, rastreada hasta su origen. Cuando la credencial de un workload viene de un almacén de la nube a través de External Secrets, Kobi lee el ExternalSecret y su store: la clave remota, el proveedor y la región, y cuándo funcionó la última sincronización. Con el conector de AWS pregunta después a Secrets Manager cuándo rotó ese secreto exacto, y a CloudTrail quién lo rotó. Pregunta por ese único secreto en lugar de listar los de la cuenta, y nunca lee un valor.

Una dependencia a la que se llega a través de un Service ExternalName se sigue hasta donde sale del clúster, así que una base de datos gestionada que esté detrás de uno se busca en la nube.

Solo lectura, por capas

La solo lectura se impone, no se promete:

Límites: 12 llamadas a la nube por pregunta a Kobi, 40 por ejecución de Autopilot, 4 a la vez por conector y 30 s por llamada. Las llamadas a la nube también tienen un presupuesto por minuto, con una cuarta parte de él a la vez: en open source, el de Kobi es de 120 por minuto y 30 a la vez. En KubeBolt Cloud, Kobi y Autopilot tienen cada uno su propio presupuesto, fijado por tu plan, así que un chat que agota su minuto nunca retiene una corrección. AWS, por su parte, permite 10 peticiones por segundo por cuenta y región a su MCP Server. Autopilot solo va a una cuenta de la nube por lo que la ejecución ha situado allí: una dependencia que encontró su propio get_external_connections, el propio clúster o el store que hay detrás de un External Secret. Hasta entonces, sus llamadas a la nube se rechazan.

Una llamada que retuvo el presupuesto es un límite, no un fallo. La tarjeta de Kobi la muestra en ámbar, con un reloj (Not read — cloud call limit: 120/min, 30 at once); cuenta entre las lecturas que no se pudieron hacer, una conversación reabierta la muestra igual, y a Kobi se le dan las mismas cifras. Una llamada que KubeBolt rechazó antes del proveedor muestra Not sent. Las dos cuentan como rate_limited y not_sent en kubebolt_kobi_copilot_tool_results_total, no como errores, así que Administration → AI (Kobi) → Health no las muestra como herramientas que fallan.

Configurar AWS

Los conectores están en Administration › AI & Autopilot › Connectors en Cloud y EE, y en Administration › AI (Kobi) › Connectors en open source.

  1. Abre Amazon Web Services y elige IAM role. El panel lateral imprime las políticas de permisos y de confianza del rol, con el External ID de tu organización ya incluido, y los comandos de la CLI que lo crean.
  2. Crea el rol en tu cuenta de AWS.
  3. Pega el ARN del rol, elige la Region en la que están los recursos de tus workloads y la AWS MCP Server location (us-east-1 o eu-central-1; las llamadas siguen yendo a tu región) y luego haz clic en Test connection.
  4. Si quieres, configura Who can use it in Kobi (ver más abajo) y después haz clic en Save and enable.

El External ID se genera una vez por organización y se muestra en solo lectura. Se conserva cuando eliminas el conector, así que al configurarlo de nuevo se imprime el mismo ID y el rol sigue funcionando.

En KubeBolt Cloud

El rol asumido es el único modo, y se rechazan dos tipos de rol:

Para comprobar lo segundo, KubeBolt intenta asumir tu rol sin el External ID y con una política de sesión que lo deniega todo, antes de usarlo por primera vez y cada hora a partir de entonces. AWS tiene que rechazarlo. Tu CloudTrail muestra cada comprobación como un AssumeRole denegado desde la sesión kubebolt-external-id-check. Es lo esperado.

Cuando lo autoalojas

Los dos modos parten de la identidad de AWS con la que funciona la API: el modo IAM role la usa para asumir tu rol.

VariableValor de HelmPor defectoSignificado
KUBEBOLT_MCP_CONNECTORSmcpConnectors.enabledactivadofalse quita la pestaña Connectors y las herramientas de nube
KUBEBOLT_MCP_AWS_PRINCIPAL_ARNmcpConnectors.aws.principalArn(ninguno)La identidad de AWS con la que funciona la API, impresa como principal de la política de confianza
(ninguna)mcpConnectors.aws.webIdentity.enabledfalseIntercambia el token de la ServiceAccount de la API por principalArn fuera de EKS
KUBEBOLT_MCP_TOOL_TIMEOUTextraEnv30sTiempo límite por llamada
KUBEBOLT_MCP_AZMCP_URL(ninguno)http://127.0.0.1:5001/Dónde escucha el sidecar de Azure. Solo loopback

Detrás de un firewall de salida, permite AWS STS y aws-mcp.us-east-1.api.aws, o aws-mcp.eu-central-1.api.aws, la otra región de alojamiento del conector.

La primera llamada de una sesión tarda 9–12 s mientras AWS arranca su sandbox. Las siguientes tardan 2–3 s.

Configurar Azure (open source)

El Azure MCP Server funciona junto a la API y guarda una entidad de servicio de solo lectura con los roles Reader, Monitoring Reader y Log Analytics Reader. Un servidor guarda una sola identidad, así que una instalación lee un solo tenant de Azure. La guía de configuración del conector te da los comandos con tu suscripción ya puesta:

  1. Crea la entidad de servicio y guarda el appId, el password y el tenant que imprime:

    SUB=<subscription-id>
    az ad sp create-for-rbac --name kubebolt-azure-reader --role Reader --scopes /subscriptions/$SUB
    APP_ID=<appId from the output>
    az role assignment create --assignee $APP_ID --role "Monitoring Reader" --scope /subscriptions/$SUB
    az role assignment create --assignee $APP_ID --role "Log Analytics Reader" --scope /subscriptions/$SUB

    Opcional, limitado a los recursos que Kobi debe leer: Azure Service Bus Data Receiver en un namespace (mensajes pendientes y mensajes fallidos) y Key Vault Reader en un vault (caducidad de claves y certificados). Nunca concedas Key Vault Secrets User.

  2. Ejecuta el sidecar:

    • Helm: configura mcpConnectors.azure.sidecar.enabled=true, con existingSecret apuntando a un Secret que tenga tenant-id, client-id y client-secret. Se ejecuta como segundo contenedor del pod de la API, solo en loopback, con un sistema de archivos raíz de solo lectura y sin token de ServiceAccount. La imagen está fijada por digest a la versión contra la que se revisó la lista de permitidas de KubeBolt, Azure MCP Server 4.0.0-beta.6 desde la 2.6.6; cámbiala solo con una versión de KubeBolt. Si la replicas en un registro privado, replica esa versión.
    • Docker Compose: pon AZURE_TENANT_ID, AZURE_CLIENT_ID y AZURE_CLIENT_SECRET en deploy/.env y luego ejecuta docker compose --profile azure up -d.
  3. Abre Microsoft Azure en Connectors, introduce el ID de la suscripción (y el ID del tenant solo si la entidad de servicio ve varios directorios), haz clic en Test connection y después en Save and enable.

Para ver el estado actual de Resource Health, alguien con Owner o Contributor en la suscripción registra el proveedor una vez. Registrarlo no crea ningún recurso y es gratis:

az provider register --namespace Microsoft.ResourceHealth --subscription <id>

Sin ese registro, Kobi sigue viendo los eventos de salud en el registro de actividad.

Quién puede usar un conector

Cada conector tiene un rol mínimo para la persona que le pregunta a Kobi, que se configura en su panel lateral en Who can use it in Kobi: Editors and admins (por defecto), Everyone o Admins only. Un usuario por debajo de ese rol no recibe las herramientas del conector; Kobi le dice que el conector existe y qué rol necesita, y una llamada que se haga de todos modos se rechaza y se registra como denegada. Configurar un conector requiere el rol Admin.

Un conector lee la cuenta de la nube de la organización para todos los que estén por encima de ese rol. No se limita por equipo. Autopilot no está sujeto al rol mínimo. El servidor MCP nunca sirve herramientas de conectores.

Cómo se usa

Pregunta como siempre: “orders-api no está listo, ¿por qué?”. Cuando la evidencia apunta fuera del clúster, Kobi clasifica la dirección con get_external_connections y usa el conector correspondiente. Los pasos marcan dónde sale del clúster (“Leaves the cluster → AWS us-east-2 · read-only”), y la respuesta termina con una nota que dice lo que leyó.

Para que las preguntas dentro de un clúster se queden en un modelo pequeño, configura un modelo de escalamiento.

Desactivarlo

mcpConnectors.enabled=false (KUBEBOLT_MCP_CONNECTORS=false) quita la pestaña Connectors y las herramientas de nube. Los conectores guardan su configuración en el almacén de ajustes de KubeBolt, así que necesitan la autenticación activada: si está desactivada, no hay pestaña Connectors.

Bloquear una operación

Lo que puede ejecutar un conector es una lista en el código. Para detener una operación sin esperar a una versión (una lectura que resulta exponer datos, o una que Kobi pide una y otra vez), un admin la añade en Administration → AI (Kobi) → Blocked operations:

Una alerta ante rechazos repetidos

La pasarela de conectores rechaza una llamada antes de que llegue al proveedor cuando Kobi pide una herramienta que su conjunto no incluye (tool_not_allowed) o envía una entrada que el conector rechaza (input_refused). Cada rechazo se detiene y se audita, y una serie de ellos tiene la forma de una inyección de prompt. Desde la 2.7.0:

Solución de problemas

SíntomaCausa
”This role can be assumed without your organization’s External ID.”A la política de confianza le falta la condición sts:ExternalId. Añádela desde la política impresa y vuelve a probar
La prueba de AWS no puede asumir el rol después de una actualizaciónLa política de confianza todavía tiene un external ID antiguo. Copia el generado desde el panel lateral
La tarjeta muestra un candado y una insignia de planEl plan de la organización está por debajo del mínimo del conector
No aparece la pestaña ConnectorsmcpConnectors.enabled=false, o la autenticación está desactivada
La prueba de AWS falla en el pod de la API por falta de credencialesLa ServiceAccount no tiene rol de IAM: añade la anotación de IRSA o una asociación de Pod Identity, o activa webIdentity fuera de EKS
Prueba de Azure: “Nothing answers at…”El sidecar no está en ejecución (mcpConnectors.azure.sidecar.enabled, o el perfil azure de compose)
El contenedor azure-mcp falla con CreateContainerConfigErrorFalta el Secret, o no tiene tenant-id, client-id o client-secret
En OpenShift, el pod se rechaza por el runAsUser del sidecarQuita mcpConnectors.azure.sidecar.securityContext.runAsUser: restricted-v2 asigna uno
El botón de prueba dice “Test again in Ns”Las pruebas tienen un ritmo limitado por conector
Una tarjeta de herramienta dice STS AssumeRole refused KubeBolt (AccessDenied)La política de confianza del rol no deja que la identidad de KubeBolt lo asuma. El texto del SDK de AWS queda en el log de la API, y la llamada cuenta como unauthorized
Una tarjeta de herramienta dice Not read — cloud call limit…El presupuesto por minuto retuvo la llamada. Kobi sigue sin ella; vuelve a preguntar en unos segundos
Una tarjeta de herramienta dice Not sentKubeBolt rechazó la llamada antes del proveedor: una operación bloqueada, una herramienta que el conector no incluye, o una pregunta que ya usó sus 12 llamadas a la nube
Se rechazan todas las llamadas a los conectoresNo se puede leer la lista de operaciones bloqueadas, así que la pasarela falla en cerrado. El log de la API dice por qué
resourcehealth responde 409Microsoft.ResourceHealth todavía no está registrado, o se está registrando. En nuestra prueba tardó unos diez minutos
Kobi no usa un conector para un usuario concretoEl rol de ese usuario está por debajo del mínimo del conector
Kobi no usa un conector en absolutoNo está activado y verificado, o la evidencia del clúster respondió antes, que es lo previsto