#pkg: "@nocobase/plugin-file-storage-s3-pro"

#Penyimpanan Berkas: S3 (Pro)

#Pendahuluan

Berdasarkan plugin manajemen berkas, versi ini menambahkan dukungan untuk jenis penyimpanan berkas yang kompatibel dengan protokol S3. Setiap layanan penyimpanan objek yang mendukung protokol S3 dapat diintegrasikan dengan mudah, seperti Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO, Cloudflare R2, dan lainnya, sehingga meningkatkan kompatibilitas dan fleksibilitas layanan penyimpanan.

#Fitur

1. Unggah Klien: Proses unggah berkas tidak perlu melalui server NocoBase, melainkan langsung terhubung ke layanan penyimpanan berkas, sehingga memberikan pengalaman unggah yang lebih efisien dan cepat.
2. Akses Privat: Saat mengakses berkas, semua URL adalah alamat otorisasi sementara yang telah ditandatangani, memastikan keamanan dan validitas akses berkas.

#Skenario Penggunaan

1. Manajemen Tabel Berkas: Mengelola dan menyimpan semua berkas yang diunggah secara terpusat, mendukung berbagai jenis berkas dan metode penyimpanan untuk memudahkan klasifikasi dan pencarian berkas.
2. Penyimpanan Bidang Lampiran: Digunakan untuk menyimpan data lampiran yang diunggah melalui formulir atau catatan, mendukung keterkaitan dengan catatan data tertentu.

#Konfigurasi Plugin

1. Aktifkan plugin plugin-file-storage-s3-pro.
2. Buka "Setting -> FileManager" untuk mengakses pengaturan manajemen berkas.
3. Klik tombol "Add new" dan pilih "S3 Pro".

4. Setelah jendela pop-up muncul, Anda akan melihat banyak bidang formulir yang perlu diisi. Anda dapat merujuk ke dokumentasi selanjutnya untuk mendapatkan informasi parameter yang relevan untuk layanan berkas Anda dan mengisinya dengan benar ke dalam formulir.

#Konfigurasi Penyedia Layanan

#Amazon S3

#Pembuatan Bucket

1. Kunjungi Konsol Amazon S3.
2. Klik tombol "Create bucket" di sisi kanan.

3. Isi Bucket Name (Nama Bucket), biarkan bidang lain sebagai pengaturan bawaan, gulir ke bawah halaman, dan klik tombol "Create" untuk menyelesaikan proses.

#Konfigurasi CORS

1. Dalam daftar bucket, temukan dan klik bucket yang baru saja Anda buat untuk mengakses detailnya.

2. Buka tab "Permission" dan gulir ke bawah untuk menemukan bagian konfigurasi CORS.

3. Masukkan konfigurasi berikut (sesuaikan jika diperlukan) dan simpan.

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

#Pengambilan AccessKey dan SecretAccessKey

1. Klik tombol "Security credentials" di sudut kanan atas halaman.

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

3. Setujui persyaratan (penggunaan IAM direkomendasikan untuk lingkungan produksi).

4. Simpan Access Key dan Secret Access Key yang ditampilkan di halaman.

#Pengambilan dan Konfigurasi Parameter

1. AccessKey ID dan AccessKey Secret adalah nilai yang Anda dapatkan pada langkah sebelumnya. Harap isi dengan akurat.
2. Kunjungi panel properti bucket untuk menemukan Bucket Name (Nama Bucket) dan Region (Wilayah).

#Akses Publik (Opsional)

Ini adalah konfigurasi opsional. Konfigurasikan jika Anda perlu membuat berkas yang diunggah sepenuhnya publik.

1. Di panel Permissions, gulir ke "Object Ownership," klik "Edit," dan aktifkan ACLs.

2. Gulir ke "Block public access," klik "Edit," dan atur agar mengizinkan kontrol ACL.

3. Centang "Public access" di NocoBase.

#Konfigurasi Gambar Mini (Opsional)

Konfigurasi ini bersifat opsional dan digunakan saat Anda perlu mengoptimalkan ukuran atau efek pratinjau gambar. Harap diperhatikan, penerapan ini mungkin menimbulkan biaya tambahan. Untuk detail lebih lanjut, silakan merujuk pada syarat dan ketentuan AWS.

1. Kunjungi Dynamic Image Transformation for Amazon CloudFront.

2. Klik tombol Launch in the AWS Console di bagian bawah halaman untuk memulai penerapan.

3. Ikuti petunjuk untuk menyelesaikan konfigurasi. Beberapa opsi berikut memerlukan perhatian khusus:
   1. Saat membuat stack, Anda perlu menentukan nama bucket Amazon S3 yang berisi gambar sumber. Harap masukkan nama bucket yang Anda buat sebelumnya.
   2. Jika Anda memilih untuk menerapkan UI demo, setelah penerapan selesai, Anda dapat menggunakan antarmuka tersebut untuk menguji fungsionalitas pemrosesan gambar. Di konsol AWS CloudFormation, pilih stack Anda, buka tab "Outputs", temukan nilai yang sesuai dengan kunci DemoUrl, dan klik tautan tersebut untuk membuka antarmuka demo.
   3. Solusi ini menggunakan pustaka Node.js sharp untuk memproses gambar secara efisien. Anda dapat mengunduh kode sumber dari repositori GitHub dan menyesuaikannya sesuai kebutuhan.

4. Setelah konfigurasi selesai, tunggu hingga status penerapan berubah menjadi CREATE_COMPLETE.

5. Dalam konfigurasi NocoBase, ada beberapa hal yang perlu diperhatikan:

   1. Thumbnail rule: Isi parameter terkait pemrosesan gambar, seperti ?width=100. Untuk detailnya, silakan merujuk pada dokumentasi AWS.
   2. Access endpoint: Masukkan nilai dari Outputs -> ApiEndpoint setelah penerapan.
   3. Full access URL style: Perlu dicentang Ignore (karena nama bucket sudah diisi saat konfigurasi, sehingga tidak diperlukan lagi saat akses).

#Contoh Konfigurasi

#Alibaba Cloud OSS

#Pembuatan Bucket

1. Buka Konsol OSS.

2. Pilih "Buckets" dari menu kiri dan klik "Create Bucket" untuk mulai membuat bucket penyimpanan.

3. Isi detail bucket dan klik tombol "Create".
   1. Bucket Name: Pilih sesuai kebutuhan bisnis Anda.
   2. Region: Pilih wilayah terdekat untuk pengguna Anda.
   3. Pengaturan lain dapat dibiarkan default atau disesuaikan sesuai kebutuhan.

#Konfigurasi CORS

1. Buka halaman detail bucket yang baru saja Anda buat.

2. Klik "Content Security -> CORS" di menu tengah.

3. Klik tombol "Create Rule", lengkapi bidang-bidang yang relevan, gulir ke bawah, dan klik "OK". Anda dapat merujuk pada tangkapan layar di bawah ini atau melakukan pengaturan yang lebih detail.

#Pengambilan AccessKey dan SecretAccessKey

1. Klik "AccessKey" di bawah avatar akun Anda di sudut kanan atas.

2. Untuk tujuan demonstrasi, kami akan membuat AccessKey menggunakan akun utama. Dalam lingkungan produksi, disarankan untuk menggunakan RAM untuk membuat AccessKey. Untuk instruksi, silakan merujuk pada dokumentasi Alibaba Cloud.

3. Klik tombol "Create AccessKey".

4. Selesaikan verifikasi akun.

5. Simpan Access Key dan Secret Access Key yang ditampilkan di halaman.

#Pengambilan dan Konfigurasi Parameter

1. AccessKey ID dan AccessKey Secret adalah nilai yang diperoleh pada langkah sebelumnya.

2. Buka halaman detail bucket untuk mendapatkan nama Bucket.

3. Gulir ke bawah untuk mendapatkan Region (akhiran ".aliyuncs.com" tidak diperlukan).

4. Dapatkan alamat endpoint dan tambahkan prefiks https:// saat memasukkannya ke NocoBase.

#Konfigurasi Gambar Mini (Opsional)

Konfigurasi ini bersifat opsional dan hanya digunakan saat mengoptimalkan ukuran atau efek pratinjau gambar.

1. Isi parameter yang relevan untuk Thumbnail rule. Untuk pengaturan parameter spesifik, silakan merujuk pada dokumentasi Alibaba Cloud tentang Pemrosesan Gambar.

2. Biarkan pengaturan Full upload URL style dan Full access URL style tetap sama.

#Contoh Konfigurasi

#MinIO

#Pembuatan Bucket

1. Klik menu Buckets di sebelah kiri -> Klik Create Bucket untuk membuka halaman pembuatan.
2. Masukkan nama Bucket, lalu klik tombol Save.

#Pengambilan AccessKey dan SecretAccessKey

1. Buka Access Keys -> Klik tombol Create access key untuk membuka halaman pembuatan.

2. Klik tombol Save.

3. Simpan Access Key dan Secret Key dari jendela pop-up untuk konfigurasi selanjutnya.

#Konfigurasi Parameter

1. Buka halaman File manager di NocoBase.

2. Klik tombol Add new dan pilih S3 Pro.

3. Isi formulir:

   • AccessKey ID dan AccessKey Secret: Gunakan nilai yang disimpan dari langkah sebelumnya.
   • Region: MinIO yang diterapkan secara privat tidak memiliki konsep Region; Anda dapat mengaturnya ke "auto".
   • Endpoint: Masukkan nama domain atau alamat IP layanan yang Anda terapkan.
   • Atur Full access URL style ke Path-Style.

#Contoh Konfigurasi

#Tencent COS

Anda dapat merujuk pada konfigurasi untuk layanan berkas di atas. Logikanya serupa.

#Contoh Konfigurasi

#Cloudflare R2

Anda dapat merujuk pada konfigurasi untuk layanan berkas di atas. Logikanya serupa.

#Contoh Konfigurasi

#Panduan Pengguna

Silakan merujuk pada dokumentasi plugin file-manager.