Почати

Об’єктне сховище для файлів і завантажень.

S3-сумісне сховище для проєкту: як додати бакет, які змінні S3_* отримує застосунок і як тарифікуються зберігання та операції.

2 ХВ ЧИТАННЯ

Об’єктне сховище зберігає файли поза вашим застосунком: завантаження користувачів, згенеровані звіти, медіафайли, ваші власні резервні копії. Воно працює з будь-якою бібліотекою чи інструментом, що підтримує протокол 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-сумісному сховищі чи в папці на вашому сервері, можна перенести в бакет — одразу всі або поступово, без простою. Див. Перенесення файлів в об’єктне сховище.

Видалення бакета

Видалення бакета прибирає всі файли в ньому; відновити їх неможливо, а змінні бакета зникають із проєкту. Видаляти бакет можуть власник акаунта й адміністратори застосунку.

Залишилися питання?

Напишіть нам у чат — AI відповідає одразу, а інженер підключається за потреби в будь-який час доби.

Написати в підтримку