Хранилище файлов: S3 (Pro)

Хранилище файлов: S3 (Pro)Professional Edition+

Введение

На основе плагина для управления файлами добавлена поддержка типов файловых хранилищ, совместимых с протоколом S3. Любой сервис объектного хранения, поддерживающий протокол S3, например Amazon S3, Alibaba Cloud OSS, Tencent Cloud COS, MinIO, Cloudflare R2 и другие, может быть легко интегрирован, что повышает совместимость и гибкость служб хранения.

Особенности

Загрузка с клиента: Файлы загружаются непосредственно в службу хранения, минуя сервер NocoBase, что обеспечивает более эффективную и быструю загрузку.
Приватный доступ: Все URL-адреса файлов являются подписанными временными авторизационными ссылками, что гарантирует безопасность и ограниченность доступа к файлам по времени.

Сценарии использования

Управление таблицами файлов: Централизованное управление и хранение всех загруженных файлов с поддержкой различных типов файлов и методов хранения для удобной классификации и поиска.
Хранение вложений в полях: Хранение вложений, загруженных через формы или записи, с возможностью их привязки к конкретным записям данных.

Настройка плагина

Включите плагин plugin-file-storage-s3-pro.
Перейдите в "Setting -> FileManager", чтобы открыть настройки управления файлами.
Нажмите кнопку "Add new" и выберите "S3 Pro".

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

Настройка поставщика услуг

Amazon S3

Создание бакета

Перейдите в консоль Amazon S3.
Нажмите кнопку "Create bucket" справа.

Заполните поле Bucket Name (имя бакета), остальные поля оставьте по умолчанию, прокрутите страницу вниз и нажмите кнопку "Create", чтобы завершить процесс.

Настройка CORS

В списке бакетов найдите и нажмите на только что созданный бакет, чтобы перейти к его подробным сведениям.

Перейдите на вкладку "Permission" и прокрутите вниз до раздела настройки CORS.

Введите следующую конфигурацию (при необходимости настройте ее) и сохраните.

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

Получение AccessKey и SecretAccessKey

Нажмите кнопку "Security credentials" в правом верхнем углу страницы.

Прокрутите вниз до раздела "Access Keys" и нажмите кнопку "Create Access Key".

Согласитесь с условиями (для демонстрации используется основная учетная запись; в производственной среде рекомендуется использовать IAM).

Сохраните отображаемые Access Key и Secret Access Key.

Получение и настройка параметров

AccessKey ID и AccessKey Secret — это значения, полученные вами на предыдущем шаге. Введите их точно.
Перейдите на панель свойств страницы сведений о бакете, где вы сможете получить информацию об имени бакета (Bucket Name) и регионе (Region).

Публичный доступ (необязательно)

Это необязательная настройка. Выполните ее, если вам нужно сделать загруженные файлы полностью общедоступными.

На панели "Permissions" прокрутите до "Object Ownership", нажмите "Edit" и включите ACLs.

Прокрутите до "Block public access", нажмите "Edit" и установите разрешение на управление ACL.

В NocoBase установите флажок "Public access".

Настройка миниатюр (необязательно)

Эта настройка является необязательной и используется, когда вам необходимо оптимизировать размер или эффект предварительного просмотра изображений. Обратите внимание, что это развертывание может повлечь за собой дополнительные расходы. Для получения более подробной информации ознакомьтесь с соответствующими условиями и ценами AWS.

Посетите страницу Dynamic Image Transformation for Amazon CloudFront.
Нажмите кнопку Launch in the AWS Console в нижней части страницы, чтобы начать развертывание.

Следуйте подсказкам для завершения настройки. Особое внимание уделите следующим опциям:
1. При создании стека вам потребуется указать имя бакета Amazon S3, содержащего исходные изображения. Пожалуйста, введите имя бакета, которое вы создали ранее.
2. Если вы выбрали развертывание демонстрационного пользовательского интерфейса, после развертывания вы сможете использовать его для тестирования функций обработки изображений. В консоли AWS CloudFormation выберите ваш стек, перейдите на вкладку "Outputs", найдите значение, соответствующее ключу DemoUrl, и нажмите на эту ссылку, чтобы открыть демонстрационный интерфейс.
3. Это решение использует библиотеку Node.js sharp для эффективной обработки изображений. Вы можете загрузить исходный код из репозитория GitHub и настроить его по мере необходимости.

После завершения настройки дождитесь, пока статус развертывания изменится на CREATE_COMPLETE.
В настройках NocoBase обратите внимание на следующее:
1. Thumbnail rule: Введите параметры обработки изображений, например ?width=100. Подробности см. в документации AWS.
2. Access endpoint: Введите значение из Outputs -> ApiEndpoint после развертывания.
3. Full access URL style: Выберите Ignore (поскольку имя бакета уже было указано при настройке, оно не требуется для доступа).

Пример настройки