보안과 설치

고객사 사내망 안에 설치합니다

AEGIS(Autonomous Engine for Governed Integration Services — 통제된 통합 서비스를 위한 자율 실행 엔진)는 두 계층으로 되어 있습니다.

• 결정 계층(필수) — 웹 화면, 권한, 빌드 상태, 감사 기록, 중복 방지를 모두 책임지는 웹 애플리케이션과 데이터베이스입니다. 중요한 보장은 모두 이 계층이 합니다.
• 자동화 계층(선택 설치) — 로그 분석, 알림, 빌드 도구 작업 요청 등을 거드는 AI(Artificial Intelligence, 인공지능) 에이전트(스스로 일을 처리하는 AI 프로그램) 5종입니다. 공개 소프트웨어 Hermes Agent 위에서 동작합니다. 에이전트는 결정 계층을 부르는 보조 역할이라 모두 멈춰도 스케줄 빌드, 승인, 권한, 감사 기록은 그대로 동작합니다. 설치 직후에는 로그 분석 에이전트만 자동으로 동작하고, 나머지는 운영자가 켤 때까지 수동 단계로 시작합니다.

데이터가 가는 곳

• 사내 AI 모델(OpenAI 호환 API — 널리 쓰이는 AI 요청 형식) — 사내에서 처리됩니다. 원격 모델을 설정하지 않으면 AEGIS가 소스 정보와 빌드 로그를 외부로 보내지 않는 구성이 가능합니다.
• 원격 AI 모델(사내 모델이 실패할 때 넘기는 대체 경로 포함) — 분석 요청에 담긴 로그와 변경 내용이 그 모델로 전송됩니다. 쓰려면 전송 범위와 사전 동의를 계약에 적습니다.
• AI 모델 없음 — 원인 후보 분석만 빠지고 빌드·알림·결정·기록 흐름은 그대로 운영합니다.

설정, 빌드 기록, 감사 기록은 모두 고객사 서버의 데이터베이스에 저장됩니다. 채팅 알림(Telegram·Slack)은 외부 서비스이므로 알림 문구가 그 서비스로 전달됩니다. 채팅 알림은 선택 사항이며, 사내 정책에 맞춰 쓸지를 정합니다.

설치와 운영

• 서버 — Linux(서버용 운영체제) x86 64비트(amd64 — 일반 인텔·AMD 계열 서버) 1대, Docker(프로그램을 격리된 상자 단위로 실행하는 도구). 서버에 Ruby·Rails 같은 개발 도구를 따로 설치할 필요는 없습니다.
• 네트워크·인증서 — 사용자 접속용 HTTPS(암호화된 웹 통신, 443 포트)와 사내 인증서(TLS — 통신 암호화 인증서, 사설 인증기관 가능), Gerrit·Jenkins·LDAP(Lightweight Directory Access Protocol, 사내 계정 조회 표준)·메일 서버까지의 사내 통신
• 인터넷이 없는 환경 — 필요한 프로그램을 모두 묶은 이미지 포함 배포본을 파일로 받아 인터넷 없이 설치합니다. 받은 파일은 체크섬(파일이 손상·변조되지 않았는지 확인하는 값)으로 검증합니다.
• 설치 절차 — 배포본 검증·풀기 → 코어 설치 → 운영 설정 파일(계정·서버 주소 등) 작성 → 재실행 → 점검 스크립트 → (선택) 자동화 계층 설치 → 첫 빌드와 첫 경보 메일 수신 확인
• 업그레이드 — 새 버전으로 올릴 때 먼저 백업하고 적용합니다. 문제가 있으면 직전 버전으로 한 단계 되돌릴 수 있고, 기록은 보존됩니다.
• 백업·복원 — 백업·복원 스크립트가 들어 있습니다. 백업 주기와 보존 기간은 고객이 정해 걸어 둡니다(자동 백업 일정은 기본 제공하지 않음).
• AEGIS가 멈추면 — 고객의 Jenkins·Gerrit은 그대로 동작합니다. 장애 때는 기존 수작업 방식으로 돌아가는 절차를 운영 문서에 둡니다.