Storage Engine: S3 (Pro)

Penyimpanan File: S3 (Pro)Professional Edition+

Pengantar

Berbasis plugin File Manager, ditambahkan dukungan untuk tipe penyimpanan file yang kompatibel dengan protokol S3. Layanan object storage manapun yang mendukung protokol S3 dapat dengan mudah diintegrasikan, contoh Amazon S3, Aliyun OSS, Tencent COS, MinIO, Cloudflare R2, dan lainnya, sehingga lebih meningkatkan kompatibilitas dan fleksibilitas layanan storage.

Fitur

Upload dari client: proses upload file tidak perlu melewati server NocoBase, langsung terhubung ke layanan storage file, mewujudkan pengalaman upload yang lebih efisien dan cepat.
Akses privat: saat mengakses file, semua URL adalah alamat otorisasi sementara yang sudah ditandatangani, memastikan keamanan dan validitas akses file.

Skenario Penggunaan

Manajemen Tabel File: mengelola dan menyimpan secara terpusat semua file yang diunggah, mendukung berbagai tipe file dan cara penyimpanan, memudahkan klasifikasi dan pencarian file.
Penyimpanan Field Lampiran: digunakan untuk menyimpan data lampiran yang diunggah pada form atau record, mendukung asosiasi dengan record data spesifik.

Konfigurasi Plugin

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

Setelah panel muncul, Anda akan melihat banyak isian form yang perlu diisi. Anda dapat merujuk ke dokumentasi berikutnya untuk mendapatkan informasi parameter dari layanan file yang sesuai, dan mengisinya dengan benar pada form.

Konfigurasi Penyedia Layanan

Amazon S3

Pembuatan 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, field lainnya dapat dibiarkan default. Scroll ke bawah halaman, klik tombol "Create" untuk menyelesaikan pembuatan.

Konfigurasi CORS

Masuk ke daftar buckets, cari 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 konfigurasi lebih detail), lalu simpan

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

Mendapatkan AccessKey, SecretAccessKey

Klik tombol "Security credentials" di pojok kanan atas halaman

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

Klik setuju (di sini menggunakan akun utama untuk demonstrasi, untuk lingkungan produksi disarankan menggunakan IAM).

Simpan Access key dan Secret access key yang ditampilkan pada halaman

Mendapatkan dan Mengkonfigurasi Parameter

AccessKey ID dan AccessKey Secret adalah nilai yang Anda dapatkan pada langkah sebelumnya, harap isi dengan akurat
Masuk ke panel properties pada halaman detail bucket, Anda dapat memperoleh informasi nama Bucket dan Region (region).

Akses Publik (Opsional)

Ini adalah konfigurasi yang tidak wajib. Konfigurasikan saat Anda perlu membuat file yang diunggah benar-benar publik

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

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

Centang Public access di NocoBase

Konfigurasi Thumbnail (Opsional)

Konfigurasi ini opsional, digunakan untuk mengoptimalkan ukuran atau efek pratinjau gambar. Perhatian, solusi deployment ini mungkin menimbulkan biaya tambahan, untuk biaya spesifik silakan merujuk ke ketentuan AWS.

Akses Dynamic Image Transformation for Amazon CloudFront.
Klik tombol Launch in the AWS Console di bagian bawah halaman untuk memulai deployment solusi.
Ikuti petunjuk untuk menyelesaikan konfigurasi. Beberapa opsi berikut perlu diperhatikan:
1. Saat membuat stack, Anda perlu menentukan nama bucket Amazon S3 yang berisi gambar sumber. Harap isi nama bucket yang Anda buat sebelumnya.
2. Jika Anda memilih untuk men-deploy demo UI, setelah deployment selesai Anda dapat menguji fitur image processing melalui antarmuka tersebut. Pada AWS CloudFormation Console, pilih stack Anda, masuk ke tab "Outputs", cari nilai key DemoUrl, klik link tersebut untuk membuka antarmuka demo.
3. Solusi ini menggunakan library sharp Node.js untuk memproses gambar secara efisien. Anda dapat mengunduh source code dari repository GitHub dan melakukan kustomisasi sesuai kebutuhan.
Setelah konfigurasi selesai, tunggu hingga status deployment menjadi CREATE_COMPLETE.
Pada konfigurasi NocoBase, ada beberapa hal yang perlu diperhatikan:
1. Thumbnail rule: isi parameter image processing, contoh ?width=100. Untuk detail lihat dokumentasi AWS.
2. Access endpoint: isi nilai dari Outputs -> ApiEndpoint setelah deployment.
3. Full access URL style: perlu dicentang Ignore (karena nama bucket sudah diisi pada konfigurasi, sehingga tidak diperlukan lagi saat akses).

Contoh Konfigurasi