Skip to main content

Docker Container

Docker Compose를 사용하여 각종 서비스를 설치하고 실행하는 가이드입니다.

Docker란?

Docker는 애플리케이션을 컨테이너라는 독립된 환경에서 실행할 수 있게 해주는 도구입니다. 일반적으로 PostgreSQL, Redis 같은 서비스를 설치하려면 OS에 직접 설치하고 설정 파일을 수정해야 합니다. Docker를 사용하면 이런 과정 없이 명령어 한 줄로 서비스를 실행할 수 있습니다.

컨테이너 (Container)

컨테이너는 애플리케이션과 실행에 필요한 모든 것(라이브러리, 설정 파일 등)을 하나로 묶은 실행 단위입니다.
  • 호스트 OS와 격리되어 실행되므로 서로 영향을 주지 않습니다
  • 같은 서비스를 여러 개 동시에 실행할 수 있습니다
  • 삭제하고 다시 만들어도 동일한 환경이 보장됩니다

Docker Compose

여러 컨테이너를 한 번에 정의하고 실행할 수 있는 도구입니다. docker-compose.yml 파일에 서비스 구성을 작성하고, docker compose up -d 명령어로 한 번에 실행합니다. 예를 들어, Langfuse를 실행하려면 Langfuse 서버, PostgreSQL, Redis, ClickHouse 등 여러 서비스가 함께 필요합니다. Docker Compose를 사용하면 이 모든 서비스를 하나의 파일로 관리하고 한 번에 실행할 수 있습니다.

사전 준비

Docker Container를 실행하려면 Docker가 설치되어 있어야 합니다.
Windows 환경에서는 Rancher Desktop을 설치하면 Docker와 Docker Compose가 함께 설치됩니다.
Docker가 정상적으로 설치되었는지 확인합니다.
docker --version
docker compose version

사용 방법

각 서비스 페이지에 있는 docker-compose.yml 파일을 복사하여 원하는 디렉토리에 저장한 뒤, 아래 명령어로 실행합니다.
# 컨테이너 실행 (백그라운드)
docker compose up -d

# 실행 상태 확인
docker compose ps

# 로그 확인
docker compose logs -f

# 컨테이너 중지
docker compose down
docker compose down은 컨테이너만 삭제합니다. 데이터는 Docker 볼륨에 저장되어 유지됩니다. 데이터까지 삭제하려면 docker compose down -v 옵션을 사용하세요.

서비스 목록

데이터베이스 / 검색엔진

LLM 서빙 / 추론

AI / 워크플로우 플랫폼

실험 관리 / MLOps

데이터 라벨링

모델 서빙 / 배포