Objektové úložiště pro soubory a nahrávky.
Úložiště kompatibilní s S3 pro projekt: jak přidat bucket, jaké proměnné S3_* aplikace dostane a jak se účtuje úložiště a operace.
Objektové úložiště uchovává soubory mimo vaši aplikaci: soubory nahrané uživateli, generované reporty, média, vaše vlastní zálohy. Funguje s jakoukoli knihovnou nebo nástrojem, který umí protokol S3 — s AWS SDK, diskem s3 v Laravelu, django-storages, boto3, rclone a mnoha dalšími.
Přidání úložiště
V aplikaci Přehled → Služby → Objektové úložiště → Přidat úložiště. Pojmenujte bucket — malá písmena latinky, číslice a pomlčky, na začátku písmeno — a potvrďte. Bucket je za chvíli připravený.
Projekt může mít až 3 buckety.
Proměnné, které aplikace dostane
Přístupové údaje se do proměnných projektu přidají samy; aplikace je načte při příštím nasazení:
| Proměnná | Co obsahuje |
|---|---|
S3_ENDPOINT | adresu úložiště |
S3_REGION | region, který použijete v klientovi S3 |
S3_BUCKET | název bucketu |
S3_KEY | přístupový klíč |
S3_SECRET | tajný klíč |
Klíč platí jen pro tento bucket. Druhý bucket projektu dostane proměnné s názvem na začátku: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET a tak dále.
Vlastní proměnná se stejným názvem zůstane zachovaná — hodí se, pokud má část aplikace dál používat úložiště jinde. Viz Proměnné prostředí.
Příklad: Laravel
V config/filesystems.php nasměrujte disk s3 na proměnné:
'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,
],Pak na kartě Proměnné nastavte FILESYSTEM_DISK=s3.
Příklad: 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 },
})Cena
| Cena | |
|---|---|
| Úložiště | 0,025 US$ za GB měsíčně |
| Provoz | zdarma — stahování z úložiště nic nestojí |
| Zápisy | 6 US$ za milion operací |
| Čtení | 0,50 US$ za milion operací |
Využití úložiště se měří každý den a průměruje za měsíc, takže soubor uložený půl měsíce stojí polovinu. Využití za kalendářní měsíc se přičte k příští platbě projektu jako jedna položka; žádné samostatné předplatné není.
Přesun souborů
Soubory, které už máte v Amazon S3, Google Cloud Storage, jiném úložišti kompatibilním s S3 nebo ve složce na svém serveru, můžete přesunout do bucketu — najednou, nebo postupně bez výpadku. Viz Přesun souborů do objektového úložiště.
Smazání bucketu
Smazání bucketu odstraní všechny soubory v něm; nelze je obnovit a jeho proměnné z projektu zmizí. Smazat bucket může vlastník účtu a Administrátoři aplikace.