mc
RELEASE.2024-11-05T11-29-45Z
MC 문서
MinIO 클라이언트(mc)는 ls, cat, cp, mirror, diff, find 등과 같은 UNIX 명령에 대한 최신 대안을 제공합니다. 이는 파일 시스템과 Amazon S3 호환 클라우드 스토리지 서비스(AWS Signature v2 및 v4)를 지원합니다.
alias manage server credentials in configuration file admin manage MinIO servers anonymous manage anonymous access to buckets and objects batch manage batch jobs cp copy objects cat display object contents diff list differences in object name, size, and date between two buckets du summarize disk usage recursively encrypt manage bucket encryption config event manage object notifications find search for objects get get s3 object to local head display first 'n' lines of an object ilm manage bucket lifecycle idp manage MinIO IDentity Provider server configuration license license related commands legalhold manage legal hold for object(s) ls list buckets and objects mb make a bucket mv move objects mirror synchronize object(s) to a remote site od measure single stream upload and download ping perform liveness check pipe stream STDIN to an object put upload an object to a bucket quota manage bucket quota rm remove object(s) retention set retention for object(s) rb remove a bucket replicate configure server side bucket replication ready checks if the cluster is ready or not sql run sql queries on objects stat show object metadata support support related commands share generate URL for temporary access to an object tree list buckets and objects in a tree format tag manage tags for bucket and object(s) undo undo PUT/DELETE operations update update mc to latest release version manage bucket versioning watch listen for object notification events
docker pull minio/mc docker run minio/mc ls play
docker pull minio/mc:edge docker run minio/mc:edge ls play
참고: 위의 예에서는 기본적으로 MinIO 플레이 환경에 대해 mc 실행합니다. 다른 S3 호환 서버에 대해 mc 실행하려면 다음과 같이 컨테이너를 시작하십시오.
docker run -it --entrypoint=/bin/sh minio/mc
그런 다음 mc alias 명령을 사용하십시오.
GitLab CI에서 Docker 컨테이너를 사용하는 경우 진입점을 빈 문자열로 설정해야 합니다.
deploy: image: name: minio/mc entrypoint: [''] stage: deploy before_script: - mc alias set minio $MINIO_HOST $MINIO_ACCESS_KEY $MINIO_SECRET_KEY script: - mc cp <source> <destination>
Homebrew를 사용하여 mc 패키지 설치
brew install minio/stable/mc mc --help
| 플랫폼 | 건축학 | URL |
|---|---|---|
| GNU/리눅스 | 64비트 인텔 | https://dl.min.io/client/mc/release/linux-amd64/mc |
| GNU/리눅스 | 64비트 PPC | https://dl.min.io/client/mc/release/linux-ppc64le/mc |
| GNU/리눅스 | 64비트 ARM | https://dl.min.io/client/mc/release/linux-arm64/mc |
| 리눅스/s390x | S390X | https://dl.min.io/client/mc/release/linux-s390x/mc |
wget https://dl.min.io/client/mc/release/linux-amd64/mc chmod +x mc ./mc --help
| 플랫폼 | 건축학 | URL |
|---|---|---|
| 마이크로소프트 윈도우 | 64비트 인텔 | https://dl.min.io/client/mc/release/windows-amd64/mc.exe |
mc.exe --help
소스 설치는 개발자와 고급 사용자만을 위한 것입니다. 작동하는 Golang 환경이 없다면 Golang 설치 방법을 따르세요. 필요한 최소 버전은 go1.22입니다.
github.com/minio/mc@latest 설치하러 가세요
POSIX 호환 파일 시스템에서만 mc 사용하려는 경우 이 단계를 건너뛰고 일상적인 사용으로 진행할 수 있습니다.
하나 이상의 Amazon S3 호환 호스트를 추가하려면 아래 지침을 따르십시오. mc 모든 구성 정보를 ~/.mc/config.json 파일에 저장합니다.
mc alias set <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api <API-SIGNATURE> --path <BUCKET-LOOKUP-TYPE>
<ALIAS> 는 단순히 클라우드 스토리지 서비스의 짧은 이름입니다. S3 엔드포인트, 액세스 및 비밀 키는 클라우드 스토리지 공급자가 제공합니다. API 서명은 선택적 인수입니다. 기본적으로 "S3v4"로 설정되어 있습니다.
경로는 선택적 인수입니다. 서버에서 DNS 또는 경로 스타일 URL 요청을 지원하는지 여부를 나타내는 데 사용됩니다. 경로 스타일 요청을 활성화/비활성화하는 유효한 값으로 "on", "off"를 허용합니다. 기본적으로 "auto"로 설정되어 있으며 SDK는 사용할 URL 조회 유형을 자동으로 결정합니다.
MinIO 서버 시작 배너에는 URL, 액세스 및 비밀 키가 표시됩니다.
mc alias set minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
AWS 자격 증명 가이드에 따라 AccessKeyID 및 SecretAccessKey를 받으세요.
mc alias set s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
참고 : Amazon S3의 IAM 사용자로서 사용자가 버킷에 대한 전체 액세스 권한을 갖고 있는지 확인하거나 IAM 사용자에 대해 다음과 같은 제한된 정책을 설정해야 합니다.
{"버전": "2012-10-17","설명": [
{"Sid": "AllowBucketStat","Effect": "허용","Action": ["s3:HeadBucket"],"Resource": "*"},
{"Sid": "AllowThisBucketOnly","Effect": "허용","Action": "s3:*","Resource": ["arn:aws:s3:::<your-restricted-bucket>/* ","arn:aws:s3:::<제한된 버킷>"]
}
]
}Google 자격 증명 가이드에 따라 AccessKeyID 및 SecretAccessKey를 받으세요.
mc alias set gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
mc https://play.min.io로 사전 구성되어 있으며 별칭은 "play"입니다. 테스트 및 개발 목적으로 호스팅되는 MinIO 서버입니다. Amazon S3를 테스트하려면 "play"를 "s3" 또는 설정 시 사용한 별칭으로 바꾸면 됩니다.
예:
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/
버킷 만들기 mb 명령은 새 버킷을 생성합니다.
예:
mc mb play/mybucket Bucket created successfully `play/mybucket`.
객체 복사 cp 명령은 하나 이상의 소스에서 대상으로 데이터를 복사합니다.
예:
mc cp myobject.txt play/mybucket myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
일반적인 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'
bash, zsh 또는 fish를 사용하는 경우. 쉘 완성은 기본적으로 mc 에 포함되어 있습니다. 자동 완성을 설치하려면 mc --autocompletion 사용하세요. 쉘을 다시 시작하면 mc는 아래와 같이 명령을 자동 완성합니다.
mc <TAB> admin config diff find ls mirror policy session sql update watch cat cp event head mb pipe rm share stat version
MinIO 기여자 가이드를 따르세요.
mc 사용은 LICENSE 파일에 있는 GNU AGPLv3 라이센스에 따라 관리됩니다.
