minio 文件存储

关于 MinIO

MinIO 是一个基于 AGPL v3 开源协议的对象存储服务。它兼容亚马逊 S3 云存储服务接口,非常适合于存储大容量非结构化的数据,例如图片、视频、日志文件、备份数据和容器/虚拟机镜像等,而一个对象文件可以是任意大小,从几 kb 到最大 5T 不等。

生产验证

已在生产环境大规模使用,数据量达到 TB 级别,稳定可靠。

官方文档:https://docs.min.io/cn/

Docker 运行部署

生产环境配置

注意指定 access-key 和 secret-key,生产环境需要配置文件目录挂载以持久化数据。 以下版本为 MinIO 最后一个 Apache 2.0 协议版本,可以放心商用。

docker run -p 9000:9000 --name minio1 \
  -e "MINIO_ROOT_USER=lengleng" \
  -e "MINIO_ROOT_PASSWORD=lengleng" \
  registry.cn-hangzhou.aliyuncs.com/dockerhub_mirror/minio:RELEASE.2021-04-22T15-44-28Z server /data

访问验证

安装后使用浏览器访问 http://ip:9000,如果可以访问,则表示 MinIO 已经安装成功。

账号/密码为上边指定的 access-key 和 secret-key

创建 Bucket

创建存储空间

MinIO 创建 Bucket 界面

配置文件

在应用配置文件中添加 MinIO 信息:

直接在 Nacos 对应服务配置文件(如 pigx-upms-biz-dev.yml)中添加以下配置:

file:
  bucketName: s3demo # 上文创建的桶名称
  local:
    enable: false # 关闭本地存储(默认值)
  oss:
    enable: true # v4.4 开启 OSS 上传
    endpoint: http://IP:9000 # Minio API 端口
    access-key: lengleng # 上文配置的 access key
    secret-key: lengleng # 上文配置的 secret key

代码使用

添加文件系统依赖:

<!--文件系统-->
<dependency>
  <groupId>com.pig4cloud</groupId>
  <artifactId>pigx-common-oss</artifactId>
</dependency>

使用 FileTemplate 进行文件操作:

@Autowired
private FileTemplate template;

// 上传文件
template.putObject("s3demo", fileName, file.getInputStream());

FileTemplate 方法说明

方法名作用参数
createBucket创建 bucketbucketName: bucket 的名称
getAllBuckets获取所有的 bucket
getBucket根据 bucket 名称获取 bucketbucketName: bucket 的名称
removeBucket删除指定的 bucketbucketName: bucket 的名称
getAllObjectsByPrefix根据文件前缀查询文件bucketName: bucket 的名称
prefix: 文件前缀
recursive: 是否递归查询
getObjectURL获取文件的外链bucketName: bucket 的名称
objectName: 文件名称
expires: 过期时间(0-7 天)
getObject获取文件bucketName: bucket 的名称
objectName: 文件名称
putObject上传文件bucketName: bucket 的名称
objectName: 文件名称
stream: 文件流
size: 大小
contextType: 类型
getObjectInfo获取文件信息bucketName: bucket 的名称
objectName: 文件名称
removeObject删除文件bucketName: bucket 的名称
objectName: 文件名称
afterPropertiesSet初始化方法,在设置属性之后会被调用,用于创建 AmazonS3 实例