MC文檔
MinIO Client (mc) 提供了 UNIX 命令(如 ls、cat、cp、mirror、diff、find 等)的現代替代方案。
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
平台 | 建築學 | 網址 |
---|---|---|
GNU/Linux | 64位英特爾 | https://dl.min.io/client/mc/release/linux-amd64/mc |
GNU/Linux | 64位PPC | https://dl.min.io/client/mc/release/linux-ppc64le/mc |
GNU/Linux | 64位元ARM | https://dl.min.io/client/mc/release/linux-arm64/mc |
Linux/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
平台 | 建築學 | 網址 |
---|---|---|
微軟視窗 | 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或path樣式的url請求。它接受“on”、“off”作為有效值來啟用/停用路徑樣式請求。
MinIO 伺服器啟動橫幅顯示 URL、存取權限和金鑰。
mc alias set minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
請依照 AWS Credentials Guide 取得您的 AccessKeyID 和 SecretAccessKey。
mc alias set s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
注意:作為 Amazon S3 上的 IAM 用戶,您需要確保該用戶具有對儲存桶的完全存取權限,或為您的 IAM 用戶設定以下限制策略
{"版本": "2012-10-17","聲明": [ {"Sid": "AllowBucketStat","效果": "允許","操作": ["s3:HeadBucket"],"資源": "*"}, {"Sid": "AllowThisBucketOnly","效果": "允許","操作": "s3:*","資源": ["arn:aws:s3:::<your-restricted-bucket>/* ","arn:aws:s3:::<您的受限儲存桶>"] } ] }
依照 Google Credentials Guide 取得您的 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/
Make a Bucket 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
您可以新增 shell 別名來覆蓋常用的 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。預設情況下,Shell 補全嵌入在mc
中,若要安裝自動補全功能,請使用mc --autocompletion
。重新啟動 shell,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
的使用受 GNU AGPLv3 許可證的約束,該許可證可在 LICENSE 文件中找到。