Objektitallennus tiedostoille ja latauksille.
S3-yhteensopiva tallennustila projektille: miten bucket lisätään, mitkä S3_*-muuttujat sovelluksesi saa ja miten tallennustila ja operaatiot hinnoitellaan.
Objektitallennus säilyttää tiedostot sovelluksesi ulkopuolella: käyttäjien lataamat tiedostot, luodut raportit, mediatiedostot, omat varmuuskopiosi. Se toimii minkä tahansa S3-protokollaa tukevan kirjaston tai työkalun kanssa – AWS SDK:t, Laravelin s3-levy, django-storages, boto3, rclone ja monet muut.
Tallennustilan lisääminen
Sovelluksen Yleiskatsaus → Palvelut → Objektitallennus → Lisää tallennustila. Anna bucketille nimi – pieniä latinalaisia kirjaimia, numeroita ja yhdysviivoja, alkaen kirjaimella – ja vahvista. Bucket on valmis hetkessä.
Projektilla voi olla enintään 3 bucketia.
Muuttujat, jotka sovelluksesi saa
Käyttötiedot lisätään projektin muuttujiin automaattisesti; sovellus ottaa ne käyttöön seuraavassa julkaisussaan:
| Muuttuja | Mikä se on |
|---|---|
S3_ENDPOINT | tallennustilan osoite |
S3_REGION | S3-asiakkaassa käytettävä alue |
S3_BUCKET | bucketin nimi |
S3_KEY | käyttöavain |
S3_SECRET | salainen avain |
Avain toimii vain tässä bucketissa. Projektin toinen bucket saa muuttujansa nimensä etuliitteellä: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET ja niin edelleen.
Saman niminen oma muuttujasi säilyy ennallaan – hyödyllistä, jos osan sovelluksestasi pitää jatkaa toisen tallennustilan käyttöä. Katso Ympäristömuuttujat.
Esimerkki: Laravel
Osoita tiedostossa config/filesystems.php s3-levy muuttujiin:
'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,
],Aseta sitten FILESYSTEM_DISK=s3 Muuttujat-välilehdellä.
Esimerkki: 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 },
})Hinta
| Hinta | |
|---|---|
| Tallennustila | 0,025 $ / Gt kuukaudessa |
| Liikenne | maksuton – lataukset tallennustilasta eivät maksa mitään |
| Kirjoitukset | 6,00 $ / miljoona operaatiota |
| Luvut | 0,50 $ / miljoona operaatiota |
Tallennustila mitataan päivittäin ja siitä lasketaan kuukauden keskiarvo, joten puoli kuukautta säilytetty tiedosto maksaa puolet. Kalenterikuukauden käyttö lisätään projektin seuraavaan maksuun yhtenä rivinä; erillistä tilausta ei ole.
Tiedostojen siirtäminen
Amazon S3:ssa, Google Cloud Storagessa, muussa S3-yhteensopivassa tallennustilassa tai palvelimesi kansiossa jo olevat tiedostot voi siirtää bucketiin – kerralla tai vähitellen ilman katkoa. Katso Tiedostojen siirto objektitallennukseen.
Bucketin poistaminen
Bucketin poisto poistaa kaikki sen tiedostot; niitä ei voi palauttaa, ja sen muuttujat poistuvat projektista. Bucketin voi poistaa tilin omistaja ja sovelluksen Ylläpitäjät.