使用 .NET 集成 MinIO 实现高效对象存储

最新推荐文章于 2024-07-06 16:55:34 发布

雨太阳呀呀

最新推荐文章于 2024-07-06 16:55:34 发布

阅读量679

点赞数 18

分类专栏： C# ELK .Net Core MinIo 文章标签： .net .netcore c#

本文链接：https://blog.csdn.net/weixin_39842602/article/details/139578769

版权

C# ELK 同时被 3 个专栏收录

2 篇文章 0 订阅

订阅专栏

.Net Core

1 篇文章 0 订阅

订阅专栏

MinIo

1 篇文章 0 订阅

订阅专栏

引言

在现代软件开发中，存储和管理大量的非结构化数据（如图片、视频和文档）变得越来越重要。对象存储解决方案如 Amazon S3 已成为主流，但其高昂的成本和对公有云的依赖使得很多开发者寻求开源和自托管的替代方案。MinIO 作为一款高性能的开源对象存储系统，以其兼容 S3 API 和卓越的性能表现，成为了理想的选择。本文将介绍如何在 .NET 应用程序中集成和使用 MinIO 进行对象存储操作。

1. MinIO 简介

MinIO 是一个高性能的对象存储服务器，兼容 Amazon S3 API。它使用 Golang 编写，提供卓越的性能和水平扩展能力，支持 Kubernetes 和 Docker 的部署，非常适合企业级大规模存储需求。

2. 安装和配置 MinIO 客户端库

在开始使用 MinIO 之前，我们需要在 .NET 项目中安装 MinIO 客户端库。可以通过 NuGet 包管理器来安装：

dotnet add package Minio

或者在项目文件（.csproj）中添加以下依赖项：

<PackageReference Include="Minio" Version="4.0.8" />

3. 在 .NET 应用中使用 MinIO

安装完成后，我们可以开始在 .NET 应用程序中配置和使用 MinIO 客户端。

4. 示例代码详解

以下示例代码展示了如何在 .NET 应用程序中进行基本的对象存储操作，如创建 bucket、上传文件、下载文件和删除文件。

using Minio;
using Minio.DataModel;
using System;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // MinIO 配置
        var endpoint = "play.min.io"; // MinIO 服务器地址
        var accessKey = "YOUR-ACCESSKEYID"; // 访问密钥
        var secretKey = "YOUR-SECRETACCESSKEY"; // 密钥
        var bucketName = "my-bucket";
        var objectName = "my-object";
        var filePath = "path/to/your/file";
        var downloadFilePath = "path/to/your/downloaded/file";

        // 初始化 MinIO 客户端
        var minioClient = new MinioClient()
                            .WithEndpoint(endpoint)
                            .WithCredentials(accessKey, secretKey)
                            .Build();

        try
        {
            // 检查 bucket 是否存在
            bool found = await minioClient.BucketExistsAsync(new BucketExistsArgs().WithBucket(bucketName));
            if (!found)
            {
                // 创建 bucket
                await minioClient.MakeBucketAsync(new MakeBucketArgs().WithBucket(bucketName));
                Console.WriteLine($"Bucket '{bucketName}' 创建成功。");
            }

            // 上传文件
            await minioClient.PutObjectAsync(new PutObjectArgs()
                                              .WithBucket(bucketName)
                                              .WithObject(objectName)
                                              .WithFileName(filePath));
            Console.WriteLine($"文件 '{filePath}' 上传到 bucket '{bucketName}' 中，文件名为 '{objectName}'。");

            // 下载文件
            await minioClient.GetObjectAsync(new GetObjectArgs()
                                              .WithBucket(bucketName)
                                              .WithObject(objectName)
                                              .WithFile(downloadFilePath));
            Console.WriteLine($"文件 '{objectName}' 从 bucket '{bucketName}' 下载到 '{downloadFilePath}'。");

            // 删除文件
            await minioClient.RemoveObjectAsync(new RemoveObjectArgs()
                                                .WithBucket(bucketName)
                                                .WithObject(objectName));
            Console.WriteLine($"文件 '{objectName}' 从 bucket '{bucketName}' 中删除。");
        }
        catch (MinioException e)
        {
            Console.WriteLine($"MinIO 操作失败: {e.Message}");
        }
    }
}

代码解析

初始化 MinIO 客户端：配置 MinIO 服务器地址和访问凭证。

   var minioClient = new MinioClient()
                       .WithEndpoint(endpoint)
                       .WithCredentials(accessKey, secretKey)
                       .Build();

检查 bucket 是否存在：如果不存在，则创建新的 bucket。

   bool found = await minioClient.BucketExistsAsync(new BucketExistsArgs().WithBucket(bucketName));
   if (!found)
   {
       await minioClient.MakeBucketAsync(new MakeBucketArgs().WithBucket(bucketName));
       Console.WriteLine($"Bucket '{bucketName}' 创建成功。");
   }

上传文件：将本地文件上传到指定的 bucket 中。

  await minioClient.PutObjectAsync(new PutObjectArgs()
                                    .WithBucket(bucketName)
                                    .WithObject(objectName)
                                    .WithFileName(filePath));
  Console.WriteLine($"文件 '{filePath}' 上传到 bucket '{bucketName}' 中，文件名为 '{objectName}'。");

下载文件：从指定的 bucket 中下载文件到本地。

  await minioClient.GetObjectAsync(new GetObjectArgs()
                                    .WithBucket(bucketName)
                                    .WithObject(objectName)
                                    .WithFile(downloadFilePath));
  Console.WriteLine($"文件 '{objectName}' 从 bucket '{bucketName}' 下载到 '{downloadFilePath}'。");

删除文件：从指定的 bucket 中删除文件。

  await minioClient.RemoveObjectAsync(new RemoveObjectArgs()
                                      .WithBucket(bucketName)
                                      .WithObject(objectName));
  Console.WriteLine($"文件 '{objectName}' 从 bucket '{bucketName}' 中删除。");