/aegisops-ai — 자율 거버넌스 오케스트레이터
AegisOps-AI는 SDLC에 고급 AI 추론을 직접 통합하는 전문가급 "리빙 파이프라인"입니다. 시스템 수준 보안, 클라우드 인프라 비용 및 Kubernetes 규정 준수를 위한 지능형 게이트키퍼 역할을 합니다.
목표
고위험 보안 및 재무 감사를 자동화하여 다음을 수행합니다.
- Linux 커널 패치에서 논리 기반 취약점(UAF, Stale State) 식별
- Terraform 계획에서 대규모 "침묵하는 재앙" 비용 변동 탐지
- 자연어 보안 의도를 강화된 K8s 매니페스트로 변환
사용 시기
- 커널 패치 검토: 원시 C 기반 Git diff의 메모리 안전성 감사
- 사전 적용 IaC 감사:
terraform plan출력 분석을 통한 요금 급증 방지 - 클러스터 강화: 배포를 위한 "최소 권한" securityContext 생성
- CI/CD 품질 게이팅: GitHub Actions를 통해 규정 미준수 병합 차단
사용하지 말아야 할 경우
- 웹 앱 로직: 표준 웹 취약점(XSS, SQLi)에는 사용하지 말고, 전용 SAST 스캐너를 사용하세요.
- 비-C 메모리 분석: 패치 분석기는 C 로직에 최적화되어 있습니다. Python 또는 JS와 같은 고급 언어에는 사용하지 마십시오.
- 직접 리소스 변경: 이 도구는 감사자이지 배포 도구가 아닙니다.
terraform apply또는kubectl apply를 실행하지 않습니다. - 사후 분석: 이전 AI 세션이 실패한 이유를 분석하려면
/analyze-project를 사용하세요.
🤖 생성형 AI 통합
AegisOps-AI는 Google GenAI SDK를 활용하여 자율 보안 및 재무 감사를 위한 "추론 경로"를 구현합니다.
- 신경 패치 분석: Linux 커널 패치의 의미론적 코드 검토를 수행하여 단순한 패턴 매칭을 넘어 복잡한 메모리 상태 로직을 이해합니다.
- 지능형 비용 합성: 원시 Terraform plan diff를 재무 추론 모델을 통해 처리하여 고위험 리소스 확장 및 "침묵하는" 재정 변동을 탐지합니다.
- 자연어 정책 매핑: 사람의 보안 의도를 구문적으로 올바르고 강화된 Kubernetes
securityContext구성으로 변환합니다.
🧭 핵심 모듈
1. 🐧 커널 패치 검토자 (patch_analyzer.py)
- 문제: Linux 커널 메모리 안전성 수동 검토는 시간이 많이 소요되고 사람의 오류가 발생하기 쉽습니다.
- 해결책: Gemini 3가 원시 Git diff에 대한 "심층 추론" 감사를 수행하여 몇 초 만에 중요한 메모리 손상 취약점(UAF, Stale State)을 탐지합니다.
- 주요 출력:
analysis_results.json
2. 💰 FinOps 및 클라우드 감사자 (cost_auditor.py)
- 문제: Infrastructure-as-Code(IaC) 변경으로 인해 의도치 않은 "침묵하는 재앙"과 막대한 클라우드 요금 급증이 발생할 수 있습니다.
- 해결책:
terraform plan출력을 분석하여t3.micro에서 고성능 GPU 인스턴스로의 우발적 업그레이드와 같은 비용 이상 징후를 식별합니다. - 주요 출력:
infrastructure_audit_report.json
3. ☸️ K8s 정책 강화 도구 (k8s_policy_generator.py)
- 문제: Kubernetes에서 "최소 권한" 보안 컨텍스트를 구현하는 것은 복잡하고 종종 간과됩니다.
- 해결책: 자연어 보안 요구 사항을 프로덕션 준비가 완료된 강화된 YAML 매니페스트(읽기 전용 루트 FS, 비루트 강제 적용 등)로 변환합니다.
- 주요 출력:
hardened_deployment.yaml
🛠️ 설정 및 환경
1. 저장소 복제
git clone https://github.com/Champbreed/AegisOps-AI.git
cd AegisOps-AI
2. 설정
python3 -m venv venv
source venv/bin/activate
pip install google-genai python-dotenv
3. API 구성
자격 증명을 안전하게 저장하려면 루트 디렉토리에 .env 파일을 생성하세요.
echo "GEMINI_API_KEY='your_api_key_here'" > .env
🏁 운영 대시보드
모든 에이전트를 순차적으로 실행하고 모든 보안 보고서를 생성하려면:
python3 main.py
패턴: 과도한 권한을 가진 컨테이너
- 지표:
allowPrivilegeEscalation: true또는 루트 사용자 실행 - 조사: 보안 의도(예: "non-root only")를 K8s 강화 모듈에 전달
💡 모범 사례
- 컨텍스트가 중요: 더 정확한 신경 추론을 위해 Git diff 주변에 최소 5줄의 컨텍스트를 제공하세요.
- 지속적인 게이팅: 인프라 변경 전에, 변경 후가 아닌, 항상 FinOps 감사자를 실행하세요.
- 수동 승인: AI 결과를 고충실도 신호로 사용하되, 커널 수준 병합에는 사람이 관여하도록 유지하세요.
🔒 보안 및 안전 참고 사항
- 키 관리: 프로덕션에서는 CI/CD 시크릿을
GEMINI_API_KEY에 사용하세요. - 최소 권한: 기능 회귀가 없는지 확인하기 위해 스테이징에서 먼저 "강화된" 매니페스트를 테스트하세요.
링크
제한 사항
- 이 스킬은 태스크가 위에 설명된 범위와 명확히 일치하는 경우에만 사용하세요.
- 출력을 환경별 검증, 테스트 또는 전문가 검토를 대체하는 것으로 취급하지 마십시오.
- 필요한 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 중단하고 명확히 하세요.