Kubernetes 기반 AI 에이전트 실행 환경 Agent Substrate 공개

개요 및 아키텍처

Agent Substrate는 AI 에이전트를 격리된 Kubernetes 환경에서 실행하기 위한 초기 단계의 Apache-2.0 라이선스 프로젝트입니다. 제어 평면, 노드 슈퍼바이저, 네트워킹 스택을 통해 에이전트 라이프사이클을 관리하여 유휴 자원 소비를 줄이는 것을 목표로 합니다. 이 시스템은 gVisor (ateworker-gvisor)와 micro-VM (ateworker-microvm) 기반 샌드박싱을 모두 지원하며, 임의 코드 실행 시 보안을 유지하고 서스펜드/재개 주기 동안 상태를 보존합니다.

주요 기능 및 데모

프로젝트는 다음 데모를 통해 핵심 기능을 시연합니다:

• 상태 보존: 카운터 데모는 서스펜드 중 상태 지속성과 Substrate 라우터를 통한 온디맨드 재개를 보여줍니다.
• 보안 샌드박싱: Alpine Linux 기반 환경은 세션 간 파일시스템 상태를 보존하면서 임의의 셸 실행을 허용합니다.
• 자원 멀티플렉싱: 데모는 제한된 워커 풀에 여러 Claude Code 에이전트를 멀티플렉싱하여 물리적 하드웨어를 효과적으로 오버서브스크라이브합니다.
• 요청 대기: 라우터는 워커가 사용 불가능할 때 인바운드 요청을 대기시켜 오버서브스크라이브된 풀에서 503 오류를 방지합니다.
• 자동 확장: 워커 풀은 Prometheus-adapter와 HPA를 사용하여 할당된 워커 수에 따라 확장됩니다.

배포 및 요구 사항

로컬 개발에는 Go, kubectl, docker가 필요하며 kind는 자동으로 관리됩니다. Linux 호스트에서 1000개 이상의 샌드박스를 실행하려면 커널 이웃 테이블 설정(net.ipv4.neigh.default.gc_thresh1/2/3를 4096/16384/32768로 조정)이 필요합니다. GKE 배포는 인프라(GKE 클러스터, GCS, IAM)를 부트스트래핑하고 시스템 및 데모 설치를 위한 특정 스크립트를 사용합니다. 기본 자격 증명 제공자는 기본 거부 네임스페이스 정책이 적용된 Kubernetes 서비스 계정을 사용하며, 액터가 자격 증명을 주입하려면 명시적인 권한이 필요합니다.