Minio入门系列【5】MinIO Client使用详解

简介

MinIO Client 简称mc，是minio服务器的客户端，对ls，cat，cp，mirror，diff，find等UNIX命令提供了一种替代方案，它支持文件系统和兼容Amazon S3的云存储服务（AWS Signature v2和v4）。

ls       列出文件和文件夹。
mb       创建一个存储桶或一个文件夹。
cat      显示文件和对象内容。
pipe     将一个STDIN重定向到一个对象或者文件或者STDOUT。
share    生成用于共享的URL。
cp       拷贝文件和对象。
mirror   给存储桶和文件夹做镜像。
find     基于参数查找文件。
diff     对两个文件夹或者存储桶比较差异。
rm       删除文件和对象。
events   管理对象通知。
watch    监听文件和对象的事件。
policy   管理访问策略。
session  为cp命令管理保存的会话。
config   管理mc配置文件。
update   检查软件更新。
version  输出版本信息。

Centos 7 安装mc

下载mc:

[root@hadoop001 minio]# wget http://dl.minio.org.cn/client/mc/release/linux-amd64/mc
[root@hadoop001 minio]# chmod +x mc 
[root@hadoop001 minio]# mv mc /usr/bin/
# 查看帮助
[root@hadoop001 minio]# mc -h

添加服务器节点：

[root@hadoop001 minio]# mc config host add s3 http://192.168.58.201:9000  admin  admin123  --api s3v4
[root@hadoop001 minio]# mc config host ls
# 查看s3下的所有存储桶
[root@hadoop001 minio]# mc ls s3

可以看到当前我们添加名称为s3的节点，及这个节点下的所有存储桶：

常用命令

1. ls 列出存储桶和对象

ls命令列出文件、对象和存储桶。使用–incomplete flag可列出未完整拷贝的内容。

用法：
   mc ls [FLAGS] TARGET [TARGET ...]

FLAGS:
  --help, -h                       显示帮助。
  --recursive, -r          递归。
  --incomplete, -I         列出未完整上传的对象。

示例： 列出所有s3上的存储桶。

[root@hadoop001 minio]# mc ls s3

示例： 列出所有s3上的存储桶qqqqq下的文件。

[root@hadoop001 minio]# mc ls s3/qqqqq

2. mb命令 - 创建存储桶

mb命令在对象存储上创建一个新的存储桶。在文件系统，它就和mkdir -p命令是一样的。存储桶相当于文件系统中的磁盘或挂载点，不应视为文件夹。MinIO对每个​​用户创建的存储桶数量没有限制。 在Amazon S3上，每个帐户被限制为100个存储桶。

用法：
   mc mb [FLAGS] TARGET [TARGET...]

FLAGS:
  --help, -h                       显示帮助。
  --region "us-east-1"         指定存储桶的region，默认是‘us-east-1’.

示例：在s3上创建一个名叫"mybucket"的存储桶。

[root@hadoop001 minio]# mc mb s3/mybucket

3. cat命令 - 合并对象

cat命令将一个文件或者对象的内容合并到另一个上。你也可以用它将对象的内容输出到stdout。

用法：
   mc cat [FLAGS] SOURCE [SOURCE...]

FLAGS:
  --help, -h                       显示帮助。

示例： 显示myobject.txt文件的内容

[root@hadoop001 minio]# mc cat s3/mybucket/aa.txt

4. pipe命令 - Pipe到对象

pipe命令拷贝stdin里的内容到目标输出，如果没有指定目标输出，则输出到stdout。

用法：
   mc pipe [FLAGS] [TARGET]

FLAGS:
  --help, -h                    显示帮助。

示例： 将MySQL数据库dump文件输出到Amazon S3。

mysqldump -u root -p ******* accountsdb | mc pipe s3/sql-backups/backups/accountsdb-oct-9-2015.sql

5. cp命令 - 拷贝对象

cp命令拷贝一个或多个源文件目标输出。所有到对象存储的拷贝操作都进行了MD4SUM checkSUM校验。可以从故障点恢复中断或失败的复制操作。

用法：
   mc cp [FLAGS] SOURCE [SOURCE...] TARGET
FLAGS:
  --help, -h                       显示帮助。
  --recursive, -r          递归拷贝。

示例： 拷贝一个本地文本文件到对象存储s3/aaaa。

[root@hadoop001 minio]# mc cp starh.sh s3/aaaa

6. rm命令 - 删除存储桶和对象。

使用rm命令删除文件对象或者存储桶。

用法：
   mc rm [FLAGS] TARGET [TARGET ...]

FLAGS:
  --help, -h                       显示帮助。
  --recursive, -r              递归删除。
  --force              强制执行删除操作。
  --prefix             删除批配这个前缀的对象。
  --incomplete, -I      删除未完整上传的对象。
  --fake               模拟一个假的删除操作。
  --stdin              从STDIN中读对象列表。
  --older-than value               删除N天前的对象（默认是0天）。

示例： 删除一个对象。

[root@hadoop001 minio]# mc rm s3/aaaa/starh.sh 

示例：删除一个存储桶并递归删除里面所有的内容。由于这个操作太危险了，你必须传–force参数指定强制删除。

[root@hadoop001 minio]# mc rm --recursive --force s3/qqqqq

示例： 从mybucket里删除所有未完整上传的对象。

[root@hadoop001 minio]# mc rm  --incomplete --recursive --force s3/mybucket

示例： 删除一天前的对象。

[root@hadoop001 minio]# mc rm --force --older-than=1 s3/mybucket/oldsongs

7. share命令 - 共享

share命令安全地授予上传或下载的权限。此访问只是临时的，与远程用户和应用程序共享也是安全的。如果你想授予永久访问权限，你可以看看mc policy命令。

生成的网址中含有编码后的访问认证信息，任何企图篡改URL的行为都会使访问无效。想了解这种机制是如何工作的，请参考Pre-Signed URL技术。

用法：
   mc share [FLAGS] COMMAND

FLAGS:
  --help, -h                       显示帮助。

COMMANDS:
   download   生成有下载权限的URL。
   upload     生成有上传权限的URL。
   list       列出先前共享的对象和文件夹。

8. 子命令share download - 共享下载

share download命令生成不需要access key和secret key即可下载的URL，过期参数设置成最大有效期（不大于7天），过期之后权限自动回收。

用法：
   mc share download [FLAGS] TARGET [TARGET...]

FLAGS:
  --help, -h                       显示帮助。
  --recursive, -r          递归共享所有对象。
  --expire, -E "168h"          设置过期时限，NN[h|m|s]。

示例： 生成一个对一个对象有4小时访问权限的URL。

[root@hadoop001 minio]# mc share download --expire 4h s3/aaaa/aa.txt

9. 子命令share upload - 共享上传

share upload命令生成不需要access key和secret key即可上传的URL。过期参数设置成最大有效期（不大于7天），过期之后权限自动回收。 Content-type参数限制只允许上传指定类型的文件。

用法：
   mc share upload [FLAGS] TARGET [TARGET...]

FLAGS:
  --help, -h                       显示帮助。
  --recursive, -r              递归共享所有对象。
  --expire, -E "168h"          设置过期时限，NN[h|m|s].

示例： 生成一个curl命令，赋予上传到play/mybucket/myotherobject.txt的权限。

[root@hadoop001 minio]# mc share upload s3/mybucket/myotherobject.txt

10. 子命令share list - 列出之前的共享

share list列出没未过期的共享URL。

用法：
   mc share list COMMAND

COMMAND:
   upload:   列出先前共享的有上传权限的URL。
   download: 列出先前共享的有下载权限的URL。

11. mirror命令 - 存储桶镜像

mirror命令和rsync类似，只不过它是在文件系统和对象存储之间做同步。

用法：
   mc mirror [FLAGS] SOURCE TARGET

FLAGS:
  --help, -h                       显示帮助。
  --force              强制覆盖已经存在的目标。
  --fake               模拟一个假的操作。
  --watch, -w                      监听改变并执行镜像操作。
  --remove             删除目标上的外部的文件。

示例： 将一个本地文件夹minio镜像到https://play.min.io上的’mybucket’存储桶。

[root@hadoop001 minio]# mc mirror ../minio/ play/mybucket

示例： 持续监听本地文件夹修改并镜像到https://play.min.io上的’mybucket’存储桶。

[root@hadoop001 minio]# mc mirror -w ../minio/ play/mybucket

12 .find命令 - 查找文件和对象

find命令通过指定参数查找文件，它只列出满足条件的数据。

用法：
  mc find PATH [FLAGS]

FLAGS:
  --help, -h                       显示帮助。
  --exec value                     为每个匹配对象生成一个外部进程（请参阅FORMAT）
  --name value                     查找匹配通配符模式的对象。
  ...
  ...

示例： 持续从s3存储桶中查找所有jpeg图像，并复制到minio "play/bucket"存储桶

[root@hadoop001 minio]# mc find s3/bucket --name "*.jpg" --watch --exec "mc cp {} play/bucket"

13.diff命令 - 显示差异

diff命令计算两个目录之间的差异。它只列出缺少的或者大小不同的内容。

它不比较内容，所以可能的是，名称相同，大小相同但内容不同的对象没有被检测到。这样，它可以在不同站点或者大量数据的情况下快速比较。

用法：
  mc diff [FLAGS] FIRST SECOND

FLAGS:
  --help, -h                       显示帮助。

示例： 比较一个本地文件夹和一个远程对象存储服务

[root@hadoop001 minio]# mc diff localdir play/mybucket

14. watch命令 - 监听文件和对象存储事件。

watch命令提供了一种方便监听对象存储和文件系统上不同类型事件的方式。

用法：
  mc watch [FLAGS] PATH

FLAGS:
  --events value                   过滤不同类型的事件，默认是所有类型的事件 (默认： "put,delete,get")
  --prefix value                   基于前缀过滤事件。
  --suffix value                   基于后缀过滤事件。
  --recursive                      递归方式监听事件。
  --help, -h                       显示帮助。

示例： 监听对象存储的所有事件

[root@hadoop001 minio]# mc watch s3/aaaa

示例： 监听本地文件夹的所有事件

[root@hadoop001 minio]# mc watch ~/Photos

15. events命令 - 管理存储桶事件通知。

events提供了一种方便的配置存储桶的各种类型事件通知的方式。MinIO事件通知可以配置成使用 AMQP，Redis，ElasticSearch，NATS和PostgreSQL服务。MinIO configuration提供了如何配置的更多细节。

用法：
  mc events COMMAND [COMMAND FLAGS | -h] [ARGUMENTS...]

COMMANDS:
  add     添加一个新的存储桶通知。
  remove  删除一个存储桶通知。使用'--force'可以删除所有存储桶通知。
  list    列出存储桶通知。

FLAGS:
  --help, -h                       显示帮助。

示例： 列出所有存储桶通知。

mc events list play/andoria

示例： 添加一个新的’sqs’通知，仅接收ObjectCreated事件。

mc events add play/andoria arn:minio:sqs:us-east-1:1:your-queue --events put

示例： 添加一个带有过滤器的’sqs’通知。

给sqs通知添加prefix和suffix过滤规则。

mc events add play/andoria arn:minio:sqs:us-east-1:1:your-queue --prefix photos/ --suffix .jpg

示例： 删除一个’sqs’通知

mc events remove play/andoria arn:minio:sqs:us-east-1:1:your-queue

16. policy命令 - 管理存储桶策略

管理匿名访问存储桶和其内部内容的策略。

用法：
  mc policy [FLAGS] PERMISSION TARGET
  mc policy [FLAGS] TARGET
  mc policy list [FLAGS] TARGET

PERMISSION:
  Allowed policies are: [none, download, upload, public].

FLAGS:
  --help, -h                       显示帮助。

示例： 显示当前匿名存储桶策略

显示当前mybucket/myphotos/2020/子文件夹的匿名策略。

mc policy play/mybucket/myphotos/2020/
Access permission for ‘play/mybucket/myphotos/2020/’ is ‘none’

示例：设置可下载的匿名存储桶策略。

设置mybucket/myphotos/2020/子文件夹可匿名下载的策略。现在，这个文件夹下的对象可被公开访问。比如：mybucket/myphotos/2020/yourobjectname可通过这个URL https://play.min.io/mybucket/myphotos/2020/yourobjectname访问。

mc policy set download play/mybucket/myphotos/2020/
Access permission for ‘play/mybucket/myphotos/2020/’ is set to 'download'

示例：删除当前的匿名存储桶策略

删除所有mybucket/myphotos/2020/这个子文件夹下的匿名存储桶策略。

mc policy set none play/mybucket/myphotos/2020/
Access permission for ‘play/mybucket/myphotos/2020/’ is set to 'none'

17. config命令 - 管理配置文件

config host命令提供了一个方便地管理~/.mc/config.json配置文件中的主机信息的方式，你也可以用文本编辑器手动修改这个配置文件。

用法：
  mc config host COMMAND [COMMAND FLAGS | -h] [ARGUMENTS...]

COMMANDS:
  add, a      添加一个新的主机到配置文件。
  remove, rm  从配置文件中删除一个主机。
  list, ls    列出配置文件中的主机。

FLAGS:
  --help, -h                       显示帮助。

示例： 管理配置文件

添加MinIO服务的access和secret key到配置文件，注意，shell的history特性可能会记录这些信息，从而带来安全隐患。在bash shell,使用set -o和set +o来关闭和开启history特性。

set +o history
mc config host add myminio http://localhost:9000 OMQAGGOL63D7UNVQFY8X GcY5RHNmnEWvD/1QxD3spEIGj+Vt9L7eHaAaBTkJ
set -o history

18. update命令 - 软件更新

从https://dl.min.io检查软件更新。Experimental标志会检查unstable实验性的版本，通常用作测试用途。

用法：
  mc update [FLAGS]

FLAGS:
  --quiet, -q  关闭控制台输出。
  --json       使用JSON格式输出。
  --help, -h   显示帮助。

示例： 检查更新

mc update
You are already running the most recent version of ‘mc’.

19. version命令 - 显示版本信息

显示当前安装的mc版本。

用法：
  mc version [FLAGS]

FLAGS:
  --quiet, -q  关闭控制台输出。
  --json       使用JSON格式输出。
  --help, -h   显示帮助。

示例： 输出mc版本。

mc version
Version: 2016-04-01T00:22:11Z
Release-tag: RELEASE.2016-04-01T00-22-11Z
Commit-id: 12adf3be326f5b6610cdd1438f72dfd861597fce