ReturnZero STT 오프라인 설치 및 Kubespray 자동화 프로세스

Source

  • Field Notes/ReturnZero/Daily Notes/Day 1136. 2024-08-09.md

Summary

이 노트는 ReturnZero(STT) 솔루션의 오프라인 환경 설치를 위한 상세한 단계별 가이드와 자동화 스크립트 초안이다. Kubespray를 활용한 Kubernetes 클러스터 구축, GPU 드라이버 및 Istio 설치, 라이선스 서버 설정, 그리고 STT 엔진 배포까지의 전체 파이프라인을 다룬다. 특히 offline.yml 수정 없이 hosts.yaml을 통해 변수를 관리하도록 Kubespray를 개선하려는 의도와, 라이선스 키 생성 및 적용을 자동화하는 Bash 스크립트 작성 과정이 핵심이다. PII 관련 SDK 버전 문제와 같은 기술적 장애물 해결 시도도 포함되어 있다.

Key Points

  • Kubespray 기반 오프라인 Kubernetes 클러스터 구축 프로세스 정의 (인벤토리 설정, Ansible 플레이북 실행, Helm 차트 적용)
  • 설치 과정의 표준화: containerd/registry 준비 -> Ansible 환경 설정 -> Kubespray 적용 -> GPU/Istio/License Server/STT 순차적 설치
  • Kubespray 개선 방향: offline.yml 직접 수정 대신 hosts.yamlall.vars를 활용하여 설정을 분리하고 재사용성 확보
  • 라이선스 관리 자동화: license-gen 명령어 실행 후 생성된 키를 config.yaml 및 Helm values 파일에 자동으로 주입하는 Bash 스크립트 개발
  • 기술적 이슈: research_bmt SDK의 구버전 Protobuf로 인한 PII 처리 불가 문제 확인 및 SDK 업그레이드 필요성 제기
  • 검증 단계: online-bmt 테스트 컨테이너를 통한 STT 서비스 연결성 및 기능 검증 절차 포함