MinIO 알아보기

Intro

요즘 애플리케이션에서 이미지, 영상, 로그, 모델 데이터 등 대용량 파일 저장이 필요한 경우가 많다.

그럴 때 쓰는 것이 바로 객체 스토리지다.

 

AWS S3가 가장 잘 알려져 있지만,

프라이빗 클라우드나 온프레미스 환경에서 유연하게 쓰고 싶을 땐?

 

✨ MinIO가 있다.

• S3 API 100% 호환
• 고성능 + 고가용성
• 오픈소스 기반
• 클라우드 / 로컬 어디서든 배포 가능

 

이번 포스팅에서는 Windows 환경 기준으로 MinIO를 설치하고, 구조를 이해하는 과정을 정리한다.

 

 

MinIO 설치 (Windows 환경 기준)

 

⚠️ 참고: Windows에서는 다중 디스크나 다중 노드 구성이 불가능하다.
테스트 또는 개발용으로 사용하는 것이 적합하다. 

 

MinIO Server 설치

Invoke-WebRequest -Uri "https://dl.min.io/server/minio/release/windows-amd64/minio.exe" -OutFile "minio.exe"
.\minio.exe --version

 

MinIO Client 설치

Invoke-WebRequest -Uri "https://dl.min.io/client/mc/release/windows-amd64/mc.exe" -OutFile "mc.exe"
.\mc.exe --version

 

서버 등록

.\mc.exe alias set myminio http://192.168.0.129:9000 minioadmin minioadmin

• myminio: 사용자가 지정한 별칭
• 접속 및 주소 기본 계정: minioadmin / minioadmin

 

 

MinIO 실행 및 웹 콘솔 접속

 

서버 실행

.\minio.exe server D:/minio --console-address ":9001"

• D:/minio: MinIO 데이터 저장 디렉토리
• :9001: 웹 콘솔 주소 (기본은 9001 포트)

 

웹 콘솔 접속

브라우저에서 http://192.168.0.129:9001/login 으로 접속하면 관리자 콘솔에 로그인할 수 있다.

 

 

객체와 버킷, 그리고 저장 구조

 

객체란?

• 이미지, PDF, 동영상, 오디로, 로그, 코드 등 모든 바이너리 데이터
• 크기 제한 없음 (수 바이트 ~ 수 TB까지)
• 흔히 "BLOB(Binary Large Object)"로도 불림

 

버킷이란?

• 객체를 담는 최상위 컨테이너
• S3 및 MinIO는 모든 객체를 버킷 단위로 분리함

 

객체 경로 예시

/images/2020-01-02-logo.png
/videos/2020-01-04-interview.mp4
/articles/user123/intro.md

• 슬래시(/)로 구분하지만, 실제로는 모든 객체가 flat 구조로 저장된다.
• 슬래시는 "가상 디렉토리"처럼 동작할 뿐이다.
• 중간 prefix는 따로 생성하지 않아도 자동으로 인식된다.

 

 

저장소 설계와 주의사항

 

디스크 독점 사용

MinIO가 사용하는 디스크나 디렉토리는 전용으로 할당해야 한다.

 

다른 사용자나 프로세스가 해당 디렉토리 내부 파일을 건드리면:

• 메타데이터 손실
• 데이터 유실
• 운영 장애 발생 가능성 있음

 

→ 절대 직접 파일을 복사, 이동, 삭제하지 말 것.

 

네이밍 규칙

• 객체 이름에는 \, : 같은 특수문자 불가
• /를 통해 prefix 구조 형성 가능
• 버킷 이름은 도메인처럼 소문자, 숫자, 하이폰(-)만 사용

 

 

마무리

이번 글에서는 MinIO의 기본 개념과 설치, 구조를 살펴봤다.

 

MinIO, 생각보다 쓸만하다.

특히 사내에 S3처럼 쓸 수 있는 저장소가 필요하다면?

테스트부터 시작해보자.

 

 

참고 자료:

MinIO Official Web Site - MinIO Object Storage for Windows

MinIO Object Storage for Windows — MinIO Object Storage for Windows