تخزين كائنات التطبيق

التوفر

تخزين الكائنات المُدار غير متاح بعد. خدمة الحاوية الحالية معاينة لمستوى التحكم. تنشئ سجلا بشكل حاوية، وتولّد اعتمادات بشكل S3 لمرة واحدة، ويمكنها نشر متغيرات بيئة OF_S3_*، لكن نقطتها هي stub-minio-platform.local:9000. لا تُنشأ حاوية MinIO ولا يمكن تخزين أي كائن هناك.

لا تستخدم سجلا حالته stub للرفع، أو النسخ الاحتياطي، أو أي بيانات يجب أن تبقى. استدعاء ناجح يثبت فقط أن عقد مستوى التحكم جرى.

ما يمكنك اختباره اليوم

تمارس المعاينة هذه الحدود:

توليد اسم حاوية فريد؛
فحوص ملكية التطبيق في غلاف MCP؛
التعامل مع السر لمرة واحدة؛
استجابات إدراج بيانات وصفية فقط؛
نشر OF_S3_ENDPOINT، وOF_S3_BUCKET، وOF_S3_ACCESS_KEY، وOF_S3_SECRET_KEY، وOF_S3_REGION؛ و
ربط مرجع الحاوية بالتطبيق.

إذا نجح نشر البيئة، تبقى القيم نائبة. أزلها قبل نشر حمل يتوقع تخزينا حقيقيا.

أدوات MCP

أداة	السلوك الحالي
`add_app_bucket(app_id)`	ينشئ سجلا `stub` وقد ينشر قيم `OF_S3_*` نائبة.
`list_app_buckets(app_id)`	يدرج بيانات وصفية. لا يعيد المفتاح السري أبدا.


add_app_bucket(app_id='550e8400-e29b-41d4-a716-446655440000')

افحص الاستجابة قبل استخدامها:


{
  "bucket_id": "buk-a7f3b2c1d9e4f",
  "endpoint_url": "http://stub-minio-platform.local:9000",
  "status": "stub",
  "env_published": false
}

عندما يكون نشر البيئة التلقائي غير متاح، يمكن أن تتضمن الاستجابة السر وenv_payload مرة واحدة. ذلك لا يحوّل نقطة stub إلى تخزين. عامل الاستجابة كحساسة ولا تسجّلها.

عقد REST

Method	Path	النتيجة
`POST`	`/api/app-infra/buckets`	ينشئ سجل معاينة ويعيد بيانات بشكل اعتماد لمرة واحدة.
`GET`	`/api/app-infra/buckets/{bucket_id}`	يعيد بيانات وصفية دون المفتاح السري.
`GET`	`/api/app-infra/buckets?app_id={app_id}`	يدرج بيانات الحاوية الوصفية لتطبيق.

فضّل أدوات MCP بنطاق المالك للاستخدام العادي. مسارات المنصة هي سطح التكامل الداخلي.

عقد التطبيق المخطط

عندما يُفعَّل مزود حقيقي، ستبني التطبيقات عميلا متوافقا مع S3 صراحة من المتغيرات الخمسة OF_S3_*. لا تعتمد على اعتمادات AWS المحيطة. يمكن استخدام أسماء المتغيرات نفسها مع خدمة S3 مؤقتة يديرها المشغّل اليوم، بشرط أن تقدّم قيما حقيقية عبر متغيرات بيئة التطبيق.

قبل أن يُسمّى التخزين المُدار جاهزا

إصدار قادر على الإنتاج يحتاج أدلة على:

مضيف مخزن كائنات منشور وقابل للوصول؛
عزل وصول لكل تطبيق؛
اختبارات رفع، وتنزيل، وبقاء بعد إعادة النشر؛
تدوير وإلغاء تجهيز آمن؛
مراقبة السعة، والتوفر، والأخطاء؛ و
سلوك نسخ احتياطي أو تكرار يناسب هدف الديمومة المذكور.

حتى تمر هذه الفحوص، استخدم خدمة متوافقة مع S3 يديرها المشغّل واختبر مسار استعادتها مباشرة.