Stakpak

Stakpak이란?

Stakpak은 로컬 머신에서 실행되어 앱을 24/7 유지하는 오픈소스 에이전트입니다. 운영 "autopilot" 작업을 스케줄링하고 수행하며, 입력이 필요할 때만 사람에게 알립니다.

호스팅 PaaS처럼 작동하지 않고, Stakpak은 시스템 서비스로 로컬에 설치되어 재부팅 시에도 지속됩니다. 관리형 플랫폼에서 기대하는 운영 자동화를 일부 제공하면서 에이전트와 데이터를 사용자의 환경 내에 유지합니다.

주요 기능

단일 바이너리, 로컬 실행: 제품은 "3개 명령으로 전체 제품"으로 설명되며, Autopilot은 머신에 설치된 단일 장기 실행 프로세스입니다.
스케줄링과 로컬 API를 갖춘 자율 에이전트: Autopilot은 스케줄링, 메시징, 로컬 API를 결합해 백그라운드에서 지속 작업을 실행합니다.
대화형 터미널 워크플로(TUI): 사용자는 명령줄에서 제어를 위해 대화형 터미널 인터페이스를 통해 Stakpak을 "운전"합니다.
앱 헬스 및 운영 자동화: 예시 흐름은 헬스 체크가 문제를 감지(e.g., API 지연 스파이크)하고, 메트릭/연결로 조사하며, 복구(재시작)를 적용하고 결과를 보고합니다.
정책 강제 프록시를 통한 네트워크 샌드박스: 에이전트의 모든 네트워크 요청(e.g., curl, Python, MCP 서버)은 Cedar 정책으로 제한된 투명 프록시를 통해 라우팅됩니다.
모델 액세스 전 비밀 치환: 에이전트는 210+ 비밀 유형을 감지하고 플레이스홀더로 교체하여 실제 값은 실행 시에만 복원합니다.
완전한 세션 감사 로그 및 백업: 모든 작업에 전체 컨텍스트가 감사 로그에 포함되며, 변경 사항은 로컬 및 SSH로 백업되고 세션 재생 및 롤백을 지원합니다.
Rust(Apache 2.0) 작성, 로컬 암호화: Stakpak은 Apache 2.0 오픈소스이며, 제공된 설명에 따라 mTLS 암호화로 머신에서 완전히 실행됩니다.

Stakpak 사용 방법

설치 제공된 설치 명령 실행:

curl -sSL https://stakpak.dev/install.sh | sh

스택 초기화:
```
stakpak init
```
스택을 발견하고 APPS.md 파일을 생성합니다.
Autopilot 시작:
```
stakpak up
```
Autopilot은 백그라운드에서 24/7 실행됩니다.
필요 시 상태 확인:
```
stakpak autopilot status
```
TUI를 사용해 스케줄, 채널, 최근 활동을 모니터링합니다.

사용 사례

인시던트 대응 및 자동 복구: 앱 헬스 체크 실패 시(e.g., API 지연 p99 임계값 초과), 에이전트는 메트릭과 DB 연결을 조사하고, 영향을 받은 서비스/인스턴스를 재시작하며 구성된 채널에 요약 보고합니다.
자동 비용 감시 보고: Stakpak은 유휴 인프라 자원(예: 유휴 RDS 인스턴스, 고아 EBS 볼륨)을 매일 스캔하고 절감 보고서를 생성합니다.
운영 "타임밤" 해소: 에이전트는 만료 TLS 인증서를 추적하고 제로 다운타임으로 자동 갱신하며, 만료 비밀, deprecated API, EOL 런타임을 처리합니다.
에스컬레이션 있는 지속 운영 모니터링: 사람 결정이 필요한 작업에 대해 Stakpak은 "필요할 때만 사람에게 핑"하도록 설계되어 노이즈를 줄이고 개입이 필요할 때 알려줍니다.
감사된 변경 및 롤백: Stakpak이 유지보수 중 파일 편집이나 명령 실행 시 전체 컨텍스트로 작업을 로그하고, 변경을 로컬 및 SSH로 백업하며 세션 재생과 롤백을 지원합니다.

자주 묻는 질문

Stakpak은 호스팅 서비스인가요?

아니요. 제품은 시스템 서비스로 사용자의 머신에서 실행되며 재부팅 시에도 지속되고, 데이터를 환경 내에 유지하도록 설계된 보호를 포함합니다.

"autopilot"은 무엇을 하나요?

Autopilot은 스케줄링, 메시징, 로컬 API를 결합한 단일 장기 실행 프로세스로, 앱을 유지하고 백그라운드에서 운영 작업을 실행합니다.

Stakpak은 비밀을 어떻게 처리하나요?

에이전트는 비밀 치환을 수행합니다: 비밀 유형을 감지하고 모델 상호작용 전에 플레이스홀더로 교체하며, 실행 시에만 실제 값을 복원합니다.

Stakpak은 감사 로그를 제공하나요?

네. 전체 세션 감사 로그를 컨텍스트와 함께 기록하고, 변경을 로컬 및 SSH로 백업하며 세션 재생과 변경 롤백을 지원합니다.

네트워크 액세스에 어떤 보호가 적용되나요?

에이전트의 네트워크 요청은 Cedar 정책이 적용된 투명 프록시를 거치며, 제공된 설명에 따라 이 정책 집행 하에 샌드박싱됩니다.

대안

호스팅 PaaS / 관리형 배포 플랫폼: 이러한 플랫폼은 일반적으로 가동 시간, 헬스 체크, 운영 자동화를 서비스로 처리하지만, 로컬 에이전트에 비해 제공자의 호스팅 환경에 더 많은 신뢰가 필요할 수 있습니다.
셀프 호스팅 오케스트레이션 + 모니터링 스택: 스케줄링과 관찰성(예: 헬스 체크 및 인시던트 자동화)에 초점을 맞춘 도구는 인프라에서 실행될 수 있지만, 여기 설명된 로컬 에이전트 제어, 시크릿 치환, 감사 로깅의 조합을 포함하지 않을 수 있습니다.
운영 작업을 위한 범용 자동화/CI 에이전트: 스크립트와 배포를 자동화하는 시스템은 "계속 실행" 워크플로의 일부를 처리할 수 있지만, 동일한 정책 기반 네트워크 샌드박싱과 시크릿 플레이스홀더 워크플로를 포함하지 않을 수 있습니다.
로컬에서 실행되는 기타 오픈소스 “에이전트”: 머신에서 작동하는 에이전트 모델을 찾는다면 로컬 우선 에이전트 런타임을 고려하세요—Stakpak과 유사한 정책 제어 네트워킹, 시크릿 치환, 전체 감사/리플레이 기능을 제공하는지 확인하세요.