#Dosya Depolama: S3 (Pro)

#Giriş

Dosya yönetimi eklentisinin üzerine inşa edilen bu sürüm, S3 protokolüyle uyumlu dosya depolama türleri için destek ekler. Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO, Cloudflare R2 gibi S3 protokolünü destekleyen herhangi bir nesne depolama hizmeti kolayca entegre edilebilir. Bu sayede depolama hizmetlerinin uyumluluğu ve esnekliği daha da artırılmıştır.

#Özellikler

1. İstemci Yüklemesi: Dosya yükleme süreci NocoBase sunucusu üzerinden geçmez; doğrudan dosya depolama hizmetine bağlanır. Bu, daha verimli ve hızlı bir yükleme deneyimi sağlar.

2. Özel Erişim: Dosyalara erişirken, tüm URL'ler imzalı geçici yetkilendirme adresleridir. Bu, dosya erişiminin güvenliğini ve süreli olmasını garanti eder.

#Kullanım Senaryoları

1. Dosya Koleksiyonu Yönetimi: Yüklenen tüm dosyaları merkezi olarak yönetin ve depolayın. Çeşitli dosya türlerini ve depolama yöntemlerini destekleyerek dosyaların kolayca sınıflandırılmasını ve aranmasını sağlar.

2. Ek Alanı Depolama: Formlar veya kayıtlar aracılığıyla yüklenen eklerin veri depolaması için kullanılır ve belirli veri kayıtlarıyla ilişkilendirmeyi destekler.

#Eklenti Yapılandırması

1. plugin-file-storage-s3-pro eklentisini etkinleştirin.

2. Dosya yönetimi ayarlarına erişmek için "Ayarlar -> Dosya Yöneticisi" yolunu izleyin.

3. "Yeni ekle" düğmesine tıklayın ve "S3 Pro"yu seçin.

4. Açılan pencerede doldurmanız gereken ayrıntılı bir form göreceksiniz. Dosya hizmetiniz için ilgili parametre bilgilerini almak ve bunları forma doğru bir şekilde girmek için aşağıdaki belgelere başvurabilirsiniz.

#Hizmet Sağlayıcı Yapılandırması

#Amazon S3

#Bucket Oluşturma

1. Amazon S3 Konsolu'na erişmek için https://ap-southeast-1.console.aws.amazon.com/s3/home adresini ziyaret edin.

2. Sağ taraftaki "Create bucket" (Bucket oluştur) düğmesine tıklayın.

3. Bucket Adı'nı (depolama kovası adı) doldurun, diğer alanları varsayılan olarak bırakın, sayfanın en altına kaydırın ve işlemi tamamlamak için "Create" (Oluştur) düğmesine tıklayın.

#CORS Yapılandırması

1. Bucket listesinde, yeni oluşturduğunuz bucket'ı bulun ve ayrıntılarına erişmek için tıklayın.

2. "Permission" (İzinler) sekmesine gidin ve CORS yapılandırma bölümüne ilerleyin.

3. Aşağıdaki yapılandırmayı girin (ihtiyaca göre özelleştirebilirsiniz) ve kaydedin.

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

#AccessKey ve SecretAccessKey Alma

1. Sayfanın sağ üst köşesindeki "Security credentials" (Güvenlik kimlik bilgileri) düğmesine tıklayın.

2. Aşağı kaydırın, "Access Keys" (Erişim Anahtarları) bölümünü bulun ve "Create Access Key" (Erişim Anahtarı Oluştur) düğmesine tıklayın.

3. Şartları kabul edin (üretim ortamlarında IAM kullanımı önerilir).

4. Görüntülenen Access Key (Erişim Anahtarı) ve Secret Access Key'i (Gizli Erişim Anahtarı) kaydedin.

#Parametre Alma ve Yapılandırma

1. AccessKey ID ve AccessKey Secret, önceki adımda aldığınız değerlerdir; lütfen bunları doğru bir şekilde girin.

2. Bucket'ın özellikler paneline gidin; burada Bucket Adı ve Bölge (Region) bilgilerini bulabilirsiniz.

#Genel Erişim (İsteğe Bağlı)

Bu isteğe bağlı bir yapılandırmadır. Yüklenen dosyaları tamamen herkese açık hale getirmeniz gerektiğinde bu ayarı yapın.

1. İzinler (Permissions) paneline gidin, "Object Ownership" (Nesne Sahipliği) bölümüne ilerleyin, "Edit" (Düzenle) düğmesine tıklayın ve ACL'leri etkinleştirin.

2. "Block public access" (Genel erişimi engelle) bölümüne ilerleyin, "Edit" (Düzenle) düğmesine tıklayın ve ACL kontrolüne izin verecek şekilde ayarlayın.

3. NocoBase'de "Public access" (Genel erişim) seçeneğini işaretleyin.

#Küçük Resim Yapılandırması (İsteğe Bağlı)

Bu yapılandırma isteğe bağlıdır ve yalnızca görüntü önizleme boyutunu veya efektini optimize etmeniz gerektiğinde kullanılmalıdır. Lütfen dikkat, bu dağıtım ek maliyetlere neden olabilir. Daha fazla ayrıntı için AWS'nin ilgili hüküm ve koşullarına başvurun.

1. Amazon CloudFront için Dinamik Görüntü Dönüşümü sayfasını ziyaret edin.

2. Dağıtımı başlatmak için sayfanın altındaki Launch in the AWS Console (AWS Konsolunda Başlat) düğmesine tıklayın.

3. Yapılandırmayı tamamlamak için talimatları izleyin. Aşağıdaki seçeneklere özellikle dikkat etmeniz gerekmektedir:

   1. Yığını oluştururken, kaynak görüntüleri içeren Amazon S3 bucket adını belirtmeniz gerekecektir. Lütfen daha önce oluşturduğunuz bucket adını girin.
   2. Demo kullanıcı arayüzünü dağıtmayı seçtiyseniz, dağıtım tamamlandıktan sonra görüntü işleme işlevselliğini test etmek için bu arayüzü kullanabilirsiniz. AWS CloudFormation konsolunda yığınızı seçin, "Outputs" (Çıktılar) sekmesine gidin, DemoUrl anahtarına karşılık gelen değeri bulun ve demo arayüzünü açmak için bağlantıya tıklayın.
   3. Bu çözüm, görüntüleri verimli bir şekilde işlemek için sharp Node.js kütüphanesini kullanır. Kaynak kodunu GitHub deposundan indirebilir ve ihtiyacınıza göre özelleştirebilirsiniz.

4. Yapılandırma tamamlandıktan sonra, dağıtım durumunun CREATE_COMPLETE olarak değişmesini bekleyin.

5. NocoBase yapılandırmasında aşağıdaki noktalara dikkat edin:

   1. Thumbnail rule (Küçük resim kuralı): ?width=100 gibi görüntü işleme parametrelerini girin. Ayrıntılar için AWS belgelerine başvurabilirsiniz.
   2. Access endpoint (Erişim uç noktası): Dağıtım sonrası Çıktılar (Outputs) -> ApiEndpoint değerini girin.
   3. Full access URL style (Tam erişim URL stili): Yoksay (Ignore) seçeneğini işaretlemeniz gerekmektedir (çünkü bucket adı yapılandırma sırasında zaten doldurulmuştur, erişim sırasında tekrar gerekmez).

#Yapılandırma Örneği

#Alibaba Cloud OSS

#Bucket Oluşturma

1. OSS Konsolu'nu açmak için https://oss.console.aliyun.com/overview adresini ziyaret edin.

2. Sol menüden "Buckets" (Kovalar) seçeneğini belirleyin ve ardından bir depolama kovası oluşturmaya başlamak için "Create Bucket" (Kova Oluştur) düğmesine tıklayın.

3. Bucket ayrıntılarını doldurun ve son olarak "Create" (Oluştur) düğmesine tıklayın.
   1. Bucket Adı: İş ihtiyaçlarınıza uygun bir ad seçin.
   2. Bölge (Region): Kullanıcılarınıza en yakın bölgeyi seçin.
   3. Diğer ayarlar varsayılan olarak kalabilir veya ihtiyacınıza göre özelleştirilebilir.

#CORS Yapılandırması

1. Bir önceki adımda oluşturduğunuz bucket'ın ayrıntılar sayfasına gidin.

2. Orta menüden "Content Security" (İçerik Güvenliği) -> "CORS" seçeneğine tıklayın.

3. "Create Rule" (Kural Oluştur) düğmesine tıklayın, ilgili alanları doldurun, aşağı kaydırın ve "OK" (Tamam) düğmesine tıklayın. Aşağıdaki ekran görüntüsüne başvurabilir veya daha ayrıntılı ayarlar yapabilirsiniz.

#AccessKey ve SecretAccessKey Alma

1. Sağ üst köşedeki hesap avatarınızın altındaki "AccessKey" seçeneğine tıklayın.

2. Bu bölümde, gösterim kolaylığı için ana hesap kullanılarak bir AccessKey oluşturulacaktır. Üretim ortamlarında RAM kullanarak AccessKey oluşturmanız önerilir. Talimatlar için Alibaba Cloud belgelerine başvurabilirsiniz.

3. "Create AccessKey" (AccessKey Oluştur) düğmesine tıklayın.

4. Hesap doğrulamasını tamamlayın.

5. Görüntülenen Access Key (Erişim Anahtarı) ve Secret Access Key'i (Gizli Erişim Anahtarı) kaydedin.

#Parametre Alma ve Yapılandırma

1. AccessKey ID ve AccessKey Secret, önceki adımda elde ettiğiniz değerlerdir.

2. Bucket adını almak için bucket ayrıntılar sayfasına gidin.

3. Bölgeyi (Region) almak için aşağı kaydırın (".aliyuncs.com" uzantısına gerek yoktur).

4. Uç nokta (endpoint) adresini alın ve NocoBase'e girerken https:// önekini eklemeniz gerektiğini unutmayın.

#Küçük Resim Yapılandırması (İsteğe Bağlı)

Bu yapılandırma isteğe bağlıdır ve yalnızca görüntü önizleme boyutunu veya efektini optimize etmeniz gerektiğinde kullanılmalıdır.

1. Thumbnail rule (Küçük resim kuralı) için ilgili parametreleri doldurun. Belirli parametre ayarları için Alibaba Cloud Görüntü İşleme belgelerine başvurabilirsiniz.

2. Full upload URL style (Tam yükleme URL stili) ve Full access URL style (Tam erişim URL stili) ayarlarını aynı tutun.

#Yapılandırma Örneği

#MinIO

#Bucket Oluşturma

1. Soldaki "Buckets" (Kovalar) menüsüne tıklayın -> Oluşturma sayfasına gitmek için "Create Bucket" (Kova Oluştur) düğmesine tıklayın.
2. Bucket adını girdikten sonra, "Kaydet" düğmesine tıklayın.

#AccessKey ve SecretAccessKey Alma

1. "Access Keys" (Erişim Anahtarları) bölümüne gidin -> Oluşturma sayfasına gitmek için "Create access key" (Erişim anahtarı oluştur) düğmesine tıklayın.

2. "Kaydet" düğmesine tıklayın.

3. Açılan penceredeki Access Key (Erişim Anahtarı) ve Secret Key'i (Gizli Anahtar) ilerideki yapılandırmalar için kaydedin.

#Parametre Yapılandırması

1. NocoBase'de "Dosya Yöneticisi" sayfasına gidin.

2. "Yeni ekle" düğmesine tıklayın ve "S3 Pro"yu seçin.

3. Formu doldurun:

   • AccessKey ID ve AccessKey Secret: Önceki adımda kaydettiğiniz değerleri kullanın.
   • Bölge (Region): Özel olarak dağıtılan MinIO'da bölge kavramı yoktur; bunu "auto" olarak ayarlayabilirsiniz.
   • Uç nokta (Endpoint): Dağıtılan hizmetinizin alan adını veya IP adresini girin.
   • Tam erişim URL stili (Full access URL style) ayarını "Path-Style" olarak yapmanız gerekmektedir.

#Yapılandırma Örneği

#Tencent COS

Yukarıdaki dosya hizmetlerinin yapılandırmalarına başvurabilirsiniz. Mantık benzerdir.

#Yapılandırma Örneği

#Cloudflare R2

Yukarıdaki dosya hizmetlerinin yapılandırmalarına başvurabilirsiniz. Mantık benzerdir.

#Yapılandırma Örneği

#Kullanıcı Rehberi

Dosya yöneticisi eklentisi belgelerine başvurabilirsiniz.