Onyx v4 operator lesson 02 · standalone operator lesson

Standard 운영 배포

RAG, Connectors, background worker, object storage 등 운영 기능을 전제로 구성 파일과 기동 증거를 분리해 확인합니다.

이 lesson의 목적

RAG, Connectors, background worker, object storage 등 운영 기능을 전제로 구성 파일과 기동 증거를 분리해 확인합니다.

주 대상: 운영 담당자, 사내 지식검색 도입자, Docker Compose 기반 self-host 준비자

Docker Compose 환경과 충분한 리소스가 준비되어 있어야 합니다.
`env.prod.template` → `.env`, 필요 시 `env.nginx.template` → `.env.nginx` 복사 여부를 확인합니다.
인증 방식, 도메인, SSL, Web Search/Observability 키 같은 운영값의 소유자를 정합니다.

RAG/커넥터/권한 검색이 필요한 이유를 기록합니다.

주의: Standard를 선택한 이유가 없으면 Lite와 비교한 운영비 판단이 불가능합니다.

`cd onyx/deployment/docker_compose`, `cp env.prod.template .env`, 필요 시 `cp env.nginx.template .env.nginx`를 수행합니다.

주의: 템플릿 파일을 직접 수정하면 업그레이드 때 변경 비교가 어려워집니다.

`docker compose up -d` 또는 소스 빌드가 필요하면 `docker compose up -d --build --force-recreate`를 사용합니다.

주의: 이 명령은 Standard 계열입니다. Lite override와 섞어 쓰지 않습니다.

웹, API, DB뿐 아니라 background/indexing/cache/object storage 계층이 설계대로 있는지 봅니다.

주의: 웹 화면만 뜨면 RAG 운영 준비가 끝났다고 오해하기 쉽습니다.

컨테이너 Up과 `localhost:3000` 접근 가능 시점을 분리해서 기록합니다.

주의: 초기화 중 에러를 첫 접속 실패로만 보고 넘기지 않습니다.

AUTH_TYPE, WEB_DOMAIN, SSL, LOG_LEVEL, EXA_API_KEY, 관측성 키 등 필요한 항목을 소유자별로 나눕니다.

주의: 모든 옵션을 한 번에 켜는 것이 운영 준비는 아닙니다.

Quickstart install script 재실행 업그레이드 또는 compose 이미지 태그 정책을 운영 문서에 남깁니다.

주의: 업데이트 방법 없이 PoC compose를 장기 운영으로 넘기지 않습니다.

아래 문서는 이 정적 lesson의 작성 근거입니다. 실제 화면 라벨이나 배포 성공은 별도 현장 검증이 필요합니다.

이 페이지는 Standard 배포 준비와 체크 순서입니다. 실제 클라우드/도메인/SSL/SSO 성공 여부는 현장 배포에서 별도 증거가 필요합니다.