Об’єктне сховище для файлів і завантажень.
S3-сумісне сховище для проєкту: як додати бакет, які змінні S3_* отримує застосунок і як тарифікуються зберігання та операції.
Об’єктне сховище зберігає файли поза вашим застосунком: завантаження користувачів, згенеровані звіти, медіафайли, ваші власні резервні копії. Воно працює з будь-якою бібліотекою чи інструментом, що підтримує протокол S3, — AWS SDK, диском s3 у Laravel, django-storages, boto3, rclone та багатьма іншими.
Як додати сховище
Огляд застосунку → Сервіси → Об’єктне сховище → Додати сховище. Дайте бакету назву — малі латинські літери, цифри й дефіси, на початку літера — і підтвердьте. За мить бакет готовий.
У проєкті може бути до 3 бакетів.
Змінні, які отримує застосунок
Дані доступу додаються до змінних проєкту автоматично; застосунок підхоплює їх із наступним розгортанням:
| Змінна | Що це |
|---|---|
S3_ENDPOINT | адреса сховища |
S3_REGION | регіон, який слід указати у вашому S3-клієнті |
S3_BUCKET | назва бакета |
S3_KEY | ключ доступу |
S3_SECRET | секретний ключ |
Ключ працює лише з цим бакетом. Другий бакет проєкту отримує змінні з його назвою на початку: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET і так далі.
Ваша власна змінна з такою самою назвою залишається на місці — це зручно, якщо частина застосунку має й далі працювати зі сховищем деінде. Див. Змінні середовища.
Приклад: Laravel
У config/filesystems.php спрямуйте диск s3 на ці змінні:
's3' => [
'driver' => 's3',
'key' => env('S3_KEY'),
'secret' => env('S3_SECRET'),
'region' => env('S3_REGION'),
'bucket' => env('S3_BUCKET'),
'endpoint' => env('S3_ENDPOINT'),
'use_path_style_endpoint' => true,
],Потім задайте FILESYSTEM_DISK=s3 на вкладці Змінні.
Приклад: Node.js
import { S3Client } from '@aws-sdk/client-s3'
const s3 = new S3Client({
endpoint: process.env.S3_ENDPOINT,
region: process.env.S3_REGION,
credentials: { accessKeyId: process.env.S3_KEY, secretAccessKey: process.env.S3_SECRET },
})Ціна
| Ціна | |
|---|---|
| Зберігання | 0,025 USD за ГБ на місяць |
| Трафік | безкоштовно — завантаження зі сховища нічого не коштують |
| Запис | 6 USD за мільйон операцій |
| Читання | 0,50 USD за мільйон операцій |
Обсяг зберігання вимірюється щодня й усереднюється за місяць, тож файл, який пролежав пів місяця, коштує половину. Використання за календарний місяць додається до наступного платежу проєкту одним рядком; окремої підписки немає.
Перенесення файлів
Файли, які вже лежать в Amazon S3, Google Cloud Storage, іншому S3-сумісному сховищі чи в папці на вашому сервері, можна перенести в бакет — одразу всі або поступово, без простою. Див. Перенесення файлів в об’єктне сховище.
Видалення бакета
Видалення бакета прибирає всі файли в ньому; відновити їх неможливо, а змінні бакета зникають із проєкту. Видаляти бакет можуть власник акаунта й адміністратори застосунку.