Обектно хранилище за файлове и качвания.
S3-съвместимо хранилище за проект: как да добавите bucket, кои S3_* променливи получава приложението ви и как се таксуват съхранението и операциите.
Обектното хранилище пази файловете извън приложението ви: качени от потребителите файлове, генерирани отчети, медия, ваши собствени резервни копия. Работи с всяка библиотека или инструмент, които поддържат протокола S3 — AWS SDK, диска s3 на Laravel, django-storages, boto3, rclone и много други.
Добавяне на хранилище
Преглед на приложението → Услуги → Обектно хранилище → Добавяне на хранилище. Дайте име на bucket-а — малки латински букви, цифри и тирета, започващо с буква — и потвърдете. Bucket-ът е готов след миг.
Един проект може да има до 3 bucket-а.
Променливите, които получава приложението ви
Данните за достъп се добавят автоматично към променливите на проекта; приложението ги взема със следващия си деплой:
| Променлива | Какво е |
|---|---|
S3_ENDPOINT | адресът на хранилището |
S3_REGION | регионът, който да използвате в S3 клиента си |
S3_BUCKET | името на bucket-а |
S3_KEY | ключът за достъп |
S3_SECRET | секретният ключ |
Ключът работи само за този bucket. Втори bucket на проекта получава променливите си с името си отпред: <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 щ.д. на GB месечно |
| Трафик | безплатно — изтеглянията от хранилището не струват нищо |
| Записи | 6,00 щ.д. на милион операции |
| Четения | 0,50 щ.д. на милион операции |
Съхранението се измерва всеки ден и се осреднява за месеца, така че файл, пазен половин месец, струва половината. Потреблението за календарен месец се добавя към следващото плащане на проекта като един ред; отделен абонамент няма.
Преместване на файлове
Файлове, които вече са в Amazon S3, Google Cloud Storage, друго S3-съвместимо хранилище или в папка на вашия сървър, могат да бъдат преместени в bucket — наведнъж или постепенно, без прекъсване. Вижте Преместване на файлове в обектното хранилище.
Изтриване на bucket
Изтриването на bucket-а премахва всички файлове в него; те не могат да бъдат възстановени, а променливите му се премахват от проекта. Изтриването на bucket е достъпно за собственика на акаунта и за администраторите на приложението.