ファイルとアップロードのためのオブジェクトストレージ。
プロジェクト用のS3互換ストレージ:バケットの追加方法、アプリに渡されるS3_*変数、ストレージと操作の料金について説明します。
オブジェクトストレージは、ユーザーのアップロードファイル、生成したレポート、メディア、独自のバックアップなどのファイルを、アプリの外に保存します。S3プロトコルに対応したライブラリやツールで使えます。AWS SDK、Laravelのs3ディスク、django-storages、boto3、rcloneなどです。
ストレージの追加
アプリの概要 → サービス → オブジェクトストレージ → ストレージを追加を開きます。バケット名(半角英小文字、数字、ハイフンで、先頭は英字)を入力して確定します。バケットはすぐに使えるようになります。
1つのプロジェクトで最大3つのバケットを作成できます。
アプリに渡される変数
アクセス情報はプロジェクトの変数に自動で追加され、次回のデプロイでアプリに反映されます。
| 変数 | 内容 |
|---|---|
S3_ENDPOINT | ストレージのアドレス |
S3_REGION | S3クライアントで使うリージョン |
S3_BUCKET | バケット名 |
S3_KEY | アクセスキー |
S3_SECRET | シークレットキー |
キーはこのバケット専用です。プロジェクトの2つ目のバケットでは、変数名の先頭にバケット名が付きます:<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 },
})料金
| 料金 | |
|---|---|
| ストレージ | 1GBあたり月額$0.025 |
| トラフィック | 無料:ストレージからのダウンロードに料金はかかりません |
| 書き込み | 100万回あたり$6 |
| 読み取り | 100万回あたり$0.50 |
ストレージ容量は毎日計測され、月平均で計算されます。半月だけ保存したファイルの料金は半分です。暦月の使用量は、プロジェクトの次回のお支払いに1行で加算されます。別途のサブスクリプションはありません。
ファイルの移行
Amazon S3、Google Cloud Storage、他のS3互換ストレージ、サーバー上のフォルダーにあるファイルは、バケットに移行できます。一度にまとめて、またはダウンタイムなしで段階的に移行できます。詳しくはオブジェクトストレージへのファイル移行をご覧ください。
バケットの削除
バケットを削除すると、中のファイルはすべて削除され、復元できません。バケットの変数もプロジェクトから削除されます。バケットを削除できるのは、アカウントオーナーとアプリの管理者です。