Разделы документации
Коннекторы
Google Cloud Storage
Подключение бакета Google Cloud Storage к Charo — HMAC-ключи и индексация объектов.
Что индексируется
- Объекты (файлы) указанного бакета GCS: документы, таблицы и изображения; из файлов извлекается текст.
Предварительные требования
- Бакет Google Cloud Storage и сервис-аккаунт с правом чтения бакета
(роль
Storage Object Viewer).
Получение учётных данных
Коннектор использует HMAC-ключи (S3-совместимая аутентификация GCS):
- В консоли Google Cloud откройте Cloud Storage → Settings → Interoperability.
- Создайте HMAC key для сервис-аккаунта с доступом к бакету.
- В Charo заполните «GCS Access Key ID» и «GCS Secret Access Key».
Настройка в Charo
| Поле | Что указать |
|---|---|
| Имя бакета | имя бакета GCS, например my-gcs-bucket |
| Префикс пути | необязательно: индексировать только объекты с этим префиксом |
Синхронизация прав
Не поддерживается: управляйте доступом видимостью коннектора и группами (см. «Права доступа»).
Ограничения и частота обновления
- Объекты больше ~20 МБ пропускаются.
- Обновления забираются инкрементально по расписанию коннектора.
Устранение неполадок
«403 Forbidden»
У сервис-аккаунта, для которого создан HMAC-ключ, нет роли чтения на бакет —
выдайте Storage Object Viewer.
Пустая индексация
Проверьте имя бакета и префикс пути — префикс сравнивается с началом имени объекта.