#Przechowywanie plików: S3 (Pro)

#Wprowadzenie

W oparciu o wtyczkę do zarządzania plikami, ta wersja wprowadza obsługę typów przechowywania plików zgodnych z protokołem S3. Dowolna usługa przechowywania obiektów obsługująca protokół S3, taka jak Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO, Cloudflare R2 itp., może zostać łatwo zintegrowana, co dodatkowo zwiększa kompatybilność i elastyczność usług przechowywania.

#Funkcje

1. Przesyłanie po stronie klienta: Pliki są przesyłane bezpośrednio do usługi przechowywania, bez konieczności przechodzenia przez serwer NocoBase. Zapewnia to bardziej efektywne i szybsze przesyłanie.

2. Prywatny dostęp: Wszystkie adresy URL plików to podpisane, tymczasowe adresy autoryzacyjne, co gwarantuje bezpieczeństwo i ograniczony czasowo dostęp do plików.

#Scenariusze użycia

1. Zarządzanie kolekcją plików: Centralne zarządzanie i przechowywanie wszystkich przesłanych plików, z obsługą różnych typów plików i metod przechowywania, co ułatwia ich klasyfikację i wyszukiwanie.

2. Przechowywanie załączników w polach: Służy do przechowywania załączników przesyłanych za pośrednictwem formularzy lub rekordów, z możliwością powiązania ich z konkretnymi wpisami danych.

#Konfiguracja wtyczki

1. Włącz wtyczkę plugin-file-storage-s3-pro.

2. Przejdź do "Ustawienia -> FileManager", aby uzyskać dostęp do ustawień zarządzania plikami.

3. Kliknij przycisk "Dodaj nowy" i wybierz "S3 Pro".

4. W wyskakującym oknie zobaczy Pan/Pani szczegółowy formularz do wypełnienia. Proszę zapoznać się z poniższą dokumentacją, aby uzyskać odpowiednie parametry dla wybranej usługi plików i poprawnie wprowadzić je do formularza.

#Konfiguracja dostawcy usług

#Amazon S3

#Tworzenie Bucketa

1. Proszę odwiedzić konsolę Amazon S3.

2. Proszę kliknąć przycisk "Create bucket" po prawej stronie.

3. Proszę wypełnić pole Bucket Name (Nazwa Bucketa), pozostawić pozostałe pola jako domyślne, przewinąć na dół strony i kliknąć przycisk "Create", aby zakończyć proces.

#Konfiguracja CORS

1. Na liście bucketów proszę znaleźć i kliknąć nowo utworzony bucket, aby przejść do jego szczegółów.

2. Proszę przejść do zakładki "Permission" (Uprawnienia) i przewinąć w dół do sekcji konfiguracji CORS.

3. Proszę wprowadzić poniższą konfigurację (można ją dostosować według potrzeb) i zapisać.

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

#Pobieranie AccessKey i SecretAccessKey

1. Proszę kliknąć przycisk "Security credentials" (Poświadczenia bezpieczeństwa) w prawym górnym rogu strony.

2. Proszę przewinąć do sekcji "Access Keys" (Klucze dostępu) i kliknąć przycisk "Create Access Key" (Utwórz klucz dostępu).

3. Proszę zaakceptować warunki (zaleca się użycie IAM w środowiskach produkcyjnych).

4. Proszę zapisać wyświetlone klucze Access Key i Secret Access Key.

#Pobieranie i konfiguracja parametrów

1. AccessKey ID i AccessKey Secret to wartości uzyskane w poprzednim kroku. Proszę je dokładnie wprowadzić.

2. Proszę przejść do panelu właściwości szczegółów bucketa, gdzie znajdzie Pan/Pani nazwę Bucketa i informacje o Regionie.

#Dostęp publiczny (opcjonalnie)

Jest to konfiguracja opcjonalna. Proszę ją zastosować, jeśli chce Pan/Pani, aby przesłane pliki były całkowicie publiczne.

1. W panelu "Permissions" (Uprawnienia) proszę przewinąć do "Object Ownership" (Własność obiektów), kliknąć "Edit" (Edytuj) i włączyć ACLs.

2. Proszę przewinąć do "Block public access" (Blokuj dostęp publiczny), kliknąć "Edit" (Edytuj) i ustawić opcję zezwalającą na kontrolę ACL.

3. Proszę zaznaczyć "Public access" (Dostęp publiczny) w NocoBase.

#Konfiguracja miniatur (opcjonalnie)

Ta konfiguracja jest opcjonalna i powinna być używana, gdy chce Pan/Pani zoptymalizować rozmiar lub efekt podglądu obrazu. Proszę pamiętać, że to wdrożenie może wiązać się z dodatkowymi kosztami. Aby uzyskać więcej szczegółów, proszę zapoznać się z warunkami i cennikiem AWS.

1. Proszę odwiedzić stronę Dynamic Image Transformation for Amazon CloudFront.

2. Proszę kliknąć przycisk Launch in the AWS Console na dole strony, aby rozpocząć wdrożenie.

3. Proszę postępować zgodnie z instrukcjami, aby zakończyć konfigurację. Na następujące opcje należy zwrócić szczególną uwagę:
   1. Podczas tworzenia stosu należy określić nazwę bucketa Amazon S3, który zawiera obrazy źródłowe. Proszę wprowadzić nazwę bucketa utworzonego wcześniej.
   2. Jeśli zdecyduje się Pan/Pani na wdrożenie interfejsu użytkownika demonstracyjnego, po wdrożeniu będzie można go użyć do przetestowania funkcji przetwarzania obrazu. W konsoli AWS CloudFormation proszę wybrać swój stos, przejść do zakładki "Outputs" (Wyjścia), znaleźć wartość odpowiadającą kluczowi DemoUrl i kliknąć link, aby otworzyć interfejs demonstracyjny.
   3. To rozwiązanie wykorzystuje bibliotekę sharp Node.js do efektywnego przetwarzania obrazów. Może Pan/Pani pobrać kod źródłowy z repozytorium GitHub i dostosować go według potrzeb.

4. Po zakończeniu konfiguracji proszę poczekać, aż status wdrożenia zmieni się na CREATE_COMPLETE.

5. W konfiguracji NocoBase należy zwrócić uwagę na następujące kwestie:

   1. Thumbnail rule: Proszę wypełnić parametry przetwarzania obrazu, np. ?width=100. Szczegóły znajdzie Pan/Pani w dokumentacji AWS.
   2. Access endpoint: Proszę wprowadzić wartość z Outputs -> ApiEndpoint po wdrożeniu.
   3. Full access URL style: Należy wybrać Ignoruj (ponieważ nazwa bucketa została już podana w konfiguracji i nie jest potrzebna podczas dostępu).

#Przykład konfiguracji

#Alibaba Cloud OSS

#Tworzenie Bucketa

1. Proszę otworzyć konsolę OSS.

2. Proszę wybrać "Buckets" z lewego menu i kliknąć przycisk "Create Bucket" (Utwórz Bucket), aby rozpocząć tworzenie bucketa.

3. Proszę wypełnić szczegóły bucketa i kliknąć przycisk "Create" (Utwórz).

   • Bucket Name: Proszę wybrać nazwę odpowiadającą Pana/Pani potrzebom biznesowym.
   • Region: Proszę wybrać region najbliższy Pana/Pani użytkownikom.
   • Pozostałe ustawienia mogą pozostać domyślne lub zostać dostosowane według potrzeb.

#Konfiguracja CORS

1. Proszę przejść do strony szczegółów bucketa, który został utworzony w poprzednim kroku.

2. Proszę kliknąć "Content Security -> CORS" w środkowym menu.

3. Proszę kliknąć przycisk "Create Rule" (Utwórz regułę), wypełnić pola, przewinąć w dół i kliknąć "OK". Może Pan/Pani skorzystać z poniższego zrzutu ekranu lub skonfigurować bardziej szczegółowe ustawienia.

#Pobieranie AccessKey i SecretAccessKey

1. Proszę kliknąć "AccessKey" pod awatarem swojego konta w prawym górnym rogu.

2. W celach demonstracyjnych utworzymy AccessKey za pomocą konta głównego. W środowisku produkcyjnym zaleca się użycie RAM do utworzenia AccessKey. Instrukcje znajdzie Pan/Pani w dokumentacji Alibaba Cloud.

3. Proszę kliknąć przycisk "Create AccessKey" (Utwórz klucz dostępu).

4. Proszę przeprowadzić weryfikację konta.

5. Proszę zapisać wyświetlone klucze Access Key i Secret Access Key.

#Pobieranie i konfiguracja parametrów

1. AccessKey ID i AccessKey Secret to wartości uzyskane w poprzednim kroku.

2. Proszę przejść do strony szczegółów bucketa, aby uzyskać nazwę Bucketa.

3. Proszę przewinąć w dół, aby uzyskać Region (końcówka ".aliyuncs.com" nie jest potrzebna).

4. Proszę uzyskać adres endpointu i dodać prefiks https:// podczas wprowadzania go do NocoBase.

#Konfiguracja miniatur (opcjonalnie)

Ta konfiguracja jest opcjonalna i powinna być używana tylko wtedy, gdy chce Pan/Pani zoptymalizować rozmiar lub efekt podglądu obrazu.

1. Proszę wypełnić odpowiednie parametry dla Thumbnail rule. Szczegółowe ustawienia parametrów znajdzie Pan/Pani w dokumentacji Alibaba Cloud dotyczącej przetwarzania obrazów.

2. Ustawienia Full upload URL style i Full access URL style powinny pozostać takie same.

#Przykład konfiguracji

#MinIO

#Tworzenie Bucketa

1. Proszę kliknąć menu Buckets po lewej stronie -> kliknąć Create Bucket (Utwórz Bucket), aby otworzyć stronę tworzenia.
2. Po wprowadzeniu nazwy Bucketa proszę kliknąć przycisk Save (Zapisz).

#Pobieranie AccessKey i SecretAccessKey

1. Proszę przejść do Access Keys (Klucze dostępu) -> kliknąć przycisk Create access key (Utwórz klucz dostępu), aby otworzyć stronę tworzenia.

2. Proszę kliknąć przycisk Save (Zapisz).

3. Proszę zapisać Access Key i Secret Key z wyskakującego okna do późniejszej konfiguracji.

#Konfiguracja parametrów

1. Proszę przejść do strony File manager (Menedżer plików) w NocoBase.

2. Proszę kliknąć przycisk Add new (Dodaj nowy) i wybrać S3 Pro.

3. Proszę wypełnić formularz:

   • AccessKey ID i AccessKey Secret: Proszę użyć wartości zapisanych w poprzednim kroku.
   • Region: Prywatnie wdrożony MinIO nie posiada koncepcji regionu; może Pan/Pani ustawić go na "auto".
   • Endpoint: Proszę wprowadzić nazwę domeny lub adres IP wdrożonej usługi.
   • Należy ustawić Full access URL style na Path-Style.

#Przykład konfiguracji

#Tencent COS

Może Pan/Pani odnieść się do konfiguracji dla powyższych usług plików. Logika jest podobna.

#Przykład konfiguracji

#Cloudflare R2

Może Pan/Pani odnieść się do konfiguracji dla powyższych usług plików. Logika jest podobna.

#Przykład konfiguracji

#Instrukcja obsługi

Proszę zapoznać się z dokumentacją wtyczki file-manager.