Penyimpanan File: S3 (Pro)

Pengantar

Berbasis plugin file management, menambahkan dukungan untuk tipe penyimpanan file yang kompatibel dengan protokol S3. Layanan object storage apa pun yang mendukung protokol S3 dapat dengan mudah diintegrasikan, contohnya Amazon S3, Aliyun OSS, Tencent COS, MinIO, Cloudflare R2, dan lainnya, lebih meningkatkan kompatibilitas dan fleksibilitas layanan penyimpanan.

Karakteristik Fitur

Upload Sisi Klien: Proses upload file tidak perlu melalui server NocoBase, langsung terhubung ke layanan penyimpanan file, mewujudkan pengalaman upload yang lebih efisien dan cepat.
Akses Privat: Saat mengakses file, semua URL adalah alamat otorisasi sementara yang sudah di-sign, memastikan keamanan dan ketepatan waktu akses file.

Skenario Penggunaan

Manajemen Collection File: Pengelolaan dan penyimpanan terpusat semua file yang diupload, mendukung berbagai tipe file dan cara penyimpanan, memudahkan klasifikasi dan pencarian file.
Penyimpanan Field Lampiran: Digunakan untuk penyimpanan data lampiran yang diupload dalam form atau record, mendukung relasi dengan record data tertentu.

Konfigurasi Plugin

Aktifkan plugin plugin-file-storage-s3-pro
Klik "Setting-> FileManager" untuk masuk ke pengaturan File Management
Klik tombol "Add new", pilih "S3 Pro"

Setelah floating layer muncul, Anda akan melihat banyak konten form yang perlu diisi. Anda dapat merujuk ke dokumentasi selanjutnya untuk mendapatkan informasi parameter terkait dari layanan file yang sesuai, dan mengisinya dengan benar ke form.

Konfigurasi Penyedia Layanan

Amazon S3

Membuat Bucket

Buka https://ap-southeast-1.console.aws.amazon.com/s3/home untuk masuk ke S3 Console
Klik tombol "Create bucket" di sebelah kanan

Isi Bucket Name (Nama Bucket), field lainnya dapat tetap default. Scroll ke bawah halaman, klik tombol "Create" untuk menyelesaikan pembuatan.

Konfigurasi CORS

Masuk ke daftar buckets, temukan dan klik Bucket yang baru saja dibuat untuk masuk ke halaman detailnya

Klik tab "Permission", lalu scroll ke bawah untuk menemukan bagian konfigurasi CORS

Isi konfigurasi berikut (Anda dapat menyesuaikan konfigurasinya), lalu simpan

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

Mendapatkan AccessKey, SecretAccessKey

Klik tombol "Security credentials" di sudut kanan atas halaman

Scroll ke bawah, temukan bagian "Access Keys", klik tombol "Create Access Key".

Klik setuju (di sini contoh dengan akun utama, disarankan untuk menggunakan IAM dalam environment formal).

Simpan Access key dan Secret access key yang ditampilkan di halaman

Mendapatkan Parameter dan Konfigurasi

AccessKey ID dan AccessKey Secret adalah nilai yang sesuai yang Anda dapatkan pada operasi sebelumnya. Harap isi dengan benar.
Masuk ke panel properties halaman detail bucket, Anda dapat mendapatkan informasi nama Bucket dan Region (region) di dalamnya.

Akses Publik (Opsional)

Ini bukan konfigurasi wajib. Saat Anda perlu membuat file upload sepenuhnya publik, lakukan konfigurasi

Masuk ke panel Permissions, scroll ke bawah ke Object Ownership, klik edit, aktifkan ACLs

Scroll ke Block public access, klik edit, atur untuk mengizinkan kontrol ACLs

Centang Public access di NocoBase

Konfigurasi Thumbnail (Opsional)

Konfigurasi ini opsional, digunakan untuk mengoptimalkan ukuran atau efek pratinjau gambar. Perhatikan, skema deployment ini mungkin menghasilkan biaya tambahan. Untuk biaya spesifik harap lihat ketentuan terkait AWS.

Akses Dynamic Image Transformation for Amazon CloudFront.
Klik tombol Launch in the AWS Console di bagian bawah halaman, untuk memulai deployment skema.
Selesaikan konfigurasi sesuai petunjuk. Beberapa opsi berikut perlu perhatian khusus:
1. Saat membuat stack, Anda perlu menentukan nama Bucket Amazon S3 yang berisi gambar sumber. Harap isi nama bucket yang sudah Anda buat sebelumnya.
2. Jika Anda memilih untuk men-deploy demo UI, setelah deployment selesai, Anda dapat menguji fungsi pemrosesan gambar melalui antarmuka tersebut. Di AWS CloudFormation Console, pilih stack Anda, masuk ke tab "Outputs", temukan nilai yang sesuai dengan kunci DemoUrl, klik link tersebut untuk membuka antarmuka demo.
3. Skema ini menggunakan library Node.js sharp untuk memproses gambar secara efisien. Anda dapat mengunduh source code dari repository GitHub, dan menyesuaikan sesuai kebutuhan.
Setelah konfigurasi selesai, tunggu hingga status deployment menjadi CREATE_COMPLETE.
Dalam konfigurasi NocoBase, ada beberapa hal yang perlu diperhatikan:
1. Thumbnail rule: Isi parameter terkait pemrosesan gambar, contohnya ?width=100. Untuk lebih spesifik, dapat merujuk ke dokumentasi AWS.
2. Access endpoint: Isi nilai Outputs -> ApiEndpoint setelah deployment.
3. Full access URL style: Perlu mencentang Ignore (karena saat konfigurasi sudah mengisi nama bucket, saat akses tidak perlu lagi).

Contoh Konfigurasi