Table des matières

Minio S3 : commandes de base de MinIO client (mc)

Minio S3 : commandes de base de MinIO client (mc)

Présentation

Présentation des commandes essentielles du client MinIO (mc) pour gérer les buckets et les fichiers.

Prérequis

Un serveur MinIO opérationnel
* Le client 'mc' installé
* Un alias configuré (exemple : 'minio')

Exemple :

mc alias set minio http://minio:9000 ACCESS_KEY SECRET_KEY

Gestion des buckets

Lister les buckets

mc ls minio

Créer un bucket

mc mb minio/mon-bucket

Exemple :

mc mb minio/lycee

Supprimer un bucket vide

mc rb minio/mon-bucket

Supprimer un bucket non vide

mc rb --force minio/mon-bucket

Supprime tous les fichiers du bucket.

Navigation et listing

Lister le contenu d’un bucket

mc ls minio/lycee

Lister un dossier (préfixe)

mc ls minio/lycee/bts-mco

Lister récursivement

mc ls --recursive minio/lycee

Gestion des fichiers

Copier un fichier local vers MinIO

mc cp fichier.txt minio/lycee/administration/fichier.txt

Copier un fichier MinIO vers le poste local

mc cp minio/lycee/bts-mco/test.txt ./test.txt

Copier un dossier local vers MinIO

mc cp --recursive ./cours minio/lycee/bts-sio/cours

Copier un dossier MinIO vers le poste local

mc cp --recursive minio/lycee/bts-mco ./bts-mco

Renommer ou déplacer un fichier

mc mv minio/lycee/test.txt minio/lycee/administration/test.txt

Supprimer un fichier

mc rm minio/lycee/administration/test.txt

Supprimer un dossier

mc rm --recursive --force minio/lycee/bts-mco

Synchronisation (mirror)

Synchroniser un dossier local vers MinIO

mc mirror ./documents minio/lycee/administration

Synchroniser MinIO vers le poste local

mc mirror minio/lycee/bts-sio ./bts-sio

Synchronisation avec écrasement

mc mirror --overwrite ./docs minio/lycee/docs

À utiliser avec précaution.

Gestion des alias

Lister les alias

mc alias list

Ajouter un alias

mc alias set minio http://minio:9000 ACCESS_KEY SECRET_KEY

Supprimer un alias

mc alias remove minio

Gestion des événements (webhooks)

Lister les événements configurés

mc event list minio/lycee

Ajouter un webhook sans filtre

mc event add minio/lycee arn:minio:sqs::sharepoint:webhook \
  --event put,delete

Ajouter un webhook avec filtre (préfixe)

mc event add minio/lycee arn:minio:sqs::sharepoint:webhook \
  --event put,delete \
  --prefix bts-mco/

Une règle = un préfixe (les préfixes ne sont pas cumulables).

Supprimer un webhook

mc event remove minio/lycee arn:minio:sqs::sharepoint:webhook

Commandes de diagnostic

Vérifier la connexion à MinIO

mc admin info minio

Vérifier l’existence d’un fichier

mc stat minio/lycee/bts-mco/test.txt

Afficher le contenu d’un fichier texte

mc cat minio/lycee/bts-mco/test.txt

Mémo rapide (commandes essentielles)

mc ls minio
mc mb minio/bucket
mc rb --force minio/bucket

mc cp fichier minio/bucket/path
mc rm minio/bucket/path/fichier
mc mv source destination

mc mirror ./local minio/bucket
mc mirror minio/bucket ./local

mc event list minio/bucket
mc alias list

Conclusion

Le client mc est l’outil d’administration principal de MinIO.