对象存储

对象存储是 Sealos 内置的对象存储服务，主要用于存储和管理非结构化数据。

目前对象存储具备以下功能：

上传文件到存储桶；
从存储桶下载文件；
公开存储桶的访问权限；
使用 SDK 访问存储桶；
监控存储桶资源指标；
静态托管。

快速开始

打开 Sealos 桌面，点击对象存储。

上传文件

点击创建存储桶。

输入存储桶的名字，设置存储桶的权限。

存储桶权限说明：

private：私有桶，不开放访问；
publicRead：共享存储桶，开放公共读功能；
publicReadwrite：共享存储桶，开放公共读写功能。

存储桶创建成功。

上传文件。

上传文件成功。

公开存储桶的访问权限

点击编辑。

设置存储桶权限为 publicRead，点击应用。

复制文件链接。

粘贴到浏览器地址栏访问文件。

查看访问密钥配置

对象存储用户由唯一的 Access Key（用户名）和对应的 Secret Key（密码）组成。Internal 为对象存储的内部访问地址，External 为对象存储的外部访问地址。

使用 SDK 访问存储桶

SDK 访问存储桶需要三个参数：AccessKey、SecretKey、Endpoint。参数都在访问密钥中，Internal 是内网地址 Endpoint，External 是外网地址 Endpoint。如果需要使用 Region 参数，默认使用 us-east-1。

Go Client SDK

详细文档参考：https://min.io/docs/minio/linux/developers/go/API.html

例子：使用 Go Client SDK 上传 style.css 文件到 sv3dd7u4-test 存储桶，将 Endpoint 设置为外网地址 External。如果服务部署在当前 K8s 集群内，可以将 Endpoint 改为内网地址 Internal。

package main

import (
    "context"
    "fmt"
    "log"
    "os"
)
import "github.com/minio/minio-go/v7"
import "github.com/minio/minio-go/v7/pkg/credentials"

func main() {
    endpoint := "objectstorageapi.xxx.xxx.xxx"
    accessKey := "xxxxxxxx"
    secretKey := "xxxxxxxxxxxxxxxx"
    // init minio client
    minioClient, err := minio.New(endpoint, &minio.Options{
        Creds: credentials.NewStaticV4(accessKey, secretKey, ""),
    })
    if err != nil {
        log.Fatalln(err)
    }
    // get local file
    file, err := os.Open("./style.css")
    if err != nil {
        fmt.Println(err)
        return
    }
    defer file.Close()

    fileStat, err := file.Stat()
    if err != nil {
        fmt.Println(err)
        return
    }
    // put object
    uploadInfo, err := minioClient.PutObject(context.Background(), "sv3dd7u4-test", "style.css", file, fileStat.Size(), minio.PutObjectOptions{ContentType: "text/css"})
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Println("Successfully uploaded bytes: ", uploadInfo)
}

文件上传成功。

Java Client SDK

详细文档参考：https://min.io/docs/minio/linux/developers/java/API.html

例子：使用 Java Client SDK 上传 style1.css 文件到 sv3dd7u4-test 存储桶，将 Endpoint 设置为外网地址 External。如果服务部署在当前 K8s 集群内，可以将 Endpoint 改为内网地址 Internal。

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

package org.example;

import io.minio.MinioClient;
import io.minio.UploadObjectArgs;

public class FileUploader {
    public static void main(String[] args) throws Exception {

        MinioClient minioClient =
                MinioClient.builder()
                        .endpoint("https://objectstorageapi.xxx.xxx.xxx")
                        .credentials("xxxxxxxx", "xxxxxxxxxxxxxxxx")
                        .build();


        minioClient.uploadObject(
                UploadObjectArgs.builder()
                        .bucket("sv3dd7u4-test")
                        .object("style1.css")
                        .filename("src/main/java/org/example/style1.css")
                        .build());

        System.out.println("Successfully uploaded bytes.");
    }
}