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. Avec ces commandes, il est possible de gérer un stockage objet complet dans un cadre pédagogique ou institutionnel (ENT, lycée, DSI).