====== 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 :
<code>
mc alias set minio http://minio:9000 ACCESS_KEY SECRET_KEY
</code>

===== Gestion des buckets =====

====  Lister les buckets  ====

<code>
mc ls minio
</code>

==== Créer un bucket ====
<code>
mc mb minio/mon-bucket
</code>

Exemple :
<code>
mc mb minio/lycee
</code>

==== Supprimer un bucket vide ====
<code>
mc rb minio/mon-bucket
</code>

==== Supprimer un bucket non vide ====
<code>
mc rb --force minio/mon-bucket
</code>

<WRAP center round important >
Supprime tous les fichiers du bucket.
</WRAP>


====  Navigation et listing ====

=== Lister le contenu d’un bucket ===
<code>
mc ls minio/lycee
</code>

=== Lister un dossier (préfixe) ===
<code>
mc ls minio/lycee/bts-mco
</code>

=== Lister récursivement ===
<code>
mc ls --recursive minio/lycee
</code>



====  Gestion des fichiers ====

=== Copier un fichier local vers MinIO ===
<code>
mc cp fichier.txt minio/lycee/administration/fichier.txt
</code>

=== Copier un fichier MinIO vers le poste local ===
<code>
mc cp minio/lycee/bts-mco/test.txt ./test.txt
</code>

=== Copier un dossier local vers MinIO ===
<code>
mc cp --recursive ./cours minio/lycee/bts-sio/cours
</code>

=== Copier un dossier MinIO vers le poste local ===
<code>
mc cp --recursive minio/lycee/bts-mco ./bts-mco
</code>

=== Renommer ou déplacer un fichier ===
<code>
mc mv minio/lycee/test.txt minio/lycee/administration/test.txt
</code>

=== Supprimer un fichier ===
<code>
mc rm minio/lycee/administration/test.txt
</code>

=== Supprimer un dossier ===
<code>
mc rm --recursive --force minio/lycee/bts-mco
</code>



====  Synchronisation (mirror) ====

=== Synchroniser un dossier local vers MinIO ===
<code>
mc mirror ./documents minio/lycee/administration
</code>

=== Synchroniser MinIO vers le poste local ===
<code>
mc mirror minio/lycee/bts-sio ./bts-sio
</code>

=== Synchronisation avec écrasement ===
<code>
mc mirror --overwrite ./docs minio/lycee/docs
</code>

<WRAP center round important >
À utiliser avec précaution.
</WRAP>


==== Gestion des alias ====

=== Lister les alias ===
<code>
mc alias list
</code>

=== Ajouter un alias ===
<code>
mc alias set minio http://minio:9000 ACCESS_KEY SECRET_KEY
</code>

=== Supprimer un alias ===
<code>
mc alias remove minio
</code>



==== Gestion des événements (webhooks)====

=== Lister les événements configurés ===
<code>
mc event list minio/lycee
</code>

=== Ajouter un webhook sans filtre ===
<code>
mc event add minio/lycee arn:minio:sqs::sharepoint:webhook \
  --event put,delete
</code>

=== Ajouter un webhook avec filtre (préfixe) ===
<code>
mc event add minio/lycee arn:minio:sqs::sharepoint:webhook \
  --event put,delete \
  --prefix bts-mco/
</code>

<WRAP center round important >
Une règle = un préfixe (les préfixes ne sont pas cumulables).
</WRAP>


=== Supprimer un webhook ===
<code>
mc event remove minio/lycee arn:minio:sqs::sharepoint:webhook
</code>



==== Commandes de diagnostic ====

=== Vérifier la connexion à MinIO ===
<code>
mc admin info minio
</code>

=== Vérifier l’existence d’un fichier ===
<code>
mc stat minio/lycee/bts-mco/test.txt
</code>

=== Afficher le contenu d’un fichier texte ===
<code>
mc cat minio/lycee/bts-mco/test.txt
</code>


==== Mémo rapide (commandes essentielles)====

<code>
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
</code>


== Conclusion ==

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