## 变更记录
| 产品版本 | 更新内容 | 更新日期 |
| :------- | -------- | -------------- |
| V6.0.1 | 初始版本 | 2023年10月28日 |
## 1特性介绍
### 1.1背景
什么是MinIO？，Minio是一个开源的对象存储服务器，供一种简单、高性能、可扩展的对象存储服务，类似于Amazon S3（Simple Storage Service），支持客户自己的基础设施上部署，将数据安全存储在自己的服务器上，而无需依赖大型云提供商，在开源社区得到广泛认可，越来越多的公司采用MinIO构建私有对象存储服务，详细信息请参考官网https://www.minio.org.cn/
### 1.2特性价值
V6.0版本文件存储支持支持把文件存储在MinIO服务上，并作为一个标准产品能力提供一种新的文件存储方式，为客户提供更多可选的文件存储服务，提高客户文件存储服务的自主可选择性，覆盖更多的客户需求场景。
## 2.文件存储使用MinIO配置说明
标准产品提供了实现类kd.bos.filestorage.minio.MinIOStorage，客户使用MinIO服务时只需在MC中配置附件和图片参数时指定为该实现类即可。
### 2.1基于MinIO的附件存储集群配置项
使用MinIO存储服务的在MC配置项说明及示例值如下，注意配置项
| 属性 | 值 | 备注 |
| -------------------------------------- | ------------------------------------- | ------------------------------- |
| attachmentServer.bucket | bucket1 | 桶名，MinIO服务先创建作为根目录 |
| attachmentServer.accessKey | KC600VZLQU55WY9O4J31 | MinIO的 accessKey |
| attachmentServer.secretKey | oU8dnn1IOCxRDNHpqdNoH9rQlGxLegNzbh0p | MinIO的 secretKey |
| attachmentServer.upload.timeout | 600 | 上传超时时间，默认600秒 |
| attachmentServer.fileStorage.className | kd.bos.filestorage.minio.MinIOStorage | MinIO实现类 |
| attachmentServer.url | http://xxx.xxx.xxx.xxx:port | MinIO服务器API URL |
### 2.2基于MinIO的图片存储集群配置项
使用MinIO存储服务的在MC配置项说明及示例值如下，注意配置项;
| 属性 | 值 | 备注 |
| --------------------------------- | ---------------------------------------- | ------------------------------- |
| imageServer.bucket | bucket1 | 桶名，MinIO服务先创建作为根目录 |
| imageServer.accessKey | KC600VZLQU55WY9O4J31 | MinIO的 accessKey值 |
| imageServer.secretKey | oU8dnn1IOCxRDNHpqdNoH9rQlGxLegoPFyNzbh0p | MinIO的 secretKey值 |
| imageServer.upload.timeout | 600 | 上传超时时间，默认600秒 |
| imageServer.fileStorage.className | kd.bos.filestorage.minio.MinIOStorage | 文件存储MinIO实现类 |
| imageServer.url | http://xxx.xxx.xxx.xxx:port | MinIO服务器API URL |
### 2.3MinIO参数对应的值来源说明
1. 桶名，通过MinIO自带的WEB控制台手动创建桶，文件存储不会自动创建桶，如果不手动先创建好会报异常无法上传文件
2. AccessKey和secretKey值，通过MinIO自带的WEB控制台【Access Keys】菜单进入，如下图新建 Access Key，或者之前创建后保存过值。注意：MinIO的Access Keys创建后为了安全性不支持查看SecretKey值。
3. MinIO服务器API 地址【ip:port】
- MinIO单机模式，ip=MinIO服务所在主机IP，port=【默认9000，非默认为启动参数--address:port 指定的端口】
- 集群模式，集群模式是需要通过Nginx配置MinIO服务实例集群代理，则ip=Nginx主机IP，port=为Nginx代理监听端口
### 2.4发布配置
在MC配置完毕，保存并发布配置使配置生效。
## 3.开发使用说明
确保MC中正确配置MinIO相关参数后，通过文件服务API即可与MinIO服务交互进行文件上传、下载等操作。请参考文件服务API文档 https://dev.kingdee.com/open/detail/sdk/1565335164299511808
## 4.MinIO服务端License说明
注意：MinIO服务端在2021.5.11之前的license为商业友好的Apache license V2.0，2021.5.11 license变更为GPL V3.0商业使用有较严格限制
