Storage engine: S3 (Pro)

Lưu trữ tệp: S3 (Pro)Professional Edition+

Giới thiệu

Trên cơ sở plugin File Manager, bổ sung hỗ trợ loại lưu trữ file tương thích giao thức S3. Bất kỳ dịch vụ Object Storage nào hỗ trợ giao thức S3 đều có thể tích hợp dễ dàng, ví dụ Amazon S3, Aliyun OSS, Tencent COS, MinIO, Cloudflare R2, v.v., nâng cao thêm tính tương thích và linh hoạt của dịch vụ lưu trữ.

Tính năng nổi bật

Upload từ client: Quá trình upload file không cần thông qua server NocoBase, kết nối trực tiếp với dịch vụ lưu trữ file, mang lại trải nghiệm upload hiệu quả và nhanh chóng hơn.
Truy cập riêng tư: Khi truy cập file, tất cả URL đều là địa chỉ ủy quyền tạm thời có chữ ký, đảm bảo tính bảo mật và thời hạn của truy cập file.

Tình huống sử dụng

Quản lý bảng file: Quản lý và lưu trữ tập trung tất cả các file đã upload, hỗ trợ nhiều loại file và phương thức lưu trữ, thuận tiện cho việc phân loại và tìm kiếm file.
Lưu trữ field attachment: Dùng để lưu trữ dữ liệu file đính kèm upload trong form hoặc bản ghi, hỗ trợ liên kết với bản ghi dữ liệu cụ thể.

Cấu hình plugin

Bật plugin plugin-file-storage-s3-pro
Click "Setting-> FileManager" để vào File Manager Settings
Click nút "Add new", chọn "S3 Pro"

Sau khi popup xuất hiện, bạn sẽ thấy có khá nhiều nội dung form cần điền. Có thể tham khảo tài liệu sau để lấy thông tin tham số liên quan của dịch vụ file tương ứng và điền chính xác vào form.

Cấu hình nhà cung cấp

Amazon S3

Tạo Bucket

Mở https://ap-southeast-1.console.aws.amazon.com/s3/home để vào S3 Console
Click nút "Create bucket" bên phải

Điền Bucket Name, các field khác có thể giữ mặc định, cuộn xuống cuối trang, click nút "Create" để hoàn tất tạo.

Cấu hình CORS

Vào danh sách buckets, tìm và click vào Bucket vừa tạo để vào trang chi tiết

Click tab "Permission", sau đó cuộn xuống tìm phần cấu hình CORS

Điền cấu hình sau (có thể tự tinh chỉnh cấu hình) và lưu

[
    {
        "AllowedHeaders": [
            "*"
        ],
        "AllowedMethods": [
            "POST",
            "PUT"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": [
            "ETag"
        ],
        "MaxAgeSeconds": 3000
    }
]

Lấy AccessKey, SecretAccessKey

Click nút "Security credentials" góc trên bên phải

Cuộn xuống, tìm phần "Access Keys", click nút "Create Access Key".

Click Đồng ý (ở đây minh họa với tài khoản chính, khuyến nghị sử dụng IAM trong môi trường chính thức).

Lưu Access key và Secret access key hiển thị trong trang

Lấy và cấu hình tham số

AccessKey ID và AccessKey Secret là các giá trị bạn đã lấy được trong thao tác trên, hãy điền chính xác
Vào panel properties của trang chi tiết bucket, bạn có thể lấy được thông tin tên Bucket và Region.

Truy cập công khai (Tùy chọn)

Đây là cấu hình không bắt buộc, khi bạn cần để file upload hoàn toàn công khai thì cấu hình

Vào panel Permissions, cuộn xuống đến Object Ownership, click chỉnh sửa, bật ACLs

Cuộn đến Block public access, click chỉnh sửa, đặt thành cho phép ACLs điều khiển

Trong NocoBase tích chọn Public access

Cấu hình thumbnail (Tùy chọn)

Cấu hình này là tùy chọn, áp dụng khi cần tối ưu kích thước hoặc hiệu ứng preview hình ảnh. Lưu ý, phương án triển khai này có thể phát sinh chi phí bổ sung, chi phí cụ thể vui lòng tham khảo các điều khoản liên quan của AWS.

Truy cập Dynamic Image Transformation for Amazon CloudFront.
Click nút Launch in the AWS Console ở cuối trang để bắt đầu triển khai phương án.
Theo hướng dẫn để hoàn tất cấu hình, một số tùy chọn sau cần đặc biệt lưu ý:
1. Khi tạo stack, bạn cần chỉ định tên Bucket Amazon S3 chứa hình ảnh nguồn. Vui lòng điền tên Bucket bạn đã tạo trước đó.
2. Nếu bạn đã chọn triển khai Demo UI, sau khi triển khai hoàn tất có thể test tính năng xử lý hình ảnh thông qua giao diện này. Trong AWS CloudFormation Console, chọn stack của bạn, vào tab "Outputs", tìm giá trị tương ứng với key DemoUrl, click vào liên kết đó để mở giao diện demo.
3. Phương án này sử dụng thư viện Node.js sharp để xử lý hình ảnh hiệu quả. Bạn có thể tải mã nguồn từ GitHub repository và tùy chỉnh theo nhu cầu.
Sau khi cấu hình hoàn tất, chờ trạng thái triển khai chuyển sang CREATE_COMPLETE là được.
Trong cấu hình NocoBase, có một số lưu ý sau:
1. Thumbnail rule: Điền tham số liên quan đến xử lý hình ảnh, ví dụ ?width=100. Cụ thể có thể tham khảo Tài liệu AWS.
2. Access endpoint: Điền giá trị ApiEndpoint trong Outputs sau khi triển khai.
3. Full access URL style: Cần tích chọn Ignore (vì khi cấu hình đã điền tên Bucket, khi truy cập không cần nữa).

Ví dụ cấu hình