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 |
| جنو/لينكس | 64 بت قدرة شرائية | https://dl.min.io/client/mc/release/linux-ppc64le/mc |
| جنو/لينكس | ذراع 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".
المسار هو وسيطة اختيارية. يتم استخدامه للإشارة إلى ما إذا كان الخادم يدعم طلبات نظام أسماء النطاقات أو عنوان URL لنمط المسار. يقبل "تشغيل" و"إيقاف" كقيم صالحة لتمكين/تعطيل طلبات نمط المسار. افتراضيًا، يتم تعيينه على "تلقائي" ويحدد SDK تلقائيًا نوع البحث عن عنوان url المطلوب استخدامه.
يعرض شعار بدء تشغيل خادم MinIO عنوان URL والوصول والمفاتيح السرية.
mc alias set minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
احصل على AccessKeyID وSecretAccessKey باتباع دليل بيانات اعتماد AWS.
mc alias set s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
ملاحظة : باعتبارك مستخدم IAM في Amazon S3، يتعين عليك التأكد من أن المستخدم لديه حق الوصول الكامل إلى الحاويات أو تعيين السياسة المقيدة التالية لمستخدم IAM الخاص بك
{"الإصدار": "17-10-2012"، "البيان": [
{"Sid": "AllowBucketStat"، "Effect": "Allow"، "Action": ["s3:HeadBucket"]،"Resource": "*"},
{"Sid": "AllowThisBucketOnly"، "Effect": "Allow"، "Action": "s3:*"، "Resource": ["arn:aws:s3:::<your-restricted-bucket>/* ""،"arn:aws:s3:::<your-restricted-bucket>"]
}
]
}احصل على AccessKeyID وSecretAccessKey باتباع دليل بيانات اعتماد Google
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`.
يقوم أمر Copy Objects 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 . أعد تشغيل الصدفة، وسيقوم 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 الذي يمكن العثور عليه في ملف الترخيص.
