mc
RELEASE.2024-11-05T11-29-45Z
MC-Dokumentation
MinIO Client (mc) bietet eine moderne Alternative zu UNIX-Befehlen wie ls, cat, cp, Mirror, Diff, Find usw. Es unterstützt Dateisysteme und Amazon S3-kompatible Cloud-Speicherdienste (AWS Signature v2 und 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
Hinweis: In den obigen Beispielen wird mc standardmäßig in der MinIO -Spielumgebung ausgeführt. Um mc auf anderen S3-kompatiblen Servern auszuführen, starten Sie den Container auf diese Weise:
docker run -it --entrypoint=/bin/sh minio/mc
Verwenden Sie dann den Befehl mc alias .
Wenn Sie den Docker-Container in GitLab CI verwenden, müssen Sie den Einstiegspunkt auf eine leere Zeichenfolge setzen.
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>
Installieren Sie MC-Pakete mit Homebrew
brew install minio/stable/mc mc --help
| Plattform | Architektur | URL |
|---|---|---|
| GNU/Linux | 64-Bit-Intel | https://dl.min.io/client/mc/release/linux-amd64/mc |
| GNU/Linux | 64-Bit-PPC | https://dl.min.io/client/mc/release/linux-ppc64le/mc |
| GNU/Linux | 64-Bit-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
| Plattform | Architektur | URL |
|---|---|---|
| Microsoft Windows | 64-Bit-Intel | https://dl.min.io/client/mc/release/windows-amd64/mc.exe |
mc.exe --help
Die Quellinstallation ist nur für Entwickler und fortgeschrittene Benutzer gedacht. Wenn Sie nicht über eine funktionierende Golang-Umgebung verfügen, folgen Sie bitte der Anleitung zur Installation von Golang. Die erforderliche Mindestversion ist go1.22
Gehen Sie und installieren Sie github.com/minio/mc@latest
Wenn Sie planen, mc nur auf POSIX-kompatiblen Dateisystemen zu verwenden, können Sie diesen Schritt überspringen und mit der täglichen Verwendung fortfahren.
Um einen oder mehrere Amazon S3-kompatible Hosts hinzuzufügen, befolgen Sie bitte die nachstehenden Anweisungen. mc speichert alle seine Konfigurationsinformationen in der Datei ~/.mc/config.json .
mc alias set <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api <API-SIGNATURE> --path <BUCKET-LOOKUP-TYPE>
<ALIAS> ist einfach ein Kurzname für Ihren Cloud-Speicherdienst. S3-Endpunkt, Zugriff und geheime Schlüssel werden von Ihrem Cloud-Speicheranbieter bereitgestellt. Die API-Signatur ist ein optionales Argument. Standardmäßig ist es auf „S3v4“ eingestellt.
Pfad ist ein optionales Argument. Es wird verwendet, um anzugeben, ob DNS- oder Pfad-URL-Anfragen vom Server unterstützt werden. Es akzeptiert „on“ und „off“ als gültige Werte zum Aktivieren/Deaktivieren von Pfadstilanforderungen. Standardmäßig ist es auf „auto“ eingestellt und das SDK bestimmt automatisch den Typ der zu verwendenden URL-Suche.
Das Startbanner des MinIO-Servers zeigt URL, Zugriff und geheime Schlüssel an.
mc alias set minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Erhalten Sie Ihre AccessKeyID und Ihren SecretAccessKey, indem Sie dem AWS Credentials Guide folgen.
mc alias set s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Hinweis : Als IAM-Benutzer auf Amazon S3 müssen Sie sicherstellen, dass der Benutzer vollen Zugriff auf die Buckets hat, oder die folgende eingeschränkte Richtlinie für Ihren IAM-Benutzer festlegen
{"Version": "2012-10-17","Erklärung": [
{"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>"]
}
]
}Erhalten Sie Ihre AccessKeyID und Ihren SecretAccessKey, indem Sie dem Google Credentials Guide folgen
mc alias set gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
mc ist mit https://play.min.io vorkonfiguriert, Alias „play“. Es handelt sich um einen gehosteten MinIO-Server für Test- und Entwicklungszwecke. Um Amazon S3 zu testen, ersetzen Sie einfach „play“ durch „s3“ oder den Alias, den Sie zum Zeitpunkt der Einrichtung verwendet haben.
Beispiel:
Listen Sie alle Buckets von https://play.min.io auf
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/
Der Befehl „Make a Bucket mb erstellt einen neuen Bucket.
Beispiel:
mc mb play/mybucket Bucket created successfully `play/mybucket`.
cp -Befehl „Objekte kopieren“ kopiert Daten aus einer oder mehreren Quellen in ein Ziel.
Beispiel:
mc cp myobject.txt play/mybucket myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Sie können Shell-Aliase hinzufügen, um Ihre gängigen Unix-Tools zu überschreiben.
alias ls='mc ls' alias cp='mc cp' alias cat='mc cat' alias mkdir='mc mb' alias pipe='mc pipe' alias find='mc find'
Falls Sie Bash, ZSH oder Fish verwenden. Die Shell-Vervollständigung ist standardmäßig in mc eingebettet. Um die automatische Vervollständigung zu installieren, verwenden Sie mc --autocompletion . Starten Sie die Shell neu. mc vervollständigt die Befehle automatisch, wie unten gezeigt.
mc <TAB> admin config diff find ls mirror policy session sql update watch cat cp event head mb pipe rm share stat version
Bitte befolgen Sie den Leitfaden für MinIO-Mitwirkende
Die Nutzung von mc unterliegt der GNU AGPLv3-Lizenz, die in der LICENSE-Datei zu finden ist.
