agent은(는) 무엇을 하나요?
자동 조종으로 코드를 배포하세요. 여러분의 머신에서 24/7 작동하며 앱을 실행 상태로 유지하는 오픈 소스 에이전트입니다. 🦀
개요
stakpak/agent는 코드 배포와 애플리케이션 유지 관리를 완전 자동화하는 오픈 소스 AI 에이전트입니다. 이 도구는 서버에 설치되어 지속적으로 실행되며, 새로운 코드 변경 사항을 자동으로 감지하고 배포하며, 애플리케이션의 상태를 모니터링하고 문제가 발생하면 자동으로 복구합니다.
주요 기능
- 자동 배포: 코드 저장소의 변경 사항을 감지하고 자동으로 배포 파이프라인을 트리거합니다.
- 24/7 모니터링: 애플리케이션의 헬스 체크를 지속적으로 수행하고 장애를 감지합니다.
- 자동 복구: 장애 발생 시 자동으로 롤백하거나 대체 인스턴스로 트래픽을 전환합니다.
- 롤링 업데이트: 무중단 배포를 위한 롤링 업데이트 전략을 지원합니다.
- 다중 플랫폼 지원: GitHub Actions, GitLab CI, Jenkins 등 주요 CI/CD 플랫폼과 통합됩니다.
설치 방법
curl -fsSL https://get.stakpak.dev | sh
또는 직접 바이너리 다운로드:
# 최신 릴리즈 다운로드
wget https://github.com/stakpak/agent/releases/latest/download/stakpak-agent-linux-amd64.tar.gz
tar -xzf stakpak-agent-linux-amd64.tar.gz
sudo mv stakpak-agent /usr/local/bin/
설정
에이전트는 stakpak.toml 설정 파일을 사용합니다:
[agent]
name = "my-app-agent"
log_level = "info"
[deploy]
strategy = "rolling"
health_check_path = "/health"
health_check_port = 8080
max_retries = 3
retry_delay = 30
[source]
type = "github"
repository = "username/my-app"
branch = "main"
[notifications]
slack_webhook = "https://hooks.slack.com/services/..."
사용 방법
에이전트 시작:
stakpak-agent start
상태 확인:
stakpak-agent status
로그 확인:
stakpak-agent logs -f
환경 변수
| 변수 | 설명 | 기본값 |
|---|---|---|
STAKPAK_CONFIG_PATH | 설정 파일 경로 | ./stakpak.toml |
STAKPAK_LOG_LEVEL | 로그 수준 | info |
STAKPAK_DATA_DIR | 데이터 디렉터리 | ~/.stakpak |
시스템 요구 사항
- 운영 체제: Linux, macOS, Windows (WSL2)
- 런타임: Rust (선택 사항, 미리 빌드된 바이너리 사용 가능)
- 권한: 애플리케이션 포트 접근 권한, Docker (옵션)
기여하기
버그 리포트, 기능 제안, 풀 리퀘스트는 GitHub 저장소에서 환영합니다.
라이선스
MIT 라이선스. 자세한 내용은 LICENSE 파일을 참조하세요.