mc
RELEASE.2024-11-05T11-29-45Z
dokumentasi MC
MinIO Client (mc) menyediakan alternatif modern untuk perintah UNIX seperti ls, cat, cp, mirror, diff, find dll. MinIO Client (mc) mendukung sistem file dan layanan penyimpanan cloud yang kompatibel dengan Amazon S3 (AWS Signature v2 dan 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
Catatan: Contoh di atas menjalankan mc terhadap lingkungan bermain MinIO secara default. Untuk menjalankan mc terhadap server lain yang kompatibel dengan S3, mulai kontainer dengan cara ini:
docker run -it --entrypoint=/bin/sh minio/mc
lalu gunakan perintah mc alias .
Saat menggunakan container Docker di GitLab CI, Anda harus menyetel titik masuk ke string kosong.
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>
Instal paket mc menggunakan Homebrew
brew install minio/stable/mc mc --help
| Platform | Arsitektur | URL |
|---|---|---|
| GNU/Linux | Intel 64-bit | https://dl.min.io/client/mc/release/linux-amd64/mc |
| GNU/Linux | PPC 64-bit | https://dl.min.io/client/mc/release/linux-ppc64le/mc |
| GNU/Linux | LENGAN 64-bit | 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
| Platform | Arsitektur | URL |
|---|---|---|
| Microsoft Windows | Intel 64-bit | https://dl.min.io/client/mc/release/windows-amd64/mc.exe |
mc.exe --help
Instalasi sumber hanya ditujukan untuk pengembang dan pengguna tingkat lanjut. Jika Anda tidak memiliki lingkungan Golang yang berfungsi, ikuti Cara menginstal Golang. Versi minimum yang diperlukan adalah go1.22
pergi instal github.com/minio/mc@latest
Jika Anda berencana menggunakan mc hanya pada sistem file yang kompatibel dengan POSIX, Anda dapat melewati langkah ini dan melanjutkan ke penggunaan sehari-hari.
Untuk menambahkan satu atau lebih host yang kompatibel dengan Amazon S3, ikuti petunjuk di bawah ini. mc menyimpan semua informasi konfigurasinya dalam file ~/.mc/config.json .
mc alias set <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api <API-SIGNATURE> --path <BUCKET-LOOKUP-TYPE>
<ALIAS> hanyalah nama pendek untuk layanan penyimpanan cloud Anda. Titik akhir S3, kunci akses dan rahasia disediakan oleh penyedia penyimpanan cloud Anda. Tanda tangan API adalah argumen opsional. Secara default, ini diatur ke "S3v4".
Path adalah argumen opsional. Ini digunakan untuk menunjukkan apakah permintaan dns atau url gaya jalur didukung oleh server. Ia menerima "on", "off" sebagai nilai yang valid untuk mengaktifkan/menonaktifkan permintaan gaya jalur. Secara default, ini disetel ke "otomatis" dan SDK secara otomatis menentukan jenis pencarian url yang akan digunakan.
Spanduk startup server MinIO menampilkan URL, akses, dan kunci rahasia.
mc alias set minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Dapatkan AccessKeyID dan SecretAccessKey Anda dengan mengikuti Panduan Kredensial AWS.
mc alias set s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Catatan : Sebagai pengguna IAM di Amazon S3, Anda perlu memastikan pengguna memiliki akses penuh ke bucket atau menetapkan kebijakan terbatas berikut untuk pengguna IAM Anda
{"Versi": "2012-10-17","Pernyataan": [
{"Sid": "AllowBucketStat","Effect": "Izinkan","Action": ["s3:HeadBucket"],"Resource": "*"},
{"Sid": "AllowThisBucketOnly","Effect": "Allow","Action": "s3:*","Resource": ["arn:aws:s3:::<your-restricted-bucket>/* ","arn:aws:s3:::<tempat-yang-dibatasi-Anda>"]
}
]
}Dapatkan AccessKeyID dan SecretAccessKey Anda dengan mengikuti Panduan Kredensial Google
mc alias set gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
mc sudah dikonfigurasi sebelumnya dengan https://play.min.io, alias "play". Ini adalah server MinIO yang dihosting untuk tujuan pengujian dan pengembangan. Untuk menguji Amazon S3, cukup ganti "play" dengan "s3" atau alias yang Anda gunakan pada saat pengaturan.
Contoh:
Daftar semua keranjang dari 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/
Perintah Make a bucket mb membuat bucket baru.
Contoh:
mc mb play/mybucket Bucket created successfully `play/mybucket`.
Perintah Copy Objects cp menyalin data dari satu atau lebih sumber ke target.
Contoh:
mc cp myobject.txt play/mybucket myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Anda dapat menambahkan alias shell untuk mengganti alat Unix umum Anda.
alias ls='mc ls' alias cp='mc cp' alias cat='mc cat' alias mkdir='mc mb' alias pipe='mc pipe' alias find='mc find'
Jika Anda menggunakan bash, zsh atau fish. Penyelesaian shell tertanam secara default di mc , untuk menginstal pelengkapan otomatis gunakan mc --autocompletion . Restart shell, mc akan menyelesaikan perintah secara otomatis seperti yang ditunjukkan di bawah ini.
mc <TAB> admin config diff find ls mirror policy session sql update watch cat cp event head mb pipe rm share stat version
Silakan ikuti Panduan Kontributor MinIO
Penggunaan mc diatur oleh lisensi GNU AGPLv3 yang dapat ditemukan di file LICENSE.
