Object storage untuk file dan upload.
Penyimpanan yang kompatibel dengan S3 untuk proyek: cara menambahkan bucket, variabel S3_* yang didapat aplikasi Anda, dan cara harga penyimpanan serta operasi dihitung.
Object storage menyimpan file di luar aplikasi Anda: upload pengguna, laporan yang dihasilkan, media, backup Anda sendiri. Object storage bekerja dengan library atau tool apa pun yang mendukung protokol S3 — AWS SDK, disk s3 milik Laravel, django-storages, boto3, rclone, dan banyak lagi.
Menambahkan storage
Ringkasan aplikasi → Service → Object storage → Tambah storage. Beri nama bucket — huruf Latin kecil, angka, dan tanda hubung, diawali huruf — lalu konfirmasi. Bucket siap dalam sekejap.
Satu proyek dapat memiliki hingga 3 bucket.
Variabel yang didapat aplikasi Anda
Detail akses otomatis ditambahkan ke variabel proyek; aplikasi menggunakannya pada deploy berikutnya:
| Variabel | Isinya |
|---|---|
S3_ENDPOINT | alamat storage |
S3_REGION | region yang digunakan di client S3 Anda |
S3_BUCKET | nama bucket |
S3_KEY | access key |
S3_SECRET | secret key |
Kunci ini hanya berfungsi untuk bucket ini saja. Bucket kedua dalam proyek mendapat variabel dengan namanya di depan: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET, dan seterusnya.
Variabel Anda sendiri dengan nama yang sama tetap dipertahankan — berguna jika sebagian aplikasi Anda tetap harus menggunakan storage di tempat lain. Lihat Variabel lingkungan.
Contoh: Laravel
Di config/filesystems.php, arahkan disk s3 ke variabel tersebut:
'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,
],Lalu atur FILESYSTEM_DISK=s3 di tab Variabel.
Contoh: 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 },
})Harga
| Harga | |
|---|---|
| Penyimpanan | US$0,025 per GB per bulan |
| Trafik | gratis — unduhan dari storage tidak dikenai biaya |
| Penulisan | US$6,00 per juta operasi |
| Pembacaan | US$0,50 per juta operasi |
Penyimpanan diukur setiap hari dan dirata-rata selama sebulan, sehingga file yang disimpan setengah bulan berharga setengahnya. Penggunaan dalam satu bulan kalender ditambahkan ke pembayaran proyek berikutnya sebagai satu baris; tidak ada langganan terpisah.
Memindahkan file ke storage
File yang sudah ada di Amazon S3, Google Cloud Storage, storage lain yang kompatibel dengan S3, atau folder di server Anda dapat dipindahkan ke bucket — sekaligus, atau bertahap tanpa downtime. Lihat Memindahkan file ke object storage.
Menghapus bucket
Penghapusan bucket menghapus semua file di dalamnya; file tidak dapat dipulihkan, dan variabelnya dihapus dari proyek. Penghapusan bucket tersedia untuk pemilik akun dan Administrator aplikasi.