تخزين الكائنات للملفات والملفات المرفوعة.
تخزين متوافق مع S3 للمشروع: كيف تضيف حاوية (bucket)، ومتغيرات S3_* التي يحصل عليها تطبيقك، وكيف يُسعَّر التخزين والعمليات.
يحفظ تخزين الكائنات الملفات خارج تطبيقك: ملفات المستخدمين المرفوعة، والتقارير المُنشأة، والوسائط، ونسخك الاحتياطية الخاصة. يعمل مع أي مكتبة أو أداة تدعم بروتوكول S3 — حزم AWS SDK، وقرص s3 في Laravel، وdjango-storages، وboto3، وrclone وغيرها الكثير.
إضافة تخزين
من التطبيق: نظرة عامة ← الخدمات ← تخزين الكائنات ← إضافة تخزين. امنح الحاوية اسمًا — أحرف لاتينية صغيرة وأرقام وشرطات، يبدأ بحرف — ثم أكّد. تصبح الحاوية جاهزة خلال لحظات.
يمكن أن يضم المشروع حتى 3 حاويات.
المتغيرات التي يحصل عليها تطبيقك
تُضاف بيانات الوصول إلى متغيرات المشروع تلقائيًا؛ ويلتقطها التطبيق مع نشره التالي:
| المتغير | ما هو |
|---|---|
S3_ENDPOINT | عنوان التخزين |
S3_REGION | المنطقة التي تستخدمها في عميل S3 |
S3_BUCKET | اسم الحاوية |
S3_KEY | مفتاح الوصول |
S3_SECRET | المفتاح السري |
يعمل المفتاح مع هذه الحاوية فقط. وتحصل الحاوية الثانية في المشروع على متغيراتها مسبوقة باسمها: <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 },
})السعر
| السعر | |
|---|---|
| التخزين | 0.025 US$ لكل GB شهريًا |
| حركة المرور | مجانية — التنزيل من التخزين لا يكلّف شيئًا |
| عمليات الكتابة | 6 US$ لكل مليون عملية |
| عمليات القراءة | 0.50 US$ لكل مليون عملية |
يُقاس التخزين كل يوم ويُحسب متوسطه على مدى الشهر، فالملف المحفوظ نصف شهر يكلّف النصف. ويُضاف استخدام الشهر الميلادي إلى الدفعة التالية للمشروع كبند واحد؛ ولا يوجد اشتراك منفصل.
نقل الملفات إليه
يمكن نقل الملفات الموجودة في Amazon S3 أو Google Cloud Storage أو تخزين آخر متوافق مع S3 أو مجلد على خادمك إلى حاوية — دفعة واحدة، أو تدريجيًا دون توقف. راجع نقل الملفات إلى تخزين الكائنات.
حذف حاوية
حذف الحاوية يزيل كل الملفات الموجودة فيها؛ ولا يمكن استعادتها، وتُزال متغيراتها من المشروع. حذف الحاوية متاح لمالك الحساب ولمسؤولي التطبيق.