Operational Tools Overview¶
DADP 공개 문서에서 운영 도구는 서비스 API와 별도 축으로 다룬다. Hub와 Engine은 장기적으로 의존할 서비스 경계를 제공하고, 운영 도구는 그 경계를 사용해 등록, 수집, 설치, 검증, 동기화를 수행한다.
운영 도구를 분리하는 이유¶
- 도구는 서비스 자체가 아니라 서비스 계약을 소비한다.
- 도구의 실패는 API 설계 문제보다 실행 절차, 입력값, 로컬 환경, 운영 경로 문제와 더 자주 연결된다.
- 운영자는 서비스 경계와 도구 경계를 분리해서 봐야 장애를 빠르게 구분할 수 있다.
공개 운영 도구 집합¶
| 도구 | 역할 | 주된 사용 시점 |
|---|---|---|
| Hub CLI | Hub와 Engine 관련 운영 작업을 수행하는 제어면 클라이언트 | 등록, 조회, 설정 변경, 상태 점검, UDF 설치 |
| Schema Collector | 데이터베이스 스키마를 사전 수집해 Hub에 등록하는 수집 도구 | Wrapper 도입 전 스키마 수집과 정책 매핑 준비 |
| 구성 및 동기화 보조 흐름 | export-config, CLI 기반 동기화, 수동 반영 절차 | 직접 동기화가 어렵거나 에어갭 제약이 있는 환경 |
서비스 API와의 관계¶
- Hub CLI는 Hub API와 일부 Engine 관련 제어 경로를 소비한다.
- Schema Collector는 데이터베이스 메타데이터를 수집한 뒤 Hub 등록 경로를 사용한다.
- 구성 및 동기화 보조 흐름은 Wrapper, Hub, Engine 사이의 운영 상태를 맞추기 위한 절차다.
운영 도구는 플랫폼의 일부이지만, 공개 API 표면과 동일한 계층으로 문서화하면 경계가 흐려진다. 따라서 공개 문서에서는 도구를 별도 섹션으로 유지한다.