imhven
/
abp
mirror of https://github.com/abpframework/abp
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update blob document

Browse Source
pull/4787/head
liangshiwei 5 years ago
parent ca9b36046c
commit a9863a2a8f
5 changed files with 33 additions and 21 deletions
Show Stats Download Patch File Download Diff File

2
docs/en/Blob-Storing.md
Unescape View File

@ -19,6 +19,8 @@ The ABP Framework has already the following storage provider implementations;
* [File System](Blob-Storing-File-System.md): Stores BLOBs in a folder of the local file system, as standard files.
* [Database](Blob-Storing-Database.md): Stores BLOBs in a database.
* [Azure](Blob-Storing-Azure.md): Stores BLOBs on the [Azure BLOB storage](https://azure.microsoft.com/en-us/services/storage/blobs/).
* [Aliyun](Blob-Storing-Aliyun.md): Stores BLOBs on the [Aliyun Blob storage](https://help.aliyun.com/product/31815.html).
* [Ninio](Blob-Storing-Minio.md): Stores BLOBs on the [MinIO Object storage](https://min.io/).
More providers will be implemented by the time. You can [request](https://github.com/abpframework/abp/issues/new) it for your favorite provider or [create it yourself](Blob-Storing-Custom-Provider.md) and [contribute](Contribution/Index.md) to the ABP Framework.

4
docs/en/docs-nav.json
Unescape View File

@ -220,6 +220,10 @@
"text": "Aliyun Provider",
"path": "Blob-Storing-Aliyun.md"
},
{
"text": "Minio Provider",
"path": "Blob-Storing-Minio.md"
},
{
"text": "Create a Custom Provider",
"path": "Blob-Storing-Custom-Provider.md"

42
docs/zh-Hans/Blob-Storing-Minio.md
Unescape View File

@ -1,22 +1,22 @@
# BLOB Storing Minio 提供程序
BLOB Storing Minio提供程序帮助你存储对象到 [MinIO Object storage](https://min.io/)。
BLOB Storing Minio提供程序帮助你存储对象到 [MinIO Object storage](https://min.io/),
> 阅读[BLOB存储文档](Blob-Storing.md)了解如何使用BLOB存储系统。 本文档仅介绍如何为容器配置Minio提供程序。
> 阅读[BLOB存储文档](Blob-Storing.md)了解如何使用BLOB存储系统, 本文档仅介绍如何为容器配置Minio提供程序,
## 安装
使用 ABP CLI 来安装 [Volo.Abp.BlobStoring.Minio](https://www.nuget.org/packages/Volo.Abp.BlobStoring.Minio) NuGet 包到你的项目：
* 如果你没有安装ABP CLI，请先安装 [ABP CLI](https://docs.abp.io/en/abp/latest/CLI)。
* 在要添加 `Volo.Abp.BlobStoring.Minio` 包的 `.csproj` 文件目录打开命令行。
* 执行 `abp add-package Volo.Abp.BlobStoring.Minio` 命令。
* 如果你没有安装ABP CLI,请先安装 [ABP CLI](https://docs.abp.io/en/abp/latest/CLI),
* 在要添加 `Volo.Abp.BlobStoring.Minio` 包的 `.csproj` 文件目录打开命令行,
* 执行 `abp add-package Volo.Abp.BlobStoring.Minio` 命令,
如果你要手动安装, 通过NuGet安装 [Volo.Abp.BlobStoring.Minio](https://www.nuget.org/packages/Volo.Abp.BlobStoring.Minio) 到你的项目，然后添加 `[DependsOn(typeof(AbpBlobStoringMinioModule))]` 特性到你的 [ABP module](Module-Development-Basics.md) 类上。
如果你要手动安装, 通过NuGet安装 [Volo.Abp.BlobStoring.Minio](https://www.nuget.org/packages/Volo.Abp.BlobStoring.Minio) 到你的项目,然后添加 `[DependsOn(typeof(AbpBlobStoringMinioModule))]` 特性到你的 [ABP module](Module-Development-Basics.md) 类上,
## 配置
配置在你的[module](Module-Development-Basics.md)类中的`ConfigureServices`方法中完成。
配置在你的[module](Module-Development-Basics.md)类中的`ConfigureServices`方法中完成,
**例: 配置使用Minio存储**
@ -33,32 +33,32 @@ Configure<AbpBlobStoringOptions>(options =>
});
````
> 参阅[BLOB存储文档](Blob-Storing.md) 学习如何为指定容器配置提供程序。
> 参阅[BLOB存储文档](Blob-Storing.md) 学习如何为指定容器配置提供程序,
### 选项
* **EndPoint** (string): 你的Minio对象存储服务的URL。 查看文档：https://docs.min.io/docs/dotnet-client-quickstart-guide.html
* **AccessKey** (string): Access key是唯一标识你的账户的用户ID。
* **EndPoint** (string): 你的Minio对象存储服务的URL, 查看文档：https://docs.min.io/docs/dotnet-client-quickstart-guide.html
* **AccessKey** (string): Access key是唯一标识你的账户的用户ID,
* **SecretKey** (string): Access key是唯一标识你的账户的用户ID
* **BucketName** (string):你可以指定bucket名称。如果没有指定，将使用 `BlogContainerName` 属性定义的BLOB容器的名称(查阅[BLOB storing document](Blob-Storing.md))。MinIO完全兼容S3标准，所以有一些 **bucket命名规则**，必须符合[规则](https://docs.aws.amazon.com/AmazonS3/latest/dev/BucketRestrictions.html):
* **BucketName** (string):你可以指定bucket名称,如果没有指定,将使用 `BlogContainerName` 属性定义的BLOB容器的名称(查阅[BLOB storing document](Blob-Storing.md)),MinIO完全兼容S3标准,所以有一些 **bucket命名规则**,必须符合[规则](https://docs.aws.amazon.com/AmazonS3/latest/dev/BucketRestrictions.html):
* Bucket名字必须 **3** 到 **63** 字符长度.
* Bucket名字必须是 **小写** 的字母，数字，点号(.)， 横杠 (-)。
* Bucket名字必须是以数字和字母开头和结尾。
* Bucket名字不能是ip (例如, 192.168.5.4)。
* Bucket名字不能以 **xn--** 开头。 (2020年2月以后创建)。
* Bucket名字必须是 **小写** 的字母,数字,点号(.), 横杠 (-),
* Bucket名字必须是以数字和字母开头和结尾,
* Bucket名字不能是ip (例如, 192.168.5.4),
* Bucket名字不能以 **xn--** 开头, (2020年2月以后创建),
* Bucket名字必须区块唯一
* Buckets如果使用Amazon S3加速传输名字不能有点号(.)。
* **WithSSL** (bool): 默认 `false`，代表使用HTTPS。
* **CreateContainerIfNotExists** (bool): 默认 `false`，如果不存在bucket， `MinioBlobProvider` 将会创建一个。
* Buckets如果使用Amazon S3加速传输名字不能有点号(.),
* **WithSSL** (bool): 默认 `false`,代表使用HTTPS,
* **CreateContainerIfNotExists** (bool): 默认 `false`,如果不存在bucket, `MinioBlobProvider` 将会创建一个,
## Minio BLOB 名称计算器
默认情况下BLOB的全名由以下规则确定:
* 如果当前租户为 `null`(或容器禁用多租户 - 请参阅[BLOB存储文档](Blob-Storing.md) 了解如何禁用容器的多租户),则追加 `host` 字符串。
* 如果当前租户不为 `null`,则追加 `tenants/<tenant-id>` 字符串。
* 追加 BLOB 名称。
* 如果当前租户为 `null`(或容器禁用多租户 - 请参阅[BLOB存储文档](Blob-Storing.md) 了解如何禁用容器的多租户),则追加 `host` 字符串,
* 如果当前租户不为 `null`,则追加 `tenants/<tenant-id>` 字符串,
* 追加 BLOB 名称,
## 其他服务

2
docs/zh-Hans/Blob-Storing.md
Unescape View File

@ -19,6 +19,8 @@ ABP框架已经有以下存储提供程序的实现;
* [File System](Blob-Storing-File-System.md):将BLOB作为标准文件存储在本地文件系统的文件夹中.
* [Database](Blob-Storing-Database.md): 将BLOB存储在数据库中.
* [Azure](Blob-Storing-Azure.md): 将BLOG存储在 [Azure BLOB storage](https://azure.microsoft.com/en-us/services/storage/blobs/)中.
* [Aliyun](Blob-Storing-Aliyun.md): 将BLOB存储在[Aliyun Blob storage](https://help.aliyun.com/product/31815.html)中.
* [Ninio](Blob-Storing-Minio.md): 将BLOB存储在[MinIO Object storage](https://min.io/)中.
以后会实现更多的提供程序,你可以为自己喜欢的提供程序创建[请求](https://github.com/abpframework/abp/issues/new),或者你也可以[自己实现](Blob-Storing-Custom-Provider.md)它并[贡献](Contribution/Index.md)到ABP框架.

4
docs/zh-Hans/docs-nav.json
Unescape View File

@ -214,6 +214,10 @@
"text": "Aliyun提供程序",
"path": "Blob-Storing-Aliyun.md"
},
{
"text": "Minio提供程序",
"path": "Blob-Storing-Minio.md"
},
{
"text": "创建自定义提供程序",
"path": "Blob-Storing-Custom-Provider.md"

Write Preview
Loading…
Cancel
Save