Penyimpanan File: S3 (Pro)

Pengenalan

Berdasarkan plugin manajemen file, kini ditambahkan dukungan untuk jenis penyimpanan file yang kompatibel dengan protokol S3. Layanan penyimpanan objek apa pun yang mendukung protokol S3 dapat diintegrasikan dengan mudah, seperti Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO, Cloudflare R2, dan lainnya, sehingga semakin meningkatkan kompatibilitas dan fleksibilitas layanan penyimpanan.

Fitur Utama

Unggah melalui klien: Proses pengunggahan file tidak perlu melalui server NocoBase, tetapi langsung terhubung ke layanan penyimpanan file, sehingga memberikan pengalaman unggah yang lebih efisien dan cepat.
Akses privat: Saat mengakses file, semua URL merupakan alamat otorisasi sementara yang telah ditandatangani, sehingga menjamin keamanan dan ketepatan waktu akses file.

Skenario Penggunaan

Manajemen tabel file: Mengelola dan menyimpan semua file yang diunggah secara terpusat, mendukung berbagai jenis file dan metode penyimpanan, serta memudahkan pengelompokan dan pencarian file.
Penyimpanan kolom lampiran: Digunakan untuk menyimpan data lampiran yang diunggah dalam formulir atau catatan, serta mendukung keterkaitan dengan catatan data tertentu.

Konfigurasi Plugin

Mengaktifkan plugin plugin-file-storage-s3-pro
Klik "Setting-> FileManager" untuk masuk ke pengaturan manajemen file
Klik tombol "Add new", lalu pilih "S3 Pro"

Setelah panel pop-up muncul, Anda akan melihat bahwa terdapat banyak formulir yang perlu diisi. Anda dapat merujuk ke dokumentasi berikutnya untuk memperoleh informasi parameter layanan file yang sesuai, lalu mengisinya dengan benar ke dalam formulir.

Konfigurasi Penyedia Layanan

Amazon S3

Pembuatan Bucket

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

Isi Bucket Name (nama bucket), biarkan kolom lainnya menggunakan pengaturan default, gulir ke bagian bawah halaman, lalu 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 gulir ke bawah untuk menemukan bagian konfigurasi CORS

Masukkan konfigurasi berikut (konfigurasi dapat disesuaikan lebih lanjut), lalu simpan

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

Mendapatkan AccessKey dan SecretAccessKey

Klik tombol "Security credentials" di sudut kanan atas halaman

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

Klik setuju (contoh ini menggunakan akun utama; untuk lingkungan produksi, disarankan menggunakan IAM).

Simpan Access key dan Secret access key yang ditampilkan di halaman

Mendapatkan dan Mengonfigurasi Parameter

AccessKey ID dan AccessKey Secret adalah nilai yang diperoleh pada langkah sebelumnya. Isi dengan tepat
Masuk ke panel properties pada halaman detail bucket. Di sana Anda dapat memperoleh informasi Bucket dan Region (wilayah).

Akses publik (opsional)

Konfigurasi ini tidak wajib. Lakukan konfigurasi ini jika Anda ingin membuat file yang diunggah sepenuhnya dapat diakses publik

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

Gulir ke Block public access, klik edit, lalu atur agar kontrol ACLs diizinkan

C centang Public access di NocoBase

Konfigurasi Thumbnail (opsional)

Konfigurasi ini bersifat opsional dan digunakan saat perlu mengoptimalkan ukuran atau kualitas pratinjau gambar. Harap diperhatikan bahwa solusi penerapan ini dapat menimbulkan biaya tambahan. Untuk informasi biaya selengkapnya, lihat ketentuan terkait dari AWS.

Akses Dynamic Image Transformation for Amazon CloudFront.
Klik tombol Launch in the AWS Console di bagian bawah halaman untuk mulai menerapkan solusi.
Selesaikan konfigurasi sesuai petunjuk. Beberapa opsi berikut perlu mendapat perhatian khusus:
1. Saat membuat stack, Anda perlu menentukan nama bucket Amazon S3 yang berisi gambar sumber. Isi dengan nama bucket yang telah dibuat sebelumnya.
2. Jika Anda memilih untuk menerapkan UI demo, setelah penerapan selesai Anda dapat menguji fungsi pemrosesan gambar melalui antarmuka tersebut. Di konsol AWS CloudFormation, pilih stack Anda, buka tab “Output”, temukan nilai yang terkait dengan kunci DemoUrl, lalu klik tautan tersebut untuk membuka antarmuka demo.
3. S solusi ini menggunakan pustaka sharp Node.js untuk memproses gambar secara efisien. Anda dapat mengunduh kode sumber dari repositori GitHub dan menyesuaikannya sesuai kebutuhan.
Setelah konfigurasi selesai, tunggu hingga status penerapan berubah menjadi CREATE_COMPLETE.
Dalam konfigurasi NocoBase, perhatikan hal-hal berikut:
1. Thumbnail rule: Isi parameter terkait pemrosesan gambar, misalnya ?width=100. Lihat dokumentasi AWS untuk detailnya.
2. Access endpoint: Isi nilai Outputs -> ApiEndpoint setelah penerapan.
3. Full access URL style: Centang Ignore (karena nama bucket telah diisi saat konfigurasi, sehingga tidak perlu lagi saat mengakses).

Contoh Konfigurasi