#Зберігання файлів: S3 (Pro)

#Вступ

Розширюючи можливості плагіна для керування файлами, ця версія додає підтримку типів зберігання, сумісних з протоколом S3. Ви можете легко інтегрувати будь-який сервіс об'єктного зберігання, що підтримує S3, наприклад, Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO, Cloudflare R2 та інші. Це значно підвищує сумісність та гнучкість ваших рішень для зберігання.

#Особливості

1. Завантаження з клієнта: Файли завантажуються безпосередньо в сервіс зберігання, минаючи сервер NocoBase. Це забезпечує більш ефективний та швидкий процес завантаження.

2. Приватний доступ: Усі URL-адреси файлів є тимчасовими авторизованими посиланнями з підписом, що гарантує безпечний та обмежений у часі доступ до файлів.

#Сценарії використання

1. Керування таблицями файлів: Централізоване керування та зберігання всіх завантажених файлів, підтримка різних типів файлів та методів зберігання для зручної класифікації та пошуку.

2. Зберігання вкладень у полях: Зберігання вкладень, завантажених через форми або записи, з можливістю їх асоціації з конкретними записами даних.

#Налаштування плагіна

1. Увімкніть плагін plugin-file-storage-s3-pro.

2. Перейдіть до "Setting -> FileManager", щоб отримати доступ до налаштувань керування файлами.

3. Натисніть кнопку "Add new" (Додати новий) та оберіть "S3 Pro".

4. У спливаючому вікні ви побачите детальну форму для заповнення. Зверніться до подальшої документації, щоб отримати відповідні параметри для вашого файлового сервісу та правильно ввести їх у форму.

#Налаштування постачальника послуг

#Amazon S3

#Створення бакета

1. Відкрийте консоль Amazon S3.

2. Натисніть кнопку "Create bucket" (Створити бакет) у правій частині екрана.

3. Заповніть Bucket Name (Назва бакета), інші поля залиште за замовчуванням, прокрутіть сторінку донизу та натисніть кнопку "Create" (Створити), щоб завершити процес.

#Налаштування CORS

1. У списку бакетів знайдіть і натисніть на щойно створений бакет, щоб перейти до його детальної сторінки.

2. Перейдіть на вкладку "Permission" (Дозволи) і прокрутіть униз до розділу налаштувань CORS.

3. Введіть наступну конфігурацію (за потреби можете її уточнити) та збережіть.

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

#Отримання AccessKey та SecretAccessKey

1. Натисніть кнопку "Security credentials" (Облікові дані безпеки) у верхньому правому куті сторінки.

2. Прокрутіть униз до розділу "Access Keys" (Ключі доступу) та натисніть кнопку "Create Access Key" (Створити ключ доступу).

3. Погодьтеся з умовами (тут демонструється використання основного облікового запису, але в робочому середовищі рекомендується використовувати IAM).

4. Збережіть відображені Access Key та Secret Access Key.

#Отримання та налаштування параметрів

1. Використовуйте отримані AccessKey ID та AccessKey Secret.

2. Перейдіть на панель властивостей бакета, щоб знайти Bucket Name (Назва бакета) та Region (Регіон).

#Публічний доступ (необов'язково)

Це необов'язкова конфігурація. Налаштуйте її, якщо вам потрібно зробити завантажені файли повністю публічними.

1. На панелі "Permissions" (Дозволи) прокрутіть до "Object Ownership" (Власність об'єктів), натисніть "Edit" (Редагувати) та увімкніть ACLs.

2. Прокрутіть до "Block public access" (Блокувати публічний доступ), натисніть "Edit" (Редагувати) та встановіть дозвіл на керування ACL.

3. У NocoBase встановіть прапорець "Public access" (Публічний доступ).

#Налаштування мініатюр (необов'язково)

Ця конфігурація є необов'язковою і використовується, коли потрібно оптимізувати розмір або ефект попереднього перегляду зображень. Зверніть увагу, що це розгортання може призвести до додаткових витрат. Для отримання детальної інформації про вартість зверніться до відповідних умов AWS.

1. Відвідайте Dynamic Image Transformation for Amazon CloudFront.

2. Натисніть кнопку Launch in the AWS Console (Запустити в консолі AWS) внизу сторінки, щоб розпочати розгортання рішення.

3. Дотримуйтесь підказок для завершення налаштування. Особливу увагу слід звернути на такі параметри:

   1. Під час створення стека вам потрібно буде вказати назву бакета Amazon S3, який містить вихідні зображення. Будь ласка, введіть назву бакета, який ви створили раніше.
   2. Якщо ви обрали розгортання демонстраційного інтерфейсу, після завершення розгортання ви зможете використовувати його для тестування функцій обробки зображень. У консолі AWS CloudFormation виберіть свій стек, перейдіть на вкладку "Outputs" (Виходи), знайдіть значення, що відповідає ключу DemoUrl, і натисніть на посилання, щоб відкрити демонстраційний інтерфейс.
   3. Це рішення використовує бібліотеку sharp Node.js для ефективної обробки зображень. Ви можете завантажити вихідний код з репозиторію GitHub та налаштувати його відповідно до своїх потреб.

4. Після завершення налаштування дочекайтеся, доки статус розгортання зміниться на CREATE_COMPLETE.

5. У налаштуваннях NocoBase зверніть увагу на наступне:

   1. Thumbnail rule (Правило мініатюр): Заповніть параметри обробки зображень, наприклад, ?width=100. Детальніше дивіться в документації AWS.
   2. Access endpoint (Кінцева точка доступу): Введіть значення з Outputs -> ApiEndpoint після розгортання.
   3. Full access URL style (Стиль URL повного доступу): Потрібно вибрати Ignore (Ігнорувати), оскільки назва бакета вже була вказана під час налаштування і не потрібна для доступу.

#Приклад конфігурації

#Alibaba Cloud OSS

#Створення бакета

1. Відкрийте консоль OSS.

2. Виберіть "Buckets" (Бакети) у лівому меню та натисніть кнопку "Create Bucket" (Створити бакет), щоб розпочати створення сховища.

3. Заповніть інформацію про бакет і натисніть кнопку "Create" (Створити).

   • Bucket Name (Назва бакета): Оберіть відповідно до ваших бізнес-потреб.
   • Region (Регіон): Оберіть найближчий регіон для ваших користувачів.
   • Інші налаштування можна залишити за замовчуванням або налаштувати за потреби.

#Налаштування CORS

1. Перейдіть на сторінку деталей бакета, який ви щойно створили.

2. Натисніть "Content Security -> CORS" (Безпека контенту -> CORS) у центральному меню.

3. Натисніть кнопку "Create Rule" (Створити правило), заповніть відповідні поля, прокрутіть униз і натисніть "OK". Ви можете скористатися скріншотом нижче або налаштувати більш детальні параметри.

#Отримання AccessKey та SecretAccessKey

1. Натисніть "AccessKey" під аватаром вашого облікового запису у верхньому правому куті.

2. Для демонстраційних цілей ми створимо AccessKey за допомогою основного облікового запису. У робочому середовищі рекомендується використовувати RAM для створення AccessKey. Інструкції можна знайти в документації Alibaba Cloud.

3. Натисніть кнопку "Create AccessKey" (Створити ключ доступу).

4. Пройдіть верифікацію облікового запису.

5. Збережіть відображені Access Key та Secret Access Key.

#Отримання та налаштування параметрів

1. Використовуйте AccessKey ID та AccessKey Secret, отримані на попередньому кроці.

2. Перейдіть на сторінку деталей бакета, щоб отримати назву Bucket (Бакета).

3. Прокрутіть униз, щоб отримати Region (Регіон) (суфікс ".aliyuncs.com" не потрібен).

4. Отримайте адресу кінцевої точки та додайте префікс https:// при введенні її в NocoBase.

#Налаштування мініатюр (необов'язково)

Ця конфігурація є необов'язковою і використовується лише тоді, коли потрібно оптимізувати розмір або ефект попереднього перегляду зображень.

1. Заповніть відповідні параметри для Thumbnail rule (Правило мініатюр). Детальніше про налаштування параметрів дивіться в документації Alibaba Cloud щодо обробки зображень.

2. Залиште налаштування Full upload URL style (Стиль URL повного завантаження) та Full access URL style (Стиль URL повного доступу) однаковими.

#Приклад конфігурації

#MinIO

#Створення бакета

1. Натисніть меню Buckets (Бакети) ліворуч -> Натисніть Create Bucket (Створити бакет), щоб відкрити сторінку створення.
2. Введіть назву бакета, потім натисніть кнопку Save (Зберегти).

#Отримання AccessKey та SecretAccessKey

1. Перейдіть до Access Keys (Ключі доступу) -> Натисніть кнопку Create access key (Створити ключ доступу), щоб відкрити сторінку створення.

2. Натисніть кнопку Save (Зберегти).

3. Збережіть Access Key та Secret Key зі спливаючого вікна для подальшого налаштування.

#Налаштування параметрів

1. Перейдіть на сторінку File manager (Менеджер файлів) у NocoBase.

2. Натисніть кнопку Add new (Додати новий) та оберіть S3 Pro.

3. Заповніть форму:

   • AccessKey ID та AccessKey Secret: Використовуйте значення, збережені на попередньому кроці.
   • Region (Регіон): Приватно розгорнутий MinIO не має концепції регіону; ви можете встановити його як "auto".
   • Endpoint (Кінцева точка): Введіть доменне ім'я або IP-адресу вашого розгорнутого сервісу.
   • Встановіть Full access URL style (Стиль URL повного доступу) на Path-Style.

#Приклад конфігурації

#Tencent COS

Ви можете налаштувати його, посилаючись на вищезгадані файлові сервіси. Логіка налаштування схожа.

#Приклад конфігурації

#Cloudflare R2

Ви можете налаштувати його, посилаючись на вищезгадані файлові сервіси. Логіка налаштування схожа.

#Приклад конфігурації

#Посібник користувача

Зверніться до документації плагіна file-manager.