日期：2024年 10月 12日

標籤： MinIO Asp.NET Core Windows Forms Docker Ubuntu

摘要：C# 學習筆記

第一部分：MinIO 簡介

Step 1： MinIO 介紹

官網首次登入頁面時，會看到以下內容：

The MinIO Enterprise Object Store:
Built for AI Data Infrastructure

The MinIO Enterprise Object Store is built for production environments where everything matters - performance, security,
scale and manageability. Cloud-native by design, it is ideal for large scale AI/ML infrastructure, modern data lakes and data lakehouses and
database workloads. It is software-defined and runs on any cloud - private, public, colo or edge.

大意是說：MinIO 企業級物件儲存專為生產環境設計，強調性能、安全性、擴展性和管理性。它是雲原生的。 適合大規模 AI/ML 基礎設施、現代數據湖和數據倉庫，並且能在任何雲端環境運行，包括私有雲、公共雲、托管中心和邊緣計算。
※雲原生：專為雲端運算環境設計和最佳化的應用程式和服務架構方式

Step 2：優點、缺點

優點如官網簡述，這邊延伸補充：

MinIO 也仍具有以下缺點：

Step 3：進階收費方式

基本的用戶都是免費的，有需要用到更進階的服務 MinIO 也有提供，如果 MinIO 會用到 200 TB ~ 1 PB 屬於企業輕量版
1 PB 以上則是企業加強版， 1TB 收費 240/月美金

服務級別協議 (Service-Level Agreement, SLA)
供應商向客戶承諾的服務水準之外包和技術廠商合約：

Step 4：如何評估引入使用

如果有出現以下多種狀況，就可以考慮引入了：
如果都沒下述需求符合，網路芳鄰或路由器上設置共享硬碟就是很適合的方案了。

第二部分：架設 MinIO & 基本配置

Step 1：執行 Docker 安裝 & 說明

先確保本機已經安裝 Docker ，然後輸入以下指令，快速建立 MinIO 容器

docker run -p 9005:9005 -p 9011:9011 --name minio -e "MINIO_ROOT_USER=yourrootuser" -e "MINIO_ROOT_PASSWORD=yourrootpassword" minio/minio server /data --address ":9005" --console-address ":9011"

其中，每段重要的參數意思如下：
※ 9000 也是 MinIO 預設 Port 號，因為 9000 很容易被其他容器占用，建議使用別種 Port 號，避免衝突

安裝過程：

Step 2：訪問 WebUI

安裝完成後，連線到自己的 IP 網址，我這邊使用的是內部伺服器，因此訪問：

http:\\192.168.51.188:9011

並且輸入 Step 1. 建立的帳號密碼

Step 3：設定存取金鑰 - 1

為了要能上傳下載 & 檔案，需要先建立金鑰
左側選擇 Accsee Key -> 右側選擇 Create Access Key

Step 4：設定存取金鑰 - 2

打開後， MinIO 會創建隨機帳號、密碼，這時只要選擇 Expire Date (過期時間)，然後建立

Step 5：設定存取金鑰 - 完成

建立後，系統會顯示明文的帳號、密碼，可以先複製貼上
後續上傳、下載都要靠這個帳號跟密碼

Step 6：建立存儲 Bucket - 1

為了要能上傳下載 & 檔案，還需要建立存儲 (Bucket)，才能保存檔案
左側選擇 Bucket -> 右側選擇 Create Bucket

Step 7：建立存儲 Bucket - 2

打開後，輸入名稱，這邊為了示意，輸入 my-bucket，然後建立

Step 8：建立存儲 Bucket - 完成

最後可以看到 Bucket 的資訊

第三部分：上傳檔案到 MinIO - DEMO

Step 1：專案簡要說明

範例檔案：本篇範例代碼，開啟專案後，會有以下內容

Step 2：上傳介面 - 選擇檔案 1

執行程式後，選擇 選擇檔案 按鈕

Step 3：上傳介面 - 選擇檔案 2

選擇一個自己的本機檔案

Step 4：上傳介面 - 執行上傳

選擇後會出現路徑，然後選擇 檔案上傳 按鈕

Step 5：上傳介面 - 上傳完成

成功的話會提示如下：

Step 6：檢查檔案

到 MinIo Server 後可以看到剛剛上傳的檔案結果

Step 7：上傳代碼說明 - 瀏覽檔案

瀏覽檔案的部分，當用戶點擊按鈕時，會觸發 ShowDialog()，若成功存取則保存用戶選擇路徑

/// <summary>
/// [Button] 瀏覽檔案
/// </summary>        
private void button_browse_Click(object sender, EventArgs e)
{
    using (OpenFileDialog openFileDialog = new OpenFileDialog())
    {
        openFileDialog.InitialDirectory = "c:\\";
        openFileDialog.Filter = "All files (*.*)|*.*";
        openFileDialog.FilterIndex = 1;
        openFileDialog.RestoreDirectory = true;
        if (openFileDialog.ShowDialog() == DialogResult.OK)
        {
            // 獲取選取的檔案路徑
            textBox_filepath.Text = openFileDialog.FileName;
        }
    }
}

Step 8：上傳代碼說明 - 檔案上傳

檔案上傳的部分，當用戶點擊按鈕時，會先檢查 Bucket 是否存在，如果不存在會跳錯
成功的話可以順利上傳到 Server
※目前 MinIo 已變為創建者模式建立實例，如果使用 HTTPS，才需要創建 .WithSSL()

/// <summary>
/// [Button] 執行上傳
/// </summary>        
private void button_uploadFile_Click(object sender, EventArgs e)
{
    _ = Task.Run(() => Working());
    
    async Task Working()
    {
        try
        {
            // 使用建造者模式初始化 MinioClient
            var minio = new MinioClient()
                                .WithEndpoint(_url, _port)
                                .WithCredentials(_accessKey, _secretKey)
                                //.WithSSL() // 使用 HTTPS，才需要開啟這行
                                .Build();
            // 檢查 Bucket 是否存在                    
            var bucketExistsArgs = new BucketExistsArgs().WithBucket(_bucketName);
            bool bucketExists = await minio.BucketExistsAsync(bucketExistsArgs);
            if (!bucketExists)
            {
                var makeBucketArgs = new MakeBucketArgs().WithBucket(_bucketName);
                await minio.MakeBucketAsync(makeBucketArgs);
                Console.WriteLine($"Bucket '{_bucketName}' created successfully.");
            }
            else
            {
                Console.WriteLine($"Bucket '{_bucketName}' already exists.");
            }
            // 上傳一個檔案
            string filePath = textBox_filepath.Text;
            string objectName = Path.GetFileName(filePath);
            using (var fileStream = new FileStream(filePath, FileMode.Open))
            {
                var putObjectArgs = new PutObjectArgs()
                                    .WithBucket(_bucketName)
                                    .WithObject(objectName)
                                    .WithStreamData(fileStream)
                                    .WithObjectSize(fileStream.Length)
                                    .WithContentType("text/plain");
                await minio.PutObjectAsync(putObjectArgs);
                await ShowMessageAsync("上傳成功!");
            }
        }
        catch (MinioException e)
        {
            Console.WriteLine($"MinIO Exception: {e}");
        }
        catch (Exception e)
        {
            Console.WriteLine($"Exception: {e}");
        }
    }
}

第四部分：下載檔案從 MinIO - DEMO

Step 1：MinIO 已存在檔案

為了說明下載，已先將 MinIO Server 上放了 test.txt 檔案

Step 2：下載介面 - 選擇資料夾1

執行程式後，選擇 存放路徑 按鈕

Step 3：下載介面 - 選擇資料夾2

選擇一個自己的本機資料夾

Step 4：下載介面 - 執行下載

選擇後會出現路徑，然後選擇 下載檔案 按鈕

Step 5：下載介面 - 下載完成

成功的話會提示如下：

Step 6：檢查檔案

到本機剛剛選擇的資料夾後，可以看到剛剛下載的檔案

Step 7：下載代碼說明 - 存放路徑

存放路徑的部分，當用戶點擊按鈕時，會觸發 ShowDialog()，選擇用戶本機的路徑。

/// <summary>
/// [Button] 下載檔案-選擇存放資料夾
/// </summary>        
private void button_downloadPath_Click(object sender, EventArgs e)
{
    using (FolderBrowserDialog folderBrowserDialog = new FolderBrowserDialog())
    {
        folderBrowserDialog.Description = "選擇下載檔案的資料夾";
        folderBrowserDialog.ShowNewFolderButton = true; // 是否允許建立新資料夾

        if (folderBrowserDialog.ShowDialog() == DialogResult.OK)
        {
            // 獲取選取的資料夾路徑
            string selectedFolderPath = folderBrowserDialog.SelectedPath;
            textBox_downloadPathFile.Text = selectedFolderPath; // 在文本框中顯示選取的資料夾路徑 
        }
    }
}

Step 8：下載代碼說明 - 下載檔案

下載檔案的部分，當用戶點擊按鈕時，會直接從 MinIO 連線，並且下載 Bucket 內對應的檔案 (test.txt)

/// <summary>
/// [Button] 下載檔案
/// </summary>  
private void button_download_Click(object sender, EventArgs e)
{
    _ = Task.Run(() => Working());

    async Task Working()
    {

        try
        {
            // 使用建造者模式初始化 MinioClient
            var minio = new MinioClient()
                                .WithEndpoint(_url, _port)
                                .WithCredentials(_accessKey, _secretKey)
                                .Build();

            // 下載檔案，取得名稱
            string objectName = "test.txt";

            // 下載該檔案
            string downloadFilePath = textBox_downloadPathFile.Text + "\\" + objectName;
            var getObjectArgs = new GetObjectArgs()
                                .WithBucket(_bucketName)
                                .WithObject(objectName)
                                .WithFile(downloadFilePath);                    
            await minio.GetObjectAsync(getObjectArgs);
            await ShowMessageAsync($@"下載成功! 檔案路徑:{downloadFilePath}");

        }
        catch (MinioException e)
        {
            Console.WriteLine($"MinIO Exception: {e}");
        }
        catch (Exception e)
        {
            Console.WriteLine($"Exception: {e}");
        }
    }
}