分布式檔案存儲系統MinIO：介紹、安裝與Spring Boot內建使用

摘要：本文将詳細介紹分布式檔案存儲系統MinIO，包括其概述、安裝步驟以及如何将其內建到Spring Boot應用中。

目錄：

1. MinIO簡介
2. 安裝MinIO
3. 內建Spring Boot
4. 示例：使用MinIO進行檔案上傳和下載下傳

1. MinIO簡介

MinIO是一個高性能、分布式對象存儲系統，它相容Amazon S3的API。MinIO被設計為輕量、易于部署和擴充。這使得它成為開發人員、企業和服務提供商的理想選擇。MinIO的主要特點如下：

• 高性能：MinIO可以輕松處理大量資料，具有高吞吐量和低延遲。
• 分布式：MinIO支援跨多個節點的分布式存儲，提供了資料備援和高可用性。
• S3相容：MinIO相容Amazon S3的API，可以無縫地與現有的S3應用程式內建。
• 開源：MinIO是完全開源的，可以自由地使用和修改。

2. 安裝MinIO

安裝MinIO非常簡單，隻需按照下面的步驟操作：

1. 下載下傳MinIO伺服器二進制檔案：通路MinIO官方下載下傳頁面并選擇适合您作業系統的版本。将下載下傳的檔案儲存到一個合适的位置。
2. 為MinIO建立一個資料目錄，例如：/data。
3. 為MinIO設定通路密鑰和密鑰。您可以通過設定環境變量MINIO_ACCESS_KEY和MINIO_SECRET_KEY來實作。

export MINIO_ACCESS_KEY=myaccesskey
export MINIO_SECRET_KEY=mysecretkey           

1. 啟動MinIO伺服器：

./minio server /data           

1. MinIO伺服器現在應該已經在端口9000上運作。您可以通過通路http://localhost:9000來通路MinIO的Web界面。

3. 內建Spring Boot

為了在Spring Boot應用中使用MinIO，我們需要添加MinIO的Java用戶端庫。打開項目的pom.xml檔案，并添加以下依賴：

<dependency>
    <groupId>io.minio</groupId>
    <artifactId>minio</artifactId>
    <version>8.3.6</version>
</dependency>
           

接下來，在Spring Boot應用中建立一個MinioConfig類，用于配置MinIO用戶端：

@Configuration
public class MinioConfig {

    @Value("${minio.access-key}")
    private String accessKey;

    @Value("${minio.secret-key}")
    private String secretKey;

    @Value("${minio.url}")
    private String url;

    @Bean
    public MinioClient minioClient() {
        try {
            return MinioClient.builder().endpoint(url).credentials(accessKey, secretKey).build();
        } catch (Exception e) {
            throw new RuntimeException("Failed to create MinIO client", e);
        }
    }
}
           

在`application.properties`檔案中添加MinIO的配置資訊：
minio.url=http://localhost:9000
minio.access-key=myaccesskey
minio.secret-key=mysecretkey
           

4. 示例：使用MinIO進行檔案上傳和下載下傳

接下來，我們将建立一個簡單的Spring Boot應用，用于示範如何使用MinIO進行檔案的上傳和下載下傳。

首先，建立一個FileController類：

@RestController
@RequestMapping("/files")
public class FileController {

    @Autowired
    private MinioClient minioClient;

    @Value("${minio.bucket}")
    private String bucketName;

    @PostMapping("/upload")
    public String uploadFile(@RequestParam("file") MultipartFile file) {
        try {
            // 檢查存儲桶是否存在，如果不存在則建立一個
            if (!minioClient.bucketExists(BucketExistsArgs.builder().bucket(bucketName).build())) {
                minioClient.makeBucket(MakeBucketArgs.builder().bucket(bucketName).build());
            }

            // 上傳檔案
            String objectName = file.getOriginalFilename();
            minioClient.putObject(
                    PutObjectArgs.builder().bucket(bucketName).object(objectName).stream(
                            file.getInputStream(), file.getSize(), -1)
                            .contentType(file.getContentType())
                            .build());

            return "File uploaded successfully";
        } catch (Exception e) {
            throw new RuntimeException("Failed to upload file", e);
        }
    }

    @GetMapping("/download/{fileName}")
    public ResponseEntity<ByteArrayResource> downloadFile(@PathVariable("fileName") String fileName) {
        try {
            // 擷取檔案
            GetObjectResponse response = minioClient.getObject(GetObjectArgs.builder()
                    .bucket(bucketName)
                    .object(fileName)
                    .build());

            // 将檔案内容讀取到位元組數組資源中
            ByteArrayResource resource = new ByteArrayResource(response.readAllBytes());

            // 傳回檔案内容作為響應
            return ResponseEntity.ok()
                    .contentType(MediaType.parseMediaType(response.contentType()))
                    .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + fileName + "\"")
                    .body(resource);
        } catch (Exception e) {
            throw new RuntimeException("Failed to download file", e);
        }
    }
}
           

在application.properties檔案中添加存儲桶的名稱：

minio.bucket=mybucket
           

現在，您可以運作Spring Boot應用并使用/files/upload和/files/download/{fileName}接口分别上傳和下載下傳檔案。

本文詳細介紹了分布式檔案存儲系統MinIO，包括其概述、安裝步驟以及如何将其內建到Spring Boot應用中。通過這些步驟，您可以輕松地在自己的應用中使用MinIO進行檔案存儲和管理。