Object storage cho tệp và tệp tải lên.
Bộ lưu trữ tương thích S3 cho dự án: cách thêm bucket, các biến S3_* ứng dụng nhận được, và cách tính giá lưu trữ và thao tác.
Object storage lưu tệp bên ngoài ứng dụng: tệp người dùng tải lên, báo cáo được tạo, media, bản sao lưu của riêng bạn. Nó hoạt động với mọi thư viện hoặc công cụ hỗ trợ giao thức S3 — AWS SDK, disk s3 của Laravel, django-storages, boto3, rclone và nhiều công cụ khác.
Thêm bộ lưu trữ
Vào Tổng quan của ứng dụng → Services → Object storage → Add storage. Đặt tên cho bucket — chữ Latin thường, chữ số và dấu gạch ngang, bắt đầu bằng chữ cái — rồi xác nhận. Bucket sẵn sàng chỉ sau giây lát.
Mỗi dự án có tối đa 3 bucket.
Các biến ứng dụng nhận được
Thông tin truy cập được tự động thêm vào biến của dự án; ứng dụng nhận chúng ở lần deploy tiếp theo:
| Biến | Ý nghĩa |
|---|---|
S3_ENDPOINT | địa chỉ của bộ lưu trữ |
S3_REGION | region dùng trong S3 client |
S3_BUCKET | tên bucket |
S3_KEY | access key |
S3_SECRET | secret key |
Khóa chỉ dùng được cho bucket này. Bucket thứ hai của dự án nhận các biến có tên bucket ở đầu: <NAME>_S3_ENDPOINT, <NAME>_S3_BUCKET và tương tự.
Biến của riêng bạn có cùng tên vẫn được giữ nguyên — hữu ích khi một phần ứng dụng cần tiếp tục dùng bộ lưu trữ ở nơi khác. Xem Biến môi trường.
Ví dụ: Laravel
Trong config/filesystems.php, trỏ disk s3 tới các biến:
'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,
],Sau đó đặt FILESYSTEM_DISK=s3 ở tab Variables.
Ví dụ: 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 },
})Giá
| Giá | |
|---|---|
| Lưu trữ | 0,025 US$ mỗi GB mỗi tháng |
| Lưu lượng | miễn phí — tải xuống từ bộ lưu trữ không mất phí |
| Ghi | 6,00 US$ mỗi triệu thao tác |
| Đọc | 0,50 US$ mỗi triệu thao tác |
Dung lượng lưu trữ được đo mỗi ngày và lấy trung bình theo tháng, nên tệp lưu nửa tháng chỉ tính nửa giá. Mức sử dụng của một tháng dương lịch được cộng vào lần thanh toán tiếp theo của dự án thành một dòng; không có gói đăng ký riêng.
Chuyển tệp vào
Tệp đang ở Amazon S3, Google Cloud Storage, bộ lưu trữ tương thích S3 khác hoặc một thư mục trên máy chủ của bạn có thể được chuyển vào bucket — một lần hoặc dần dần mà không gián đoạn. Xem Chuyển tệp vào object storage.
Xóa bucket
Xóa bucket sẽ xóa mọi tệp trong đó; không thể khôi phục, và các biến của bucket bị gỡ khỏi dự án. Chỉ chủ tài khoản và Administrator của ứng dụng mới xóa được bucket.