S3-совместимые хранилища

Что индексируется

• Объекты (файлы) указанного бакета: документы, таблицы (CSV/XLSX) и изображения; из файлов извлекается текст.

Коннектор работает с любым хранилищем, совместимым с протоколом S3: облачные хранилища российских провайдеров (cloud.ru, Яндекс Object Storage, VK Cloud), MinIO и Ceph в вашем контуре и другие.

Предварительные требования

• Бакет в S3-совместимом хранилище и пара ключей с правом чтения (листинг бакета и получение объектов).

Получение учётных данных

1. В консоли вашего хранилища создайте сервисные ключи доступа (в разных провайдерах это называется access key / static key / HMAC-ключи).

2. В Charo заполните:

   Поле	Что указать
   Ключ доступа	идентификатор ключа (для cloud.ru — формат <tenant_id>:<key_id>)
   Секретный ключ	секретная часть ключа
   Эндпоинт S3	адрес API хранилища (по умолчанию s3.cloud.ru)
   Регион по умолчанию	регион хранилища (по умолчанию ru-central-1)
   Использовать HTTPS	включено по умолчанию

Настройка в Charo

Поле	Что указать
Имя бакета	имя бакета
Префикс	необязательно: индексировать только объекты с этим префиксом пути
Стиль адресации	как имя бакета помещается в URL запроса: «Virtual» — bucket.endpoint, «Path» — endpoint/bucket, «Auto» — на усмотрение клиента

Синхронизация прав

Не поддерживается: управляйте доступом видимостью коннектора и группами (см. «Права доступа»).

Ограничения и частота обновления

• Объекты больше ~20 МБ пропускаются.
• Обновления забираются инкрементально по расписанию коннектора.

Устранение неполадок

Ошибка подписи запроса (SignatureDoesNotMatch)

Проверьте секретный ключ и регион: для многих провайдеров регион участвует в подписи и должен совпадать с настройками хранилища.

Ошибка соединения

Эндпоинт должен быть доступен с сервера Charo. Для MinIO в закрытом контуре проверьте, что указан правильный порт и включён/выключен HTTPS соответственно настройке сервера.

«NoSuchBucket» при верном имени

Попробуйте другой «Стиль адресации»: часть хранилищ поддерживает только path-style («Path»).