MinIO - 27. MinIO 클라이언트 빠른 시작 가이드

MinIO Client Quickstart Guide

MinIO 클라이언트 빠른 시작 가이드

MinIO Client (mc) provides a modern alternative to UNIX commands like ls, cat, cp, mirror, diff, find etc.

MinIO 클라이언트 (mc)는 ls, cat, cp, mirror, diff, find 등과 같은 UNIX 명령에 대한 현대적인 대안을 제공합니다.

It supports filesystems and Amazon S3 compatible cloud storage service (AWS Signature v2 and v4).

파일 시스템과 Amazon S3 호환 클라우드 스토리지 서비스 (AWS Signature v2 및 v4)를 지원합니다.

ls list buckets and objects

ls 버킷과 객체를 나열합니다

mb make a bucket

mb 버킷을 만듭니다

rb remove a bucket

rb 버킷을 제거합니다

cat display object contents

cat 객체 내용을 표시합니다

head display first 'n' lines of an object

head 객체의 첫 번째 'n'라인을 표시합니다

pipe stream STDIN to an object

pipe STDIN을 객체로 스트림합니다

share generate URL for temporary access to an object

share 객체에 대한 임시 액세스를 위한 생성 URL 공유합니다

cp copy objects

cp 객체를 복사합니다

mirror synchronize objects to a remote site

mirror 원격 사이트에 객체를 동기화합니다

find search for objects

find 객체를 검색합니다

sql run sql queries on objects

sql 객체에 대해 sql 쿼리를 실행합니다

stat stat contents of objects

stat 객체의 통계 내용입니다

diff list differences in object name, size, and date between buckets

diff 버킷 간 객체 이름, 크기, 날짜의 diff 목록 차이점입니다

rm remove objects

rm 객체를 제거합니다

event manage object notifications

event 객체 알림을 관리합니다

watch watch for object events

watch 객체 이벤트를 감시합니다

policy manage anonymous access to objects

policy 객체에 대한 익명 액세스를 관리합니다

admin manage MinIO servers

admin MinIO 서버를 관리합니다

session manage saved sessions for cp command

session cp 명령에 대해 저장된 세션을 관리합니다

config manage mc configuration file

config mc 구성 파일을 관리합니다

update check for a new software update

update 새 소프트웨어 업데이트를 확인합니다

version print version info

version 버전 정보를 프린트합니다

Docker Container

도커 컨테이너

Stable

스테이블

docker pull minio/mc
docker run minio/mc ls play

Edge

엣지

docker pull minio/mc:edge
docker run minio/mc:edge ls play

Note: Above examples run mc against MinIO play environment by default. To run mc against other S3 compatible servers, start the container this way:

메모: 위의 예에서는 기본적으로 MinIO 플레이 환경에 대해 mc를 실행합니다. 다른 S3 호환 서버에 대해 mc를 실행하려면 다음과 같이 컨테이너를 시작하십시오.

docker run -it --entrypoint=/bin/sh minio/mc

then use the mc config command.

그런 다음 mc config 명령을 사용하십시오.

macOS

Homebrew

Install mc packages using Homebrew

Homebrew를 사용하여 mc 패키지 설치

brew install minio/stable/mc
mc --help

GNU/Linux

Binary Download

바이너리 다운로드

Platform
Architecture
URL
GNU/Linux
64-bit Intel
https://dl.min.io/client/mc/release/linux-amd64/mc


64-bit PPC
https://dl.min.io/client/mc/release/linux-ppc64le/mc

wget https://dl.min.io/client/mc/release/linux-amd64/mc
chmod +x mc
./mc --help

Microsoft Windows

Binary Download

바이너리 다운로드

Platform
Architecture
URL
Microsoft Windows
64-bit Intel
https://dl.min.io/client/mc/release/windows-amd64/mc.exe

mc.exe --help

Install from Source

소스에서 설치

Source installation is only intended for developers and advanced users. If you do not have a working Golang environment, please follow How to install Golang. Minimum version required is go1.13

소스 설치는 개발자와 고급 사용자만을 위한 것입니다. 작동하는 Golang 환경이 없다면 Golang 설치 방법을 따르세요. 필요한 최소 버전은 go1.13입니다.

GO111MODULE=on go get github.com/minio/mc

Add a Cloud Storage Service

클라우드 스토리지 서비스 추가

If you are planning to use mc only on POSIX compatible filesystems, you may skip this step and proceed to everyday use.

POSIX 호환 파일 시스템에서만 mc를 사용하려는 경우 이 단계를 건너뛰고 일상적인 사용으로 진행할 수 있습니다.

To add one or more Amazon S3 compatible hosts, please follow the instructions below. mc stores all its configuration information in ~/.mc/config.json file.

하나 이상의 아마존 S3 호환 호스트를 추가하려면 아래 지침을 따르십시오. mc는 모든 구성 정보를 ~/.mc/config.json 파일에 저장합니다.

mc config host add --api --lookup

Alias is simply a short name to your cloud storage service. S3 end-point, access and secret keys are supplied by your cloud storage provider. API signature is an optional argument. By default, it is set to "S3v4".

별칭은 단순히 클라우드 스토리지 서비스의 짧은 이름입니다. S3 엔드포인트, 액세스 및 비밀 키는 클라우드 스토리지 공급자가 제공합니다. API 서명은 선택적 인수입니다. 기본적으로 "S3v4"로 설정되어 있습니다.

Lookup is an optional argument. It is used to indicate whether dns or path style url requests are supported by the server. It accepts "dns", "path" or "auto" as valid values. By default, it is set to "auto" and SDK automatically determines the type of url lookup to use.

조회는 선택적 인수입니다. 서버에서 DNS 또는 경로 스타일 URL 요청을 지원하는지 여부를 나타내는데 사용됩니다. "dns", "path" 또는 "auto"를 유효한 값으로 허용합니다. 기본적으로는 "auto"로 설정되어 있으며 SDK는 사용할 URL 조회 유형을 자동으로 결정합니다.

Example - MinIO Cloud Storage

예 - MinIO 클라우드 스토리지

MinIO server displays URL, access and secret keys.

MinIO 서버는 URL, 액세스 및 비밀 키를 표시합니다.

mc config host add minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12

Example - Amazon S3 Cloud Storage

예 - 아마존 S3 클라우드 스토리지

Get your AccessKeyID and SecretAccessKey by following AWS Credentials Guide.

AWS 자격 증명 가이드에 따라 AccessKeyID 및 SecretAccessKey를 받으세요.

mc config host add s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12

Note: As an IAM user on Amazon S3 you need to make sure the user has full access to the buckets or set the following restricted policy for your IAM user.

메모: 아마존 S3의 IAM 사용자는 사용자가 버킷에 대한 전체 액세스 권한을 갖고 있는지 확인하거나 IAM 사용자에 대해 다음과 같은 제한된 정책을 설정해야 합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowBucketStat",
            "Effect": "Allow",
            "Action": [
                "s3:HeadBucket"
            ],
            "Resource": "*"
        },
        {
            "Sid": "AllowThisBucketOnly",
            "Effect": "Allow",
            "Action": "s3:*",
            "Resource": [
                "arn:aws:s3:::/*",
                "arn:aws:s3:::"
            ]
        }
    ]
}

Example - Google Cloud Storage

예 - Google 클라우드 스토리지

Get your AccessKeyID and SecretAccessKey by following Google Credentials Guide

구글 자격 증명 가이드에 따라 AccessKeyID 및 SecretAccessKey를 받으세요.

mc config host add gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12

Test Your Setup

설정을 테스트

mc is pre-configured with https://play.min.io, aliased as "play". It is a hosted MinIO server for testing and development purpose. To test Amazon S3, simply replace "play" with "s3" or the alias you used at the time of setup.

mc는 https://play.min.io로 사전 구성되어 있으며 별칭은 "play"입니다. 테스트 및 개발 목적으로 호스팅되는 MinIO 서버입니다. Amazon S3를 테스트하려면 "play"를 "s3" 또는 설정 시 사용한 별칭으로 바꾸면 됩니다.

Example:

예:

List all buckets from https://play.min.io

https://play.min.io의 모든 버킷을 나열합니다

mc ls play
[2016-03-22 19:47:48 PDT]     0B my-bucketname/
[2016-03-22 22:01:07 PDT]     0B mytestbucket/
[2016-03-22 20:04:39 PDT]     0B mybucketname/
[2016-01-28 17:23:11 PST]     0B newbucket/
[2016-03-20 09:08:36 PDT]     0B s3git-test/

Make a bucket

버킷을 만듭니다

mb command creates a new bucket.

mb 명령은 새 버킷을 생성합니다.

Example:

예

mc mb play/mybucket

Bucket created successfully `play/mybucket`.

버킷이 'play/mybucket'을 성공적으로 생성했습니다.

Copy Objects

객체 복사

cp command copies data from one or more sources to a target.

cp 명령은 하나 이상의 소스에서 대상으로 데이터를 복사합니다.

Example:

예

mc cp myobject.txt play/mybucket
myobject.txt:    14 B / 14 B  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓  100.00 % 41 B/s 0

Everyday Use

일상적인 사용

Shell aliases

쉘 별칭

You may add shell aliases to override your common Unix tools.

일반적인 Unix 도구를 재정의하기 위해 쉘 별칭을 추가할 수 있습니다.

alias ls='mc ls'
alias cp='mc cp'
alias cat='mc cat'
alias mkdir='mc mb'
alias pipe='mc pipe'
alias find='mc find'

Shell autocompletion

쉘 자동 완성

In case you are using bash, zsh or fish. Shell completion is embedded by default in mc, to install auto-completion use mc --autocompletion. Restart the shell, mc will auto-complete commands as shown below.

bash, zsh 또는 fish를 사용하는 경우, 쉘 완성은 기본적으로 mc에 포함되어 있습니다. 자동 완성을 설치하려면 mc --autocompletion을 사용하세요. 쉘을 다시 시작하면 mc는 아래와 같이 명령을 자동 완성합니다.

mc 
admin    config   diff     find     ls       mirror   policy   session  sql      update   watch
cat      cp       event    head     mb       pipe     rm       share    stat     version

Explore Further

더 자세히 살펴보세요

MinIO Client Complete Guide

MinIO 클라이언트 전체 가이드

MinIO Quickstart Guide

MinIO 빠른 시작 가이드

The MinIO documentation website

MinIO 문서 웹사이트

Contribute to MinIO Project

MinIO 프로젝트에 기여

Please follow MinIO Contributor's Guide

MinIO 기여자 가이드를 따르세요

License

특허