S3 на практике: бакеты, ключи, версии и совместимость
Что проверить перед подключением приложения к S3-совместимому хранилищу.
Минимальная модель
Бакет — контейнер объектов. Ключ — имя объекта внутри него, например manuals/router.pdf. Endpoint — адрес API выбранного провайдера. Access key и secret key относятся к доступу, а не к содержимому файла. В рабочем приложении эти значения задаются через защищённую конфигурацию сервера.
Совместимость проверяют по операциям
Поддержка S3 API позволяет использовать привычные SDK, но набор операций у провайдеров различается. Проверьте загрузку большого объекта, чтение диапазона, подписанные ссылки, метаданные и работу версии SDK. Совпадение названия протокола не заменяет интеграционный тест.
Версии сохраняют историю
Versioning в Amazon S3 хранит варианты объекта и помогает вернуться после ошибочной записи. Оно требует отдельной политики хранения старых версий. У другого провайдера наличие и семантику версий проверяют в документации. История внутри одного аккаунта не создаёт независимую копию.
Не переносите настройки версий или lifecycle из AWS в R2 без проверки поддержки конкретной операции.
Разделите служебный API и публикацию
Закрытый бакет может обслуживать приложение без публичного списка файлов. Для разовой выдачи документа подходит короткоживущая подписанная ссылка. Её получатель фактически получает временное право доступа: такую ссылку не стоит публиковать в общем журнале.
Учебный план приёмки
Создайте тестовый бакет и ключ с минимальными разрешениями. Загрузите файл с кириллицей в имени, большой архив и два варианта документа. Скачайте их другим клиентом, проверьте содержимое и истечение срока временной ссылки. Отдельно убедитесь, что анонимное чтение запрещено.
Связь с ИИ
Храните в метаданных базы знаний ключ объекта, контрольную сумму и редакцию документа. Тогда ответ ИИ можно связать с конкретным источником. При замене документа пересоздавайте относящиеся к нему фрагменты и удаляйте старые записи из выдачи поиска.
Отметка поможет найти непрочитанное.