minio client mc

date: 2017-10-21 excerpt: MinIOクライアント mc の使い方

MinIOクライアント mc の使い方

概要

MinIOおよびS3互換ストレージをCLIで操作するクライアントツール
aws s3 コマンドに相当するが、MinIO・GCS・Azureなど複数のバックエンドに対応
エイリアスでプロファイルを管理し、mc <コマンド> <エイリアス>/<パス> の形式で操作する

インストール

goコマンド

$ go install github.com/minio/mc@latest

macOS

$ brew install minio/stable/mc

バイナリを直接ダウンロード（Linux）

$ wget https://dl.min.io/client/mc/release/linux-amd64/mc
$ chmod +x mc
$ sudo mv mc /usr/myminio/bin/

エイリアスの設定

接続先をエイリアスとして登録する

$ mc alias set <alias> <endpoint-url> <access-key> <secret-key>

登録例

$ mc alias set myminio http://localhost:9000 minioadmin minioadmin
$ mc alias set prod https://s3.example.com AKIAIOSFODNN7 wJalrXUtnFEMI

登録済みエイリアスの一覧と確認

$ mc alias list
$ mc alias list myminio

エイリアスの削除

$ mc alias remove myminio

基本操作

バケット操作

$ mc mb myminio/my-bucket          # バケット作成
$ mc rb myminio/my-bucket          # バケット削除（空のみ）
$ mc rb --force myminio/my-bucket  # バケット削除（中身ごと）
$ mc ls myminio                  # バケット一覧
$ mc ls myminio/my-bucket          # バケット内オブジェクト一覧
$ mc ls --recursive myminio/my-bucket  # 再帰的に一覧表示

ファイルのアップロード・ダウンロード

$ mc cp file.txt myminio/my-bucket/           # ファイルをアップロード
$ mc cp myminio/my-bucket/file.txt ./         # ファイルをダウンロード
$ mc cp --recursive ./data/ myminio/my-bucket/data/  # ディレクトリごとアップロード
$ mc cp --recursive myminio/my-bucket/data/ ./data/  # ディレクトリごとダウンロード

ミラーリング（同期）

ローカル↔ストレージ間の差分同期

$ mc mirror ./data/ myminio/my-bucket/data/   # ローカル → ストレージに同期
$ mc mirror myminio/my-bucket/data/ ./data/   # ストレージ → ローカルに同期
$ mc mirror --watch ./data/ myminio/my-bucket/data/  # 変更を監視して継続同期

ファイルの削除・移動

$ mc rm myminio/my-bucket/file.txt            # ファイル削除
$ mc rm --recursive myminio/my-bucket/data/  # ディレクトリ以下を削除
$ mc mv myminio/my-bucket/a.txt myminio/my-bucket/b.txt  # リネーム・移動

ファイルの確認・検索

$ mc stat myminio/my-bucket/file.txt          # オブジェクトのメタデータ表示
$ mc find myminio/my-bucket --name "*.csv"    # 名前でオブジェクトを検索
$ mc find myminio/my-bucket --larger 100MB    # サイズでオブジェクトを検索
$ mc du myminio/my-bucket                     # バケットの使用量確認

パイプ経由での読み書き

$ mc cat myminio/my-bucket/file.txt           # ファイル内容を標準出力に表示
$ echo "hello" | mc pipe myminio/my-bucket/hello.txt  # 標準入力からアップロード

ポリシー（公開設定）

$ mc anonymous set download myminio/my-bucket      # バケットを読み取り公開
$ mc anonymous set none myminio/my-bucket          # 公開設定を解除（非公開に戻す）
$ mc anonymous get myminio/my-bucket               # 現在のポリシーを確認

バケット間コピー（サーバーサイド）

同じエイリアス内または異なるエイリアス間でコピーできる

$ mc cp myminio/src-bucket/file.txt myminio/dst-bucket/
$ mc mirror prod/src-bucket myminio/dst-bucket     # 別エンドポイント間の同期

シェル補完

$ mc --autocompletion

zshではサブコマンド名の補完は部分的に機能するが、バケット・オブジェクトのパス補完は動作しないバグが未解決（2025年時点でissueがopen）
bashに切り替えると補完が機能する

参考

MinIO Client Documentation

minio mc s3