mc
RELEASE.2024-11-05T11-29-45Z
Documentation MC
MinIO Client (mc) offre une alternative moderne aux commandes UNIX telles que ls, cat, cp, miroir, diff, find, etc. Il prend en charge les systèmes de fichiers et le service de stockage cloud compatible Amazon S3 (AWS Signature v2 et 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
Remarque : les exemples ci-dessus exécutent mc sur l'environnement de jeu MinIO par défaut. Pour exécuter mc sur d'autres serveurs compatibles S3, démarrez le conteneur de cette façon :
docker run -it --entrypoint=/bin/sh minio/mc
puis utilisez la commande mc alias .
Lorsque vous utilisez le conteneur Docker dans GitLab CI, vous devez définir le point d'entrée sur une chaîne vide.
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>
Installer les packages mc à l'aide de Homebrew
brew install minio/stable/mc mc --help
| Plate-forme | Architecture | URL |
|---|---|---|
| GNU/Linux | Intel 64 bits | https://dl.min.io/client/mc/release/linux-amd64/mc |
| GNU/Linux | PPC 64 bits | https://dl.min.io/client/mc/release/linux-ppc64le/mc |
| GNU/Linux | BRAS 64 bits | 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
| Plate-forme | Architecture | URL |
|---|---|---|
| Microsoft Windows | Intel 64 bits | https://dl.min.io/client/mc/release/windows-amd64/mc.exe |
mc.exe --help
L'installation des sources est uniquement destinée aux développeurs et aux utilisateurs avancés. Si vous ne disposez pas d'un environnement Golang fonctionnel, veuillez suivre Comment installer Golang. La version minimale requise est go1.22
allez installer github.com/minio/mc@latest
Si vous prévoyez d'utiliser mc uniquement sur des systèmes de fichiers compatibles POSIX, vous pouvez ignorer cette étape et procéder à une utilisation quotidienne.
Pour ajouter un ou plusieurs hôtes compatibles Amazon S3, veuillez suivre les instructions ci-dessous. mc stocke toutes ses informations de configuration dans le fichier ~/.mc/config.json .
mc alias set <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api <API-SIGNATURE> --path <BUCKET-LOOKUP-TYPE>
<ALIAS> est simplement un nom court pour votre service de stockage cloud. Le point de terminaison S3, les clés d'accès et les clés secrètes sont fournis par votre fournisseur de stockage cloud. La signature API est un argument facultatif. Par défaut, il est défini sur « S3v4 ».
Le chemin est un argument facultatif. Il est utilisé pour indiquer si les demandes d'URL de style DNS ou de chemin sont prises en charge par le serveur. Il accepte "on", "off" comme valeurs valides pour activer/désactiver les demandes de style de chemin. Par défaut, il est défini sur "auto" et le SDK détermine automatiquement le type de recherche d'URL à utiliser.
La bannière de démarrage du serveur MinIO affiche l'URL, les clés d'accès et les clés secrètes.
mc alias set minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Obtenez votre AccessKeyID et SecretAccessKey en suivant le Guide des informations d'identification AWS.
mc alias set s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Remarque : en tant qu'utilisateur IAM sur Amazon S3, vous devez vous assurer que l'utilisateur dispose d'un accès complet aux compartiments ou définir la stratégie restreinte suivante pour votre utilisateur IAM.
{"Version": "2012-10-17", "Déclaration": [
{"Sid": "AllowBucketStat","Effect": "Allow","Action": ["s3:HeadBucket"],"Resource": "*"},
{"Sid": "AllowThisBucketOnly","Effect": "Allow","Action": "s3:*","Resource": ["arn:aws:s3:::<your-restricted-bucket>/* ","arn:aws:s3:::<votre-compartiment restreint>"]
}
]
}Obtenez votre AccessKeyID et SecretAccessKey en suivant le guide des informations d'identification Google
mc alias set gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
mc est préconfiguré avec https://play.min.io, alias "play". Il s'agit d'un serveur MinIO hébergé à des fins de test et de développement. Pour tester Amazon S3, remplacez simplement « play » par « s3 » ou l'alias que vous avez utilisé au moment de la configuration.
Exemple:
Répertoriez tous les buckets de 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/
La commande Créer un bucket mb crée un nouveau bucket.
Exemple:
mc mb play/mybucket Bucket created successfully `play/mybucket`.
La commande Copier les objets cp copie les données d'une ou plusieurs sources vers une cible.
Exemple:
mc cp myobject.txt play/mybucket myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Vous pouvez ajouter des alias de shell pour remplacer vos outils Unix courants.
alias ls='mc ls' alias cp='mc cp' alias cat='mc cat' alias mkdir='mc mb' alias pipe='mc pipe' alias find='mc find'
Si vous utilisez bash, zsh ou fish. La complétion du shell est intégrée par défaut dans mc , pour installer la complétion automatique, utilisez mc --autocompletion . Redémarrez le shell, mc complétera automatiquement les commandes comme indiqué ci-dessous.
mc <TAB> admin config diff find ls mirror policy session sql update watch cat cp event head mb pipe rm share stat version
Veuillez suivre le guide du contributeur MinIO
L'utilisation de mc est régie par la licence GNU AGPLv3 qui se trouve dans le fichier LICENSE.
