Server Installation

서버 측 공개 설치 문서는 Hub와 Engine을 대상으로 한다. 이 단계의 목적은 제어면과 실행면을 먼저 안정화한 뒤, Wrapper 및 DB UDF 연동 검증을 이어갈 수 있는 상태를 만드는 것이다.

설치 대상

• Hub
• Engine

권장 순서

1. Hub 설치
2. Hub 기본 기동 및 운영 진입 확인
3. Engine 설치
4. Hub에서 Engine 등록과 runtime identity 설정
5. Engine health, cache status, round trip 확인

Hub 설치 체크리스트

1. 배포 산출물 준비

• Go binary 또는 컨테이너 이미지 준비
• Hub 설정 또는 환경변수 준비
• Metadata DB와 secret store 보존 경로 준비

2. 기본 기동 확인

Hub는 기본적으로 9004 포트와 /hub context path를 사용한다.

curl http://localhost:9004/hub/actuator/health

3. 운영 진입 확인

• Hub UI 진입이 가능한지 확인
• 제어면 API가 응답하는지 확인
• 정책/키/연동 조회 화면이 정상인지 확인

Engine 설치 체크리스트

• Go binary 또는 컨테이너 이미지 준비
• Engine 기본 포트 9003 접근 경로 확인
• Hub에서 Engine 등록 후 발급되는 tenantId 관리
• /engine/api/health 확인
• Hub에서 cache sync와 runtime heartbeat 확인

설치 완료 기준

• Hub 프로세스 또는 컨테이너가 정상 기동한다.
• GET /hub/actuator/health가 정상 응답한다.
• 운영자 진입 경로가 열린다.
• Engine 프로세스 또는 컨테이너가 정상 기동한다.
• GET /engine/api/health가 정상 응답한다.
• Hub에서 Engine runtime identity와 cache 상태를 확인할 수 있다.