Инструкция по настройке экспорта данных в S3

Сервис SkyDNS поддерживает автоматическую выгрузку данных в S3-совместимое объектное хранилище. Экспорт выполняется с периодичностью около 10 минут. Для активации функции необходимо корректно указать параметры подключения и убедиться, что учётные данные обладают необходимыми правами доступа.

Подготовка к настройке

Перед началом убедитесь, что у вас имеется:

Бакет (bucket) — контейнер для хранения данных в вашем S3-совместимом хранилище. Бакет должен быть создан заранее, так как SkyDNS не создаёт его автоматически. Имя бакета должно соответствовать правилам именования S3 (только строчные латинские буквы, цифры, дефисы; без точек и подчёркиваний).

Ключевой префикс — путь внутри бакета, по которому будут размещаться файлы экспорта (например, exports/ или skydns/data/). Обратите внимание: префикс указывается без начального слэша, но с завершающим слэшем, если это «папка» (например, logs/).

Endpoint — полный URL-адрес вашего S3-совместимого сервиса, включая протокол (http:// или https://).

Примеры:

Для AWS S3: https://s3.eu-central-1.amazonaws.com 

Для Yandex Object Storage: https://storage.yandexcloud.net 

При использовании ngrok: https://ваш-поддомен.ngrok-free.app

При локальном тестировании через ngrok убедитесь, что туннель активен и LocalStack запущен с поддержкой внешнего хоста (LOCALSTACK_HOST).

Access Key и Secret Key — учётные данные для аутентификации в хранилище. Эти данные выдаются при создании сервисного аккаунта или ключа в вашем хранилище. Храните Secret Key в секрете.

Права доступа — учётная запись должна иметь разрешения на выполнение следующих операций: 

s3:PutObject — запись объектов в бакет  s3:GetObject — чтение объектов из бакета  s3:ListBucket — получение списка объектов в бакете

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

Настройка в личном кабинете SkyDNS

Перейдите в раздел Статистика→ Экспорт данных → S3.

Заполните поля: 

Корзина — имя заранее созданного бакета.  Ключевой префикс — путь внутри бакета (например, daily/). Эндпоинт — полный URL вашего S3-совместимого сервиса.  Идентификатор ключа доступа — Access Key.  Секретный ключ доступа — Secret Key.

Убедитесь, что в полях нет случайных пробелов в начале или конце. Особенно это критично для ключей доступа.

Проверка подключения

После заполнения полей нажмите кнопку «Проверка и тестирование».  Система выполнит подключение к указанному хранилищу с использованием переданных учётных данных. 

Если проверка завершена успешно — вы увидите соответствующее уведомление.  Если возникла ошибка — внимательно сверьте все параметры, особенно endpoint и права доступа.

Завершение настройки

После успешной проверки нажмите «Сохранить».  С этого момента SkyDNS будет автоматически выгружать данные в указанное хранилище с интервалом примерно в 10 минут.

Первая выгрузка может произойти не сразу — дождитесь следующего планового цикла (в течение 10–15 минут).

Где и как посмотреть выгруженные файлы

После завершения настройки вы можете убедиться, что файлы действительно поступают:

Вариант 1: Через веб-интерфейс вашего хранилища  Если ваш S3-совместимый сервис предоставляет веб-консоль (например, AWS Console, Yandex Cloud, MinIO UI), откройте её, перейдите в нужный бакет и убедитесь, что файлы появляются по указанному пути.

Вариант 2: Через AWS CLI  Выполните в терминале (с теми же ключами и endpoint’ом, что использовались в настройке):

aws --endpoint-url=<ваш-endpoint> s3 ls s3://<имя-бакета>/<префикс>/

Пример:  aws --endpoint-url=https://xxxx.ngrok-free.app s3 ls s3://skydns-exports/daily/

Вариант 3: Вы можете посмотреть все файлы в вашем бакете, выполнив в терминале:

docker exec <ID контейнера> awslocal s3 ls s3://<имя-бакета>

Чтобы узнать ID, выполните команду docker ps.

Вариант 4: Через S3-клиенты с графическим интерфейсом  Для удобства просмотра и анализа файлов рекомендуем использовать: 

S3 Browser (Windows) 

Cyberduck (Windows/macOS) 

MinIO Client (mc)

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

Если всё настроено корректно, вы будете получать актуальные данные в вашем хранилище без дополнительных действий.Если у вас возникли трудности, вы всегда можете обратиться в нашу Техническую поддержку.