[MinIO] mc alias set 명령어 알아보기 ( MinIO Client )

- 목차

 

들어가며.

mc alias set 명령은 MinIO Client(mc) 에서 스토리지 서버를 설정하고 사용할 별칭(alias)을 등록하는 역할을 합니다.

이 명령을 통해 MinIO 나 S3 호환 스토리지와 연결할 수 있으며, 이후 명령에서 설정된 별칭을 사용하여 스토리지 작업을 간편하게 수행할 수 있습니다.

 

왜 alias 를 설정해야할까 ?

그럼 왜 alias 를 설정해야할까요 ?

mc alias set 설정없이 MinIO Client 를 사용할 수 있습니다.

하지만 alias 설정없이 mc 를 사용하게 되면 매 명령마다 AccessKey, SecretKey, EndpointURL 등에 대한 설정을 해주어야 합니다.

 

이는 AWS Config 의 Profile 과 유사합니다.

보통 "~/.aws/config" 파일에 AWS 설정 정보를 추가하고 합니다.

그리고 aws 명령어 사용 시에 적절한 profile 을 설정할 수 있습니다.

 

[default]
aws_access_key_id = DEFAULT_ACCESS_KEY
aws_secret_access_key = DEFAULT_SECRET_KEY
region = us-east-1

[profile production]
aws_access_key_id = PROD_ACCESS_KEY
aws_secret_access_key = PROD_SECRET_KEY
region = us-west-1

 

이처럼 minio 에서도 alias 라는 이름으로 적절한 Config 에 대한 Profile 이 제공됩니다.

 

mc alias set 사용해보기.

 

먼저 MinIO Docker Container 를 실행해보도록 하겠습니다.

실행을 위한 Docker 명령어는 아래와 같습니다.

 

docker run --name minio -d \
-e MINIO_ROOT_USER=ROOTUSER -e MINIO_ROOT_PASSWORD=123456789 \
-p 9010:9000 -p 9001:9001 \
bitnami/minio

 

alias 조회.

생성된 MinIO Docker Container 내부에 "ms alias ls" 명령을 통해서 별칭들을 조회할 수 있습니다.

 

docker exec minio mc alias ls

bash-3.2$ docker exec minio mc alias ls
gcs
  URL       : https://storage.googleapis.com
  AccessKey : YOUR-ACCESS-KEY-HERE
  SecretKey : YOUR-SECRET-KEY-HERE
  API       : S3v2
  Path      : dns
  Src       : /.mc/config.json
local
  URL       : http://localhost:9000
  AccessKey : ROOTUSER
  SecretKey : 123456789
  API       : s3v4
  Path      : auto
  Src       : /.mc/config.json
play
  URL       : https://play.min.io
  AccessKey : Q3AM3UQ867SPQQA43P2F
  SecretKey : zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG
  API       : S3v4
  Path      : auto
  Src       : /.mc/config.json
s3
  URL       : https://s3.amazonaws.com
  AccessKey : YOUR-ACCESS-KEY-HERE
  SecretKey : YOUR-SECRET-KEY-HERE
  API       : S3v4
  Path      : dns
  Src       : /.mc/config.json

 

 

"mc alias ls" 명령어는 /.mc/config.json 파일의 내용을 읽습니다.

그래서 /.mc/config.json 파일 내부의 내용이 수정되면 mc alias ls 의 결과에도 반영됩니다.

 

아래와 같이 config.json 파일의 일부 데이터가 변경되면, 이는 실제 mc alias 에도 즉시 적용됩니다.

 

sed -i '/ROOTUSER/ADMIN/' /.mc/config.json

cat config.json
{
	"version": "10",
	"aliases": {
		"gcs": {
			"url": "https://storage.googleapis.com",
			"accessKey": "YOUR-ACCESS-KEY-HERE",
			"secretKey": "YOUR-SECRET-KEY-HERE",
			"api": "S3v2",
			"path": "dns"
		},
		"local": {
			"url": "http://localhost:9000",
			"accessKey": "ADMIN",
			"secretKey": "123456789",
			"api": "s3v4",
			"path": "auto"
		},
		"play": {
			"url": "https://play.min.io",
			"accessKey": "Q3AM3UQ867SPQQA43P2F",
			"secretKey": "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
			"api": "S3v4",
			"path": "auto"
		},
		"s3": {
			"url": "https://s3.amazonaws.com",
			"accessKey": "YOUR-ACCESS-KEY-HERE",
			"secretKey": "YOUR-SECRET-KEY-HERE",
			"api": "S3v4",
			"path": "dns"
		}
	}

 

 

alias 생성.

아래의 명령어를 통해서 test 라는 이름의 alias 를 생성할 수 있습니다.

 

mc alias set test http://localhost:9000 ROOTUSER 123456789

 

이 또한 mc alias ls 명령어를 통해서 조회 가능합니다.

 

mc alias ls
gcs
  URL       : https://storage.googleapis.com
  AccessKey : YOUR-ACCESS-KEY-HERE
  SecretKey : YOUR-SECRET-KEY-HERE
  API       : S3v2
  Path      : dns
  Src       : /.mc/config.json

local
  URL       : http://localhost:9000
  AccessKey : ROOTUSER
  SecretKey : 123456789
  API       : s3v4
  Path      : auto
  Src       : /.mc/config.json

play
  URL       : https://play.min.io
  AccessKey : Q3AM3UQ867SPQQA43P2F
  SecretKey : zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG
  API       : S3v4
  Path      : auto
  Src       : /.mc/config.json

s3
  URL       : https://s3.amazonaws.com
  AccessKey : YOUR-ACCESS-KEY-HERE
  SecretKey : YOUR-SECRET-KEY-HERE
  API       : S3v4
  Path      : dns
  Src       : /.mc/config.json

test
  URL       : http://localhost:9000
  AccessKey : ROOTUSER
  SecretKey : 123456789
  API       : s3v4
  Path      : auto
  Src       : /.mc/config.json