Repolode
kubernetes-sigs

kubernetes-sigs/agent-sandbox

Un controlador de Kubernetes y una CRD para gestionar sandboxes aislados, con estado y de un solo pod, orientados a entornos de ejecución de agentes de IA y cargas de trabajo de RL.

Estrellas
4,514
Forks
600
Issues abiertos
177
Último commit
hace 19 horas

¿Qué es?

agent-sandbox añade a Kubernetes un recurso personalizado Sandbox y un controlador para ejecutar cargas de trabajo de larga duración en un solo contenedor, con nombre de host estable, identidad de red y almacenamiento persistente opcional. Cubre el espacio entre Deployments, que no mantienen estado y se replican, y StatefulSets, que gestionan conjuntos de pods numerados. El proyecto se desarrolla bajo SIG Apps.

El módulo opcional de extensiones añade SandboxTemplate para definir sandboxes reutilizables, SandboxWarmPool para mantener sandboxes precalentados listos para asignar y SandboxClaim para solicitar un sandbox de un pool sin tener que gestionar toda su configuración. Los pods de Sandbox se pueden configurar para ejecutarse con runtimes como gVisor o Kata Containers mediante RuntimeClass; así, el controlador se encarga de la orquestación y el runtime proporciona el aislamiento.

El proyecto también incluye SDK de Go y Python y Sandbox Router, un proxy inverso HTTP que dirige el tráfico de los clientes a los pods de sandbox. La instalación se realiza mediante manifests de kubectl o Helm.

Funciones clave

  • 01La CRD Sandbox proporciona un pod con estado, nombre de host estable e identidad de red.
  • 02El almacenamiento persistente puede conservarse tras reiniciar los pods.
  • 03La gestión del ciclo de vida incluye la creación, la eliminación programada, la pausa y la reanudación.
  • 04SandboxWarmPool mantiene sandboxes precalentados listos para asignarlos rápidamente.
  • 05SandboxClaim permite solicitar sandboxes de un pool sin gestionar toda su configuración.
  • 06Compatible con gVisor o Kata Containers mediante RuntimeClass.
  • 07Hay SDK de Go y Python disponibles.

Casos de uso

  • Ejecutar código generado por LLM o no confiable en entornos aislados para agentes de IA.
  • Proporcionar sandboxes de inicio rápido para bucles de aprendizaje por refuerzo y evaluación.
  • Alojar entornos de desarrollo en la nube con estado o sesiones tipo Jupyter.
  • Ejecutar servicios de instancia única que necesitan una identidad estable sin la complejidad adicional de StatefulSet.

Inicio rápido

  1. 1

    Instala el núcleo y las extensiones con kubectl (última versión)

    kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml
  2. 2

    Verifica que el CRD de Sandbox esté instalado

    kubectl get crd sandboxes.agents.x-k8s.io
  3. 3

    Aplica un manifiesto de Sandbox con tu imagen de contenedor

Antes de usarlo

  • Requiere un clúster de Kubernetes con el controlador agent-sandbox instalado.
  • El aislamiento de Sandbox depende de un entorno de ejecución independiente, como gVisor o Kata Containers.

En colecciones

Temas

Preguntas frecuentes

¿Qué es agent-sandbox?
Un controlador de Kubernetes y una CRD para gestionar sandboxes aislados, con estado y de un solo pod, orientados a entornos de ejecución de agentes de IA y cargas de trabajo de RL. agent-sandbox añade a Kubernetes un recurso personalizado Sandbox y un controlador para ejecutar cargas de trabajo de larga duración en un solo contenedor, con nombre de host estable, identidad de red y almacenamiento persistente opcional. Cubre el espacio entre Deployments, que no mantienen estado y se replican, y StatefulSets, que gestionan conjuntos de pods numerados. El proyecto se desarrolla bajo SIG Apps.
¿agent-sandbox es gratuito? ¿Qué licencia tiene?
agent-sandbox es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿agent-sandbox sigue mantenido?
Mantenimiento activo. El último commit de agent-sandbox fue el 5 nov 2026.
¿Para qué puedo usar agent-sandbox?
Ejecutar código generado por LLM o no confiable en entornos aislados para agentes de IA. Proporcionar sandboxes de inicio rápido para bucles de aprendizaje por refuerzo y evaluación. Alojar entornos de desarrollo en la nube con estado o sesiones tipo Jupyter. Ejecutar servicios de instancia única que necesitan una identidad estable sin la complejidad adicional de StatefulSet.
¿Cómo se instala agent-sandbox?
Instala el núcleo y las extensiones con kubectl (última versión): kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml Verifica que el CRD de Sandbox esté instalado: kubectl get crd sandboxes.agents.x-k8s.io Aplica un manifiesto de Sandbox con tu imagen de contenedor
¿Dónde consigo agent-sandbox?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/kubernetes-sigs/agent-sandbox

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados