Repolode
제출하기
kubernetes-sigs

kubernetes-sigs/agent-sandbox

AI 에이전트 런타임과 RL 워크로드를 위한 격리된 상태 저장 단일 Pod 샌드박스를 관리하는 Kubernetes 컨트롤러 및 CRD입니다.

GitHub에서 보기웹사이트
스타
4,514
포크
600
열린 이슈
177
마지막 커밋
12시간 전

어떤 프로젝트인가요?

agent-sandbox는 안정적인 호스트 이름과 네트워크 ID, 선택적 영구 스토리지를 갖춘 장기 실행 단일 컨테이너 워크로드를 실행하기 위해 Kubernetes에 Sandbox 커스텀 리소스와 컨트롤러를 추가합니다. 상태 비저장 방식으로 복제되는 Deployment와 번호가 지정된 Pod 집합을 관리하는 StatefulSet 사이의 공백을 메웁니다. 이 프로젝트는 SIG Apps에서 개발합니다.

선택 사항인 extensions 모듈은 재사용 가능한 샌드박스 정의를 위한 SandboxTemplate, 사전 준비된 샌드박스를 대기 상태로 유지해 할당할 수 있도록 하는 SandboxWarmPool, 전체 구성을 다루지 않고 풀에서 샌드박스를 요청하는 SandboxClaim을 추가합니다. Sandbox Pod는 RuntimeClass를 통해 gVisor나 Kata Containers 같은 런타임에서 실행되도록 구성할 수 있어, 컨트롤러가 오케스트레이션을 담당하고 런타임이 격리를 제공합니다.

이 프로젝트는 Go 및 Python SDK와, 클라이언트의 트래픽을 샌드박스 Pod로 전달하는 HTTP 리버스 프록시인 Sandbox Router도 제공합니다. kubectl 매니페스트 또는 Helm을 통해 설치할 수 있습니다.

핵심 기능

  • 01Sandbox CRD는 안정적인 호스트 이름과 네트워크 ID를 갖춘 상태 저장 단일 Pod를 제공합니다.
  • 02영구 스토리지는 Pod가 재시작된 후에도 유지될 수 있습니다.
  • 03생성, 예약 삭제, 일시 중지 및 재개를 포함한 수명 주기 관리를 지원합니다.
  • 04SandboxWarmPool은 사전 준비된 샌드박스를 유지해 빠르게 할당할 수 있도록 합니다.
  • 05SandboxClaim은 전체 구성을 관리하지 않고 풀에서 샌드박스를 요청합니다.
  • 06RuntimeClass를 통해 gVisor 또는 Kata Containers와 함께 사용할 수 있습니다.
  • 07Go 및 Python SDK를 제공합니다.

활용 사례

  • AI 에이전트를 위해 LLM이 생성한 코드나 신뢰할 수 없는 코드를 격리된 환경에서 실행합니다.
  • 강화 학습 및 평가 루프에 빠르게 시작할 수 있는 샌드박스를 제공합니다.
  • 영구적인 클라우드 개발 환경이나 Jupyter 스타일 세션을 호스팅합니다.
  • StatefulSet의 오버헤드 없이 안정적인 ID가 필요한 단일 인스턴스 서비스를 실행합니다.

빠른 시작

  1. 1

    kubectl로 코어와 확장 기능을 설치합니다(최신 릴리스)

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

    Sandbox CRD가 설치되어 있는지 확인합니다

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

    컨테이너 이미지를 지정한 Sandbox 매니페스트를 적용합니다

사용 전 알아둘 점

  • agent-sandbox 컨트롤러가 설치된 Kubernetes 클러스터가 필요합니다.
  • Sandbox 격리에는 gVisor 또는 Kata Containers와 같은 별도의 런타임이 필요합니다.

포함된 컬렉션

AI 에이전트 샌드박스오픈소스 AI 에이전트 프레임워크와 앱강화학습 프레임워크와 학습 환경

토픽

#kubernetes#ai-agent#sandbox#reinforcement-learning#controller#crd#isolation#gvisor#agent#ai

자주 묻는 질문

agent-sandbox은(는) 무엇인가요?
AI 에이전트 런타임과 RL 워크로드를 위한 격리된 상태 저장 단일 Pod 샌드박스를 관리하는 Kubernetes 컨트롤러 및 CRD입니다. agent-sandbox는 안정적인 호스트 이름과 네트워크 ID, 선택적 영구 스토리지를 갖춘 장기 실행 단일 컨테이너 워크로드를 실행하기 위해 Kubernetes에 Sandbox 커스텀 리소스와 컨트롤러를 추가합니다. 상태 비저장 방식으로 복제되는 Deployment와 번호가 지정된 Pod 집합을 관리하는 StatefulSet 사이의 공백을 메웁니다. 이 프로젝트는 SIG Apps에서 개발합니다.
agent-sandbox은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
agent-sandbox은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
agent-sandbox은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. agent-sandbox의 마지막 커밋은 2026년 11월 5일입니다.
agent-sandbox은(는) 어디에 사용할 수 있나요?
AI 에이전트를 위해 LLM이 생성한 코드나 신뢰할 수 없는 코드를 격리된 환경에서 실행합니다. 강화 학습 및 평가 루프에 빠르게 시작할 수 있는 샌드박스를 제공합니다. 영구적인 클라우드 개발 환경이나 Jupyter 스타일 세션을 호스팅합니다. StatefulSet의 오버헤드 없이 안정적인 ID가 필요한 단일 인스턴스 서비스를 실행합니다.
agent-sandbox는 어떻게 설치하나요?
kubectl로 코어와 확장 기능을 설치합니다(최신 릴리스): kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml Sandbox CRD가 설치되어 있는지 확인합니다: kubectl get crd sandboxes.agents.x-k8s.io 컨테이너 이미지를 지정한 Sandbox 매니페스트를 적용합니다
agent-sandbox은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/kubernetes-sigs/agent-sandbox

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트