mc
RELEASE.2024-11-05T11-29-45Z
เอกสารเอ็มซี
MinIO Client (mc) เป็นทางเลือกที่ทันสมัยแทนคำสั่ง UNIX เช่น ls, cat, cp, mirror, diff, find ฯลฯ โดยรองรับระบบไฟล์และบริการจัดเก็บข้อมูลบนคลาวด์ที่เข้ากันได้กับ 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
หมายเหตุ: ตัวอย่างข้างต้นรัน mc กับสภาพแวดล้อม การเล่น MiniIO ตามค่าเริ่มต้น หากต้องการรัน mc กับเซิร์ฟเวอร์อื่นที่เข้ากันได้กับ S3 ให้เริ่มคอนเทนเนอร์ด้วยวิธีนี้:
docker run -it --entrypoint=/bin/sh minio/mc
จากนั้นใช้คำสั่ง mc alias
เมื่อใช้คอนเทนเนอร์ Docker ใน GitLab CI คุณต้องตั้งค่าจุดเข้าเป็นสตริงว่าง
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>
ติดตั้งแพ็คเกจ mc โดยใช้ Homebrew
brew install minio/stable/mc mc --help
| แพลตฟอร์ม | สถาปัตยกรรม | URL |
|---|---|---|
| กนู/ลินุกซ์ | อินเทล 64 บิต | https://dl.min.io/client/mc/release/linux-amd64/mc |
| กนู/ลินุกซ์ | PPC 64 บิต | https://dl.min.io/client/mc/release/linux-ppc64le/mc |
| กนู/ลินุกซ์ | ARM 64 บิต | 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
หากคุณวางแผนที่จะใช้ mc บนระบบไฟล์ที่รองรับ POSIX เท่านั้น คุณสามารถข้ามขั้นตอนนี้และดำเนินการใช้งานทุกวันต่อไปได้
หากต้องการเพิ่มโฮสต์ที่เข้ากันได้กับ 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"
Path เป็นอาร์กิวเมนต์ที่เป็นทางเลือก ใช้เพื่อระบุว่าเซิร์ฟเวอร์รองรับคำขอ DNS หรือ URL สไตล์เส้นทางหรือไม่ โดยยอมรับ "เปิด", "ปิด" เป็นค่าที่ถูกต้องเพื่อเปิด/ปิดใช้งานคำขอสไตล์เส้นทาง โดยค่าเริ่มต้น ค่าดังกล่าวจะถูกตั้งค่าเป็น "อัตโนมัติ" และ SDK จะกำหนดประเภทของการค้นหา URL ที่จะใช้โดยอัตโนมัติ
แบนเนอร์เริ่มต้นเซิร์ฟเวอร์ MiniIO จะแสดง URL การเข้าถึงและคีย์ลับ
mc alias set minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
รับ AccessKeyID และ SecretAccessKey ของคุณโดยทำตามคำแนะนำ AWS Credentials
mc alias set s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
หมายเหตุ : ในฐานะผู้ใช้ IAM บน Amazon S3 คุณต้องตรวจสอบให้แน่ใจว่าผู้ใช้มีสิทธิ์เข้าถึงบัคเก็ตโดยสมบูรณ์ หรือตั้งค่านโยบายแบบจำกัดต่อไปนี้สำหรับผู้ใช้ IAM ของคุณ
{"เวอร์ชัน": "2012-10-17", "คำชี้แจง": [
{"Sid": "AllowBucketStat", "เอฟเฟกต์": "อนุญาต", "การกระทำ": ["s3:HeadBucket"],"ทรัพยากร": "*"},
{"Sid": "AllowThisBucketOnly", "Effect": "Allow", "Action": "s3:*", "Resource": ["arn:aws:s3:::<your-restricted-bucket>/* ","arn:aws:s3:::<ถังที่ถูกจำกัดของคุณ>"]
-
-
-รับ AccessKeyID และ SecretAccessKey ของคุณโดยทำตามคำแนะนำข้อมูลรับรอง Google
mc alias set gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
mc ได้รับการกำหนดค่าล่วงหน้าด้วย https://play.min.io ซึ่งมีนามแฝงว่า "play" เป็นเซิร์ฟเวอร์ MiniIO ที่โฮสต์สำหรับการทดสอบและพัฒนา หากต้องการทดสอบ 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`.
คำสั่ง Copy Objects 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 อยู่ภายใต้ใบอนุญาต GNU AGPLv3 ซึ่งสามารถพบได้ในไฟล์ LICENSE
