Данные
Хранилища (S3)
S3-совместимое хранилище для файлов — изображения, загрузки, резервные копии. Ключи автоматически передаются сервисам.
Хранилище (бакет) — место для файлов: загруженных пользователями изображений, отчётов, резервных копий. Оно совместимо с S3 API, поэтому AWS SDK, boto3, @aws-sdk/client-s3 или rclone работают без изменений.
Создание хранилища
В окружении проекта нажмите Добавить хранилище. Имя хранилища имеет вид <проект>-<окружение>-<имя>, например shop-production-files.
Переменные
Для первого хранилища в окружении в сервисы записываются:
S3_ENDPOINT=https://s3.livops.app
S3_REGION=uz-tas
S3_BUCKET=shop-production-files
S3_ACCESS_KEY=...
S3_SECRET_KEY=...
S3_FORCE_PATH_STYLE=true
AWS_ENDPOINT_URL_S3=https://s3.livops.app
AWS_REGION=uz-tas
AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...
Последующие хранилища получают префикс с именем сервиса (например, S3_STORAGE_2_BUCKET), и AWS_* для них не выдаются.
Адресация — в стиле пути (path-style): https://s3.livops.app/<хранилище>/<файл>.
import os, boto3
s3 = boto3.client('s3', endpoint_url=os.environ['S3_ENDPOINT'])
s3.upload_file('report.pdf', os.environ['S3_BUCKET'], 'reports/report.pdf')
Публичное и приватное
- Хранилище по умолчанию приватное: доступ к файлам — по ключу или по временной подписанной ссылке (presigned URL).
- Всё хранилище можно сделать публичным — тогда добавляется переменная
..._PUBLIC_URL. Открыть отдельную папку нельзя. - Настраиваются правила CORS и автоматическое удаление старых файлов (через N дней, с необязательным префиксом, 0–3650 дней).
Готовые настройки при создании
Окно добавления задаёт два вопроса; оба можно поменять позже на странице хранилища.
- Для чего. Загрузки (по умолчанию) — закрытое; страницы ваших приложений могут читать и загружать файлы из браузера (CORS для адресов проекта). Файлы сайта — сразу открытое: каждый файл доступен по
..._PUBLIC_URL, читать может любой сайт (CORS*, только GET/HEAD). - Удалять старые файлы — никогда или через 1, 7, 30, 90 или 365 дней.
На странице хранилища в форме CORS есть те же две кнопки: Страницы приложений загружают и Любой сайт читает. Они заполняют форму; ничего не сохраняется, пока вы не добавите правило.
Свой домен для открытого хранилища пока не поддерживается.
Размеры и цены
| Размер | Цена в месяц |
|---|---|
| 1 GB | Бесплатно — одно на команду |
| 5 GB | 15 кредитов (15 000 сум) |
| 25 GB | 49 кредитов (49 000 сум) |
| 100 GB | 149 кредитов (149 000 сум) |
Актуальная цена показана в кабинете в окне добавления хранилища.