Repolode
kubernetes-sigs

kubernetes-sigs/agent-sandbox

Um controller e uma CRD do Kubernetes para gerenciar sandboxes isoladas, com estado e em um único pod, voltadas a runtimes de agentes de IA e workloads de RL.

Estrelas
4,534
Forks
607
Issues abertas
177
Último commit
ontem

O que é?

agent-sandbox adiciona ao Kubernetes um recurso customizado Sandbox e um controller para executar um workload de longa duração em um único container, com hostname estável, identidade de rede e armazenamento persistente opcional. O projeto preenche uma lacuna entre Deployments, que são stateless e replicados, e StatefulSets, que gerenciam conjuntos numerados de pods. O projeto é desenvolvido pela SIG Apps.

O módulo opcional de extensões adiciona SandboxTemplate, para definições reutilizáveis de sandbox; SandboxWarmPool, para manter sandboxes pré-aquecidas prontas para alocação; e SandboxClaim, para solicitar uma sandbox de um pool sem precisar gerenciar toda a configuração. Os pods de sandbox podem ser configurados para rodar com runtimes como gVisor ou Kata Containers por meio de RuntimeClass, deixando a orquestração a cargo do controller e o isolamento a cargo do runtime.

O projeto também oferece SDKs para Go e Python e o Sandbox Router, um proxy reverso HTTP que encaminha o tráfego dos clientes aos pods de sandbox. A instalação pode ser feita com manifests do kubectl ou Helm.

Recursos principais

  • 01A CRD Sandbox fornece um pod com estado, hostname estável e identidade de rede.
  • 02O armazenamento persistente pode sobreviver a reinicializações do pod.
  • 03O gerenciamento do ciclo de vida inclui criação, exclusão programada, pausa e retomada.
  • 04SandboxWarmPool mantém sandboxes pré-aquecidas prontas para alocação rápida.
  • 05SandboxClaim solicita sandboxes de um pool sem gerenciar toda a configuração.
  • 06Funciona com gVisor ou Kata Containers por meio de RuntimeClass.
  • 07Há SDKs para Go e Python.

Casos de uso

  • Executar código gerado por LLMs ou não confiável em ambientes isolados para agentes de IA.
  • Disponibilizar sandboxes de inicialização rápida para loops de aprendizado por reforço e avaliação.
  • Hospedar ambientes de desenvolvimento persistentes na nuvem ou sessões no estilo Jupyter.
  • Executar serviços de instância única que precisam de uma identidade estável sem a sobrecarga de StatefulSet.

Início rápido

  1. 1

    Instale o núcleo e as extensões com kubectl (versão mais recente)

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

    Verifique se o CRD de Sandbox está instalado

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

    Aplique um manifesto de Sandbox com sua imagem de contêiner

Antes de usar

  • Requer um cluster Kubernetes com o controlador agent-sandbox instalado.
  • O isolamento do Sandbox depende de um runtime separado, como gVisor ou Kata Containers.

Em coleções

Tópicos

Perguntas frequentes

O que é agent-sandbox?
Um controller e uma CRD do Kubernetes para gerenciar sandboxes isoladas, com estado e em um único pod, voltadas a runtimes de agentes de IA e workloads de RL. agent-sandbox adiciona ao Kubernetes um recurso customizado Sandbox e um controller para executar um workload de longa duração em um único container, com hostname estável, identidade de rede e armazenamento persistente opcional. O projeto preenche uma lacuna entre Deployments, que são stateless e replicados, e StatefulSets, que gerenciam conjuntos numerados de pods. O projeto é desenvolvido pela SIG Apps.
agent-sandbox é gratuito? Qual é a licença?
agent-sandbox é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
agent-sandbox ainda é mantido?
Manutenção ativa. O último commit de agent-sandbox foi em 6 de nov. de 2026.
Para que posso usar agent-sandbox?
Executar código gerado por LLMs ou não confiável em ambientes isolados para agentes de IA. Disponibilizar sandboxes de inicialização rápida para loops de aprendizado por reforço e avaliação. Hospedar ambientes de desenvolvimento persistentes na nuvem ou sessões no estilo Jupyter. Executar serviços de instância única que precisam de uma identidade estável sem a sobrecarga de StatefulSet.
Como instalar agent-sandbox?
Instale o núcleo e as extensões com kubectl (versão mais recente): kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml Verifique se o CRD de Sandbox está instalado: kubectl get crd sandboxes.agents.x-k8s.io Aplique um manifesto de Sandbox com sua imagem de contêiner
Onde consigo agent-sandbox?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/kubernetes-sigs/agent-sandbox

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados