Docker Compose 파일로 MinIO을 도커에 구성한 내용을 정리 합니다.
개요
MinIO는 고성능 오브젝트 스토리지 시스템으로, 클라우드 네이티브 애플리케이션을 위해 설계되었습니다.
특히 S3 호환 API를 제공하여 AWS S3와의 상호 운용성이 뛰어납니다.
이번 포스트에서는 Docker Compose를 이용하여 MinIO를 쉽게 설정하고 사용하는 방법을 소개합니다.
사전 준비
Docker와 Docker Compose 설치
MinIO를 설정하기 위해서는 Docker와 Docker Compose가 필요합니다.
기본 설정 파일 생성
Docker Compose를 사용하여 MinIO를 설정하기 위해, 먼저 docker-compose.yml
파일을 생성합니다. 이 파일은 MinIO 서버의 설정을 정의하는 역할을 합니다.
Docker Compose 설정
아래는 기본적인 docker-compose.yml
파일의 예시입니다.
version: '3.7'
services:
minio:
image: minio/minio:latest
container_name: minio
ports:
- "9000:9000"
- "9001:9001" # MinIO 콘솔 접근을 위한 포트
volumes:
- minio-data:/data
environment:
MINIO_ROOT_USER: minioadmin
MINIO_ROOT_PASSWORD: minioadmin
command: server /data --console-address ":9001"
volumes:
minio-data:
설정 파일 설명
image
: 사용할 MinIO Docker 이미지를 지정합니다.container_name
: 컨테이너 이름을 지정합니다.ports
: 호스트와 컨테이너 간의 포트를 매핑합니다.9000
: MinIO 서버 접근 포트9001
: MinIO 콘솔 접근 포트
volumes
: 데이터를 저장할 볼륨을 지정합니다.environment
: 환경 변수를 설정하여 MinIO의 루트 사용자와 비밀번호를 지정합니다.command
: MinIO 서버를 실행할 명령어와 콘솔 주소를 지정합니다.
Docker Compose를 이용한 MinIO 실행
설정 파일을 작성한 후, 터미널을 열고 해당 파일이 있는 디렉토리로 이동합니다. 다음 명령어를 실행하여 Docker Compose를 시작합니다.
docker-compose up -d
이 명령어는 백그라운드에서 MinIO 컨테이너를 실행합니다. 실행 상태를 확인하려면 다음 명령어를 사용할 수 있습니다.
docker-compose ps
MinIO 웹 콘솔 접속
MinIO가 성공적으로 실행되었다면, 브라우저를 열고 다음 주소로 접속합니다.
- MinIO 서버:
http://localhost:9000
- MinIO 콘솔:
http://localhost:9001

초기 로그인 정보는 docker-compose.yml
파일에서 설정한 MINIO_ROOT_USER
와 MINIO_ROOT_PASSWORD
를 사용하면 됩니다.

결론
이번 포스트에서는 Docker Compose를 이용하여 MinIO를 설정하고 실행하는 방법을 알아보았습니다.
MinIO는 강력한 오브젝트 스토리지 솔루션으로, 손쉽게 설정할 수 있어 개발자와 시스템 관리자 모두에게 유용합니다.
참고 자료
- https://min.io/