server-agent

CMDOP Skill — 설치 및 사용을 위해 CMDOP agent 을 사용하십시오:

Bash

# 설치
pip install -e .
cmdop skills install .

Loading code...

유니버설 프로덕션 서버 모니터링, 자가 치유 및 보고 기능을 위한 cmdop 의 스킬입니다.

Docker 컨테이너를 감시하고, 이상치를 감지하고, 안전한 것을 치유하고, 취약점을 검사하고, 구조화된 Markdown 보고서를 작성합니다. — 모든 것은 cmdop agent에 의해 구동됩니다.

Quick Start

Bash

# 설치
pip install -e .
cmdop skills install .

Loading code...

상태 확인

server-agent status

전체 건강 확인 (안전한 문제를 자동으로 치유)

server-agent check

보안 검사

server-agent scan

특정 컨테이너 치유

server-agent heal —container reforms-django

일일 보고

server-agent report —type daily

Text

## Commands

| Command | Description |
|---------|-------------|
| `check` | 전체 건강 확인: 컨테이너, 디스크, Redis. 안전한 문제를 자동으로 치유합니다. |
| `scan` | 보안 검사: trivy CVEs, 열린 포트, 인증 로그 |
| `heal` | 특정 컨테이너에 대한 치유 | 
| `report` | 구조화된 MD 보고서 (일일, 보안) |
| `status` | 빠른 서버 스냅샷 — 파일을 기록하지 않습니다. |

모든 명령어는 `--json` 옵션으로 구조화된 출력을 지원하고, `--dry-run` 옵션으로 동작을 미리보기할 수 있습니다.

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `REPORTS_DIR` | yes | 보고서 디렉토리의 절대 경로 |
| `TELEGRAM_BOT_TOKEN` | no | Telegram 알림을 위한 토큰 |
| `TELEGRAM_CHAT_ID` | no | 대상 채널/채팅 ID |

## Autonomy Model

- **SAFE** (즉시 실행): `docker restart`, `docker system prune`
- **ESCALATE** (Telegram 알림 전송): 이미지 재빌드, 구성 변경, 컨테이너에 >2번 재시작, OOM
- **NEVER**: 데이터베이스 명령, `rm -rf` (외부 `/tmp` 이외)

보호된 컨테이너 (자동 재시작하지 않음): `shared-db-redis`, `traefik`

## Setup on Production Server

```bash
# 1. 설치
pip install server-agent
cmdop skills install server-agent

# 2. 환경 설정
export REPORTS_DIR=/root/server-agent/reports
export TELEGRAM_BOT_TOKEN=<token>
export TELEGRAM_CHAT_ID=<chat_id>

# 3. 확인
server-agent status --json

# 4. 포트 baseline 생성
server-agent scan --baseline
# baseline/ports.json을 검토한 후 reviewed: true로 설정

# 5. cmdop agent 시작
cmdop agent start

# 6. 트리거 등록

# server-agent-check 트리거

# server-agent-scan 트리거

# server-agent-daily 트리거

Loading code...

Two Modes of Operation

Scheduled monitoring (Python CLI)

트리거는 server-agent 바이너리를 직접 호출합니다. LLM이 체크 루프에 참여하지 않으므로 빠르고, 결정적이며, 저렴합니다.

Bash

# 5분마다 트리거에 의해 호출
server-agent check

Loading code...

Interactive investigation (cmdop skill)

사고에 대한 이유를 조사할 때 사용합니다:

Bash

cmdop run server-agent "reforms-django가 재시작하는 것을 조사하고, 고치십시오"

Loading code...

agent는 skill/readme.md를 시스템 프롬프트로 읽고, server-agent CLI를 데이터를 수집하고, 동작을 수행하는 도구로 사용합니다.

Reports Structure

“
$REPORTS_DIR/
index.md
baseline/ports.json
2026-03-14/
10-23-incident-reforms-django.md
14-05-security-scan.md
daily-summary.md

No content available

server-agent

server-agent

Quick Start

상태 확인

전체 건강 확인 (안전한 문제를 자동으로 치유)

보안 검사

특정 컨테이너 치유

일일 보고

Two Modes of Operation

Scheduled monitoring (Python CLI)

Interactive investigation (cmdop skill)

Reports Structure

리뷰