mc
RELEASE.2024-11-05T11-29-45Z
MC ドキュメント
MinIO クライアント (mc) は、ls、cat、cp、mirror、diff、find などの UNIX コマンドに代わる最新のコマンドを提供します。ファイルシステムと Amazon S3 互換のクラウド ストレージ サービス (AWS Signature v2 および 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
注:上記の例では、デフォルトで MinIOプレイ環境に対してmc実行します。他の S3 互換サーバーに対してmc実行するには、次の方法でコンテナを起動します。
docker run -it --entrypoint=/bin/sh minio/mc
次に、 mc aliasコマンドを使用します。
GitLab CI で Docker コンテナを使用する場合は、エントリポイントを空の文字列に設定する必要があります。
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>
Homebrew を使用して mc パッケージをインストールする
brew install minio/stable/mc mc --help
| プラットフォーム | 建築 | URL |
|---|---|---|
| GNU/Linux | 64ビットインテル | https://dl.min.io/client/mc/release/linux-amd64/mc |
| GNU/Linux | 64ビットPPC | https://dl.min.io/client/mc/release/linux-ppc64le/mc |
| GNU/Linux | 64ビットARM | 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
| プラットフォーム | 建築 | URL |
|---|---|---|
| マイクロソフト Windows | 64ビットインテル | https://dl.min.io/client/mc/release/windows-amd64/mc.exe |
mc.exe --help
ソースのインストールは、開発者と上級ユーザーのみを対象としています。 Golang 環境が動作しない場合は、「Golang のインストール方法」に従ってください。必要な最小バージョンは go1.22 です
github.com/minio/mc@latest をインストールしてください
POSIX 互換ファイルシステム上でのみmc使用する予定がある場合は、この手順をスキップして日常的な使用に進むことができます。
1 つ以上の Amazon S3 互換ホストを追加するには、以下の手順に従ってください。 mc 、すべての構成情報を~/.mc/config.jsonファイルに保存します。
mc alias set <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api <API-SIGNATURE> --path <BUCKET-LOOKUP-TYPE>
<ALIAS> 、クラウド ストレージ サービスの単なる短縮名です。 S3 エンドポイント、アクセス キー、および秘密キーは、クラウド ストレージ プロバイダーから提供されます。 API 署名はオプションの引数です。デフォルトでは「S3v4」に設定されています。
パスはオプションの引数です。これは、DNS またはパス スタイルの URL リクエストがサーバーでサポートされているかどうかを示すために使用されます。パス スタイル リクエストを有効または無効にするための有効な値として「on」、「off」を受け入れます。デフォルトでは「auto」に設定されており、SDK は使用する URL ルックアップのタイプを自動的に決定します。
MinIO サーバーの起動バナーには、URL、アクセス、秘密キーが表示されます。
mc alias set minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
AWS 認証情報ガイドに従って、AccessKeyID と SecretAccessKey を取得します。
mc alias set s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
注: Amazon S3 の IAM ユーザーとして、ユーザーがバケットへの完全なアクセス権を持っていることを確認するか、IAM ユーザーに対して次の制限付きポリシーを設定する必要があります。
{"バージョン": "2012-10-17","ステートメント": [
{"Sid": "AllowBucketStat","効果": "許可","アクション": ["s3:HeadBucket"],"リソース": "*"},
{"Sid": "AllowThisBucketOnly","Effect": "Allow","Action": "s3:*","Resource": ["arn:aws:s3:::<your-restricted-bucket>/* ","arn:aws:s3:::<制限されたバケット>"]
}
]
}Google 資格情報ガイドに従って、AccessKeyID と SecretAccessKey を取得します。
mc alias set gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
mcは https://play.min.io で事前設定されており、エイリアスは「play」です。これは、テストおよび開発目的でホストされる MinIO サーバーです。 Amazon S3 をテストするには、「play」を「s3」またはセットアップ時に使用したエイリアスに置き換えるだけです。
例：
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/
バケットの作成mbコマンドは新しいバケットを作成します。
例：
mc mb play/mybucket Bucket created successfully `play/mybucket`.
オブジェクトのコピーcpコマンドは、1 つ以上のソースからターゲットにデータをコピーします。
例：
mc cp myobject.txt play/mybucket myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
シェル エイリアスを追加して、一般的な Unix ツールをオーバーライドできます。
alias ls='mc ls' alias cp='mc cp' alias cat='mc cat' alias mkdir='mc mb' alias pipe='mc pipe' alias find='mc find'
bash、zsh、またはfishを使用している場合。シェル補完はデフォルトでmcに組み込まれており、自動補完をインストールするにはmc --autocompletionを使用します。シェルを再起動すると、以下に示すように mc がコマンドを自動補完します。
mc <TAB> admin config diff find ls mirror policy session sql update watch cat cp event head mb pipe rm share stat version
MinIO 貢献者ガイドに従ってください。
mcの使用は、LICENSE ファイルにある GNU AGPLv3 ライセンスによって管理されます。
